Yii 1.1.14 и хеширование паролей в PHP: от CPasswordHelper к Yii 2
В Yii 1.1.14 появился CPasswordHelper для хеширования паролей и компонент кеша с поддержкой Redis. Если приложение до сих пор хранит хеши, созданные этим помощником, их можно переносить на современный код постепенно, по мере входа пользователей. Разберём этот переход для PHP 8.3–8.5 и настроим Redis для данных, которые можно получить заново.
Что появилось в Yii 1.1.14
В Yii 1.1.14 класс CPasswordHelper дал приложению готовую пару методов: hashPassword() для создания bcrypt-хеша и verifyPassword() для проверки введённого пароля. Соль и параметры bcrypt входили в строку хеша, поэтому в базе было достаточно одного поля. Это упрощало жизнь проектам, где раньше пароль хешировали вручную.
В том же релизе появился CRedisCache, компонент Yii 1.1 для хранения кеша в Redis. Эти изменения решали разные задачи. Хеш пароля относится к учётной записи и хранится в основной базе. Кеш ускоряет чтение данных, которые приложение сможет загрузить или вычислить заново после истечения TTL.
Как хешировать пароли на PHP 8.3–8.5
Для нового кода достаточно password_hash(), password_verify() и password_needs_rehash(). Первый вызов генерирует соль и возвращает строку со всеми параметрами алгоритма. Второй проверяет пароль по этой строке. Третий показывает, совпадает ли сохранённый хеш с текущей политикой приложения. Храните всю строку без обрезки, например в поле VARCHAR(255).
Для нового проекта можно выбрать PASSWORD_ARGON2ID, если Argon2id доступен во всех рабочих сборках PHP. Проверить доступность можно через password_algos(). Согласуйте алгоритм между веб-процессами и CLI до начала миграции. В этих версиях PHP PASSWORD_DEFAULT означает bcrypt, при этом значение константы может измениться в будущих версиях PHP.
<?php
declare(strict_types=1);
function hashNewPassword(string $password): string
{
// Для этого приложения в PHP должен быть доступен Argon2id.
return password_hash($password, PASSWORD_ARGON2ID);
}
function checkPassword(string $password, string $storedHash): bool
{
return password_verify($password, $storedHash);
}Передавайте пароль без trim(), приведения регистра и другой нормализации. Пробелы могут быть частью пароля. На уровне формы или API проверяйте, что получена строка, и задавайте верхнюю границу размера входных данных. При использовании bcrypt учитывайте отдельное ограничение алгоритма: он учитывает максимум 72 байта. Проверяйте длину через strlen(), поскольку символы UTF-8 могут занимать по несколько байт. Для новых паролей на bcrypt явно отклоняйте ввод свыше этого предела.
Как перенести хеши CPasswordHelper без массового сброса
Стандартные bcrypt-хеши из CPasswordHelper проверяются через password_verify(). Сохраните существующие строки целиком и проверьте совместимость на тестовой учётной записи, хеш которой создан старым приложением. Если проект предварительно преобразовывал пароль, например добавлял секрет приложения, учтите это в ветке проверки старого формата.
- Загрузите хеш по идентификатору учётной записи и вызовите
password_verify(). - После успешной проверки вызовите
password_needs_rehash()с целевым алгоритмом и параметрами. - Если требуется обновление, хешируйте введённый пароль и сохраните результат, только если в базе всё ещё лежит ранее прочитанный хеш.
<?php
declare(strict_types=1);
function verifyAndUpgrade(
PDO $db,
int $userId,
string $password,
string $storedHash,
): bool {
if (!password_verify($password, $storedHash)) {
return false;
}
if (!password_needs_rehash($storedHash, PASSWORD_ARGON2ID)) {
return true;
}
// Старый bcrypt мог принять несколько суффиксов после 72-го байта.
// Такой пароль следует сменить через отдельный сценарий.
if (str_starts_with($storedHash, '$2') && strlen($password) > 72) {
return true;
}
$update = $db->prepare(
'UPDATE users SET password_hash = :new_hash
WHERE id = :id AND password_hash = :old_hash'
);
$update->execute([
'new_hash' => password_hash($password, PASSWORD_ARGON2ID),
'id' => $userId,
'old_hash' => $storedHash,
]);
// При параллельной смене пароля предложите повторить вход.
return $update->rowCount() === 1;
}Пример предполагает PDO в режиме исключений и сравнение поля password_hash с учётом регистра. Условие по старому хешу защищает новый пароль от перезаписи при параллельном входе или смене пароля. Проверку длины для старого bcrypt выполняйте отдельно от правил регистрации. Если приложение исторически принимало длинные пароли, отказ при входе может заблокировать пользователей. Успешную проверку такого ввода можно использовать для перехода к смене пароля, а автоматическое перехеширование пропустить.
Пароли в Yii 2 через Yii::$app->security
В Yii 2 компонент Yii::$app->security предоставляет методы generatePasswordHash() и validatePassword(). Этот вариант подходит проектам, где уже используется bcrypt и нужно сохранить совместимость с существующим кодом входа. Стоимость вычисления задаётся свойством компонента passwordHashCost.
<?php
declare(strict_types=1);
function createYiiPasswordHash(string $password): string
{
// bcrypt ограничен 72 байтами входа.
if (strlen($password) > 72) {
throw new InvalidArgumentException('Пароль превышает 72 байта.');
}
return Yii::$app->security->generatePasswordHash($password);
}
function verifyYiiPassword(string $password, string $hash): bool
{
return Yii::$app->security->validatePassword($password, $hash);
}Для обновления стоимости bcrypt сравнивайте хеш с password_needs_rehash($hash, PASSWORD_BCRYPT, ['cost' => Yii::$app->security->passwordHashCost]) после успешной проверки. Если целевой алгоритм в проекте Yii 2 — Argon2id, переведите создание и проверку паролей на нативные функции PHP. Учтите все точки входа, включая регистрацию, смену пароля, сброс и административное создание учётной записи. При поэтапном деплое сначала обновите все процессы, которые читают хеши, и затем включите запись нового формата.
Как настроить Redis-кеш в Yii 2
В Yii 2 Redis-кеш предоставляет расширение yiisoft/yii2-redis. Компонент yii\redis\Cache можно зарегистрировать отдельно от основного кеша приложения. Ниже пример для Redis на локальном интерфейсе и отдельного префикса проекта.
<?php
declare(strict_types=1);
return [
'components' => [
'redisCache' => [
'class' => yii\redis\Cache::class,
'keyPrefix' => 'shop:prod:',
'redis' => [
'class' => yii\redis\Connection::class,
'hostname' => '127.0.0.1',
'port' => 6379,
'database' => 0,
],
],
],
];Например, результат чтения списка активных категорий можно кешировать на пять минут. Ключ включает версию формата, чтобы после изменения структуры данных новый код прочитал свежий результат.
$categories = Yii::$app->redisCache->getOrSet(
['active-categories', 'v1'],
static fn (): array => Yii::$app->db->createCommand(
'SELECT id, name FROM category WHERE active = 1 ORDER BY name'
)->queryAll(),
300, // TTL в секундах.
);Для выборок с фильтрами включайте в ключ параметры, которые влияют на результат: например, язык, регион или идентификатор арендатора. Если обновления должны появляться сразу, удаляйте конкретный ключ после успешной записи в БД. Префикс разделяет ключи приложений при обычном чтении и записи. Для общей Redis-базы избегайте вызова flush(): он может затронуть ключи за пределами префикса.
Что Redis может делать при входе
Redis подходит для краткоживущих счётчиков попыток входа. Храните в ключе идентификатор, по которому ограничиваете попытки, и назначайте TTL. Инкремент и установку срока жизни первого значения выполняйте атомарно, например одним Lua-скриптом, чтобы счётчик получил TTL даже при одновременных запросах. Ограничение по учётной записи можно сочетать с ограничением по IP, учитывая общий адрес пользователей за NAT.
Читайте актуальный хеш при входе из основной базы. Смена и сброс пароля должны применяться сразу, а кеширование хеша добавляет зависимость от корректного удаления старых записей. Результат проверки пароля тоже вычисляйте при каждой попытке. Для обычного кеша заранее определите, как приложение прочитает данные при отказе Redis. Для ограничения попыток отдельно определите поведение при недоступности счётчика.
Чек-лист перехода со старого Yii
- Проверьте формат сохранённых хешей и размер поля в БД. На тестовой записи пройдите регистрацию в старом коде и вход в новом.
- Выберите алгоритм и его параметры для всех рабочих процессов. Для bcrypt установите лимит в 72 байта на создание и смену пароля.
- Проверяйте старый хеш при входе и обновляйте его только после подтверждения пароля. При записи сравнивайте прежний хеш, чтобы учесть параллельную смену пароля.
- Проверьте регистрацию, вход и сброс пароля после развёртывания. Если включаете Argon2id, каждый обработчик входа должен принять хеш, созданный любым обработчиком смены пароля.
- Переносите в Redis данные с понятным TTL и способом обновления. Проверьте, что удаление ключа возвращает приложение к чтению из основной базы.
Частые вопросы
Можно ли проверить хеш из Yii 1.1.14 через password_verify()?
Да. Стандартный bcrypt-хеш CPasswordHelper совместим с password_verify(). Если старое приложение преобразовывало пароль перед хешированием, для проверки старой записи нужно повторить это преобразование.
Как сменить bcrypt на Argon2id без сброса паролей?
Проверяйте текущий хеш через password_verify(). После успешного входа используйте password_needs_rehash(), чтобы определить необходимость обновления. Новый хеш создавайте из введённого пароля и записывайте при условии, что старый хеш ещё действует.
Что можно хранить в Redis рядом с системой входа?
В Redis удобно хранить счётчики попыток входа с TTL и обычный кеш для данных, которые можно восстановить. Актуальный хеш пароля храните в основной базе учётных записей.