跳转至内容

哈希

简介

Laravel 的 Hash 门面(facade) 为存储用户密码提供了安全的 Bcrypt 和 Argon2 哈希算法。如果您正在使用 Laravel 应用入门套件,默认情况下,注册和身份验证将使用 Bcrypt。

Bcrypt 是哈希密码的绝佳选择,因为它的“工作因子(work factor)”是可调的,这意味着生成哈希所需的时间可以随着硬件性能的提升而增加。在处理密码哈希时,慢即是好。算法执行哈希所需的时间越长,恶意用户生成可用于暴力破解攻击的“彩虹表”(所有可能的字符串哈希值集合)所需的时间就越长。

配置

默认情况下,Laravel 在哈希数据时使用 bcrypt 哈希驱动。不过,它也支持其他几种哈希驱动,包括 argonargon2id

你可以通过 HASH_DRIVER 环境变量指定应用程序的哈希驱动。但是,如果你想自定义 Laravel 哈希驱动的所有选项,你应该使用 config:publish Artisan 命令发布完整的 hashing 配置文件。

1php artisan config:publish hashing

基本用法

哈希密码

你可以通过调用 Hash 门面的 make 方法来加密密码:

1<?php
2 
3namespace App\Http\Controllers;
4 
5use Illuminate\Http\RedirectResponse;
6use Illuminate\Http\Request;
7use Illuminate\Support\Facades\Hash;
8 
9class PasswordController extends Controller
10{
11 /**
12 * Update the password for the user.
13 */
14 public function update(Request $request): RedirectResponse
15 {
16 // Validate the new password length...
17 
18 $request->user()->fill([
19 'password' => Hash::make($request->newPassword)
20 ])->save();
21 
22 return redirect('/profile');
23 }
24}

调整 Bcrypt 工作因子

如果你使用的是 Bcrypt 算法,make 方法允许你通过 rounds 选项管理算法的工作因子;不过,Laravel 默认管理的工作因子对大多数应用程序来说已经足够了。

1$hashed = Hash::make('password', [
2 'rounds' => 12,
3]);

调整 Argon2 工作因子

如果你使用的是 Argon2 算法,make 方法允许你通过 memorytimethreads 选项来管理算法的工作因子;不过,Laravel 默认管理的值对大多数应用程序来说已经足够了。

1$hashed = Hash::make('password', [
2 'memory' => 1024,
3 'time' => 2,
4 'threads' => 2,
5]);

有关这些选项的更多信息,请参阅 PHP 官方关于 Argon 哈希的文档

验证密码与哈希值是否匹配

Hash 门面提供的 check 方法允许你验证给定的纯文本字符串是否与给定的哈希值匹配。

1if (Hash::check('plain-text', $hashedPassword)) {
2 // The passwords match...
3}

判断密码是否需要重新哈希

Hash 门面提供的 needsRehash 方法允许你判断自密码被哈希以来,哈希器所使用的工作因子是否发生了变化。一些应用程序会选择在身份验证过程中执行此检查。

1if (Hash::needsRehash($hashed)) {
2 $hashed = Hash::make('plain-text');
3}

哈希算法验证

为了防止哈希算法被篡改,Laravel 的 Hash::check 方法会首先验证给定的哈希值是否是使用应用程序当前选定的哈希算法生成的。如果算法不一致,将抛出 RuntimeException 异常。

对于大多数应用程序,这是预期行为,因为哈希算法通常不会变更,而算法不同往往预示着恶意攻击。然而,如果你的应用程序需要支持多种哈希算法(例如在从一种算法迁移到另一种算法时),你可以通过将 HASH_VERIFY 环境变量设置为 false 来禁用哈希算法验证。

1HASH_VERIFY=false