Как правильно использовать bcrypt для хеширования паролей в PHP?

Подробное руководство по bcrypt в PHP

Вы на правильном пути! Использование password_hash() и password_verify() — это современный и безопасный подход. Давайте разберём все ваши вопросы по порядку.

1. PASSWORD_DEFAULT vs PASSWORD_BCRYPT

На текущий момент PASSWORD_DEFAULT использует именно bcrypt (с PHP 5.5.0). Однако в будущих версиях PHP алгоритм может измениться на более мощный. Если вы хотите быть уверены, что используете bcrypt всегда, указывайте PASSWORD_BCRYPT явно:

$hash = password_hash($password, PASSWORD_BCRYPT);

2. Настройка "стоимости" (cost factor)

Cost factor определяет, сколько времени будет потрачено на вычисление хеша. Чем выше значение, тем сложнее взломать хеш методом перебора. Значение по умолчанию — 10. Для современных серверов рекомендуется 12-14. Настраивается через третий параметр — массив опций:

$options = [
    'cost' => 12
];
$hash = password_hash($password, PASSWORD_BCRYPT, $options);

Важно: Слишком высокий cost (например, 16+) может создать нагрузку на сервер. Оптимальное значение — то, при котором хеширование занимает 0.1-0.5 секунды. Протестируйте на своём сервере:

$time_start = microtime(true);
password_hash('test', PASSWORD_BCRYPT, ['cost' => 12]);
$time_end = microtime(true);
echo "Время: " . ($time_end - $time_start) . " сек";

3. Соль (salt) — автоматически

PHP автоматически генерирует криптографически безопасную случайную соль для каждого хеша. Вам не нужно добавлять её вручную. Соль хранится внутри самого хеша, поэтому password_verify() может её извлечь и использовать для проверки. Никогда не пытайтесь задать свою соль — это снизит безопасность.

4. Обновление хешей при смене алгоритма

PHP предоставляет функцию password_needs_rehash(), которая проверяет, соответствует ли хеш текущим настройкам. Это полезно, когда вы повышаете cost или меняете алгоритм. Реализуйте проверку при авторизации:

if (password_verify($password, $hash)) {
    if (password_needs_rehash($hash, PASSWORD_BCRYPT, ['cost' => 12])) {
        $newHash = password_hash($password, PASSWORD_BCRYPT, ['cost' => 12]);
        // Обновите хеш в базе данных
    }
    // Продолжайте авторизацию
}

5. Подводные камни и best practices

• Длина пароля: bcrypt ограничен 72 символами. Более длинные пароли будут обрезаться. Если нужны пароли длиннее, сначала пропустите их через обычный хеш (например, SHA256), а затем через bcrypt. Но для большинства случаев 72 символов достаточно.
• Кодировка: bcrypt работает с байтами, поэтому убедитесь, что используете одинаковую кодировку (UTF-8) при регистрации и авторизации.
• Никогда не выводите хеш пользователю: Хеш — это внутренняя информация. Не показывайте его в логах, ошибках или на экране.
• Используйте HTTPS: Хеширование защищает пароль в базе данных, но не при передаче. Всегда используйте HTTPS для защиты данных в пути.
• Не используйте устаревшие функции: Избегайте md5(), sha1(), crypt() без bcrypt, а также собственных алгоритмов хеширования.

Полный пример класса для работы с паролями

<?php
class PasswordManager {
    private $algo = PASSWORD_BCRYPT;
    private $options = ['cost' => 12];

    public function hash($password) {
        return password_hash($password, $this->algo, $this->options);
    }

    public function verify($password, $hash) {
        return password_verify($password, $hash);
    }

    public function needsRehash($hash) {
        return password_needs_rehash($hash, $this->algo, $this->options);
    }
}

// Использование
$pm = new PasswordManager();
$hash = $pm->hash('user_password');
// Сохраните $hash в БД

// При авторизации
if ($pm->verify($input_password, $stored_hash)) {
    if ($pm->needsRehash($stored_hash)) {
        $newHash = $pm->hash($input_password);
        // Обновите запись в БД
    }
    echo "Добро пожаловать!";
}
?>

Этот подход гарантирует, что ваши пароли будут в безопасности, а система сможет адаптироваться к будущим улучшениям алгоритмов хеширования.

composer require ircmaxell/password-compat

<?php
require_once 'vendor/autoload.php';

// Хеширование
$hash = password_hash('mypassword', PASSWORD_BCRYPT, ['cost' => 10]);

// Проверка
if (password_verify('mypassword', $hash)) {
    echo 'Пароль верен!';
}
?>