加密
简介
Laravel 的加密服务通过 OpenSSL 提供了一个简单、便捷的接口,用于使用 AES-256 和 AES-128 加密方式对文本进行加密和解密。Laravel 的所有加密值都使用消息认证码(MAC)进行签名,以确保其底层值在加密后无法被修改或篡改。
配置
在使用 Laravel 的加密器之前,您必须在 config/app.php 配置文件中设置 key 配置选项。此配置值由 APP_KEY 环境变量驱动。您应该使用 php artisan key:generate 命令来生成该变量的值,因为 key:generate 命令将使用 PHP 的安全随机字节生成器为您构建一个加密安全的应用程序密钥。通常,APP_KEY 环境变量的值会在 Laravel 安装过程中自动为您生成。
平滑轮转加密密钥
如果您更改了应用程序的加密密钥,所有已认证的用户会话都将被注销。这是因为每个 cookie(包括会话 cookie)都是由 Laravel 加密的。此外,任何使用之前加密密钥加密的数据也将无法解密。
为了缓解这个问题,Laravel 允许您在应用程序的 APP_PREVIOUS_KEYS 环境变量中列出您之前的加密密钥。该变量可以包含一个由逗号分隔的所有先前加密密钥的列表。
1APP_KEY="base64:J63qRTDLub5NuZvP+kb8YIorGS6qFYHKVo6u7179stY="2APP_PREVIOUS_KEYS="base64:2nLsGFGzyoae2ax3EF2Lyq/hH6QghBGLIq5uL+Gp8/w="
当您设置此环境变量时,Laravel 在加密值时将始终使用“当前”加密密钥。然而,在解密值时,Laravel 会首先尝试当前密钥;如果使用当前密钥解密失败,Laravel 将尝试所有之前的密钥,直到其中一个密钥能够成功解密该值。
这种平滑解密的方法允许用户在您的加密密钥轮转时,依然可以不间断地继续使用您的应用程序。
使用加密器
加密值
您可以使用 Crypt 门面提供的 encryptString 方法来加密值。所有加密值都使用 OpenSSL 和 AES-256-CBC 加密算法进行加密。此外,所有加密值都使用消息认证码(MAC)进行签名。集成消息认证码将防止解密任何被恶意用户篡改过的值。
1<?php 2 3namespace App\Http\Controllers; 4 5use Illuminate\Http\RedirectResponse; 6use Illuminate\Http\Request; 7use Illuminate\Support\Facades\Crypt; 8 9class DigitalOceanTokenController extends Controller10{11 /**12 * Store a DigitalOcean API token for the user.13 */14 public function store(Request $request): RedirectResponse15 {16 $request->user()->fill([17 'token' => Crypt::encryptString($request->token),18 ])->save();19 20 return redirect('/secrets');21 }22}
解密值
您可以使用 Crypt 门面提供的 decryptString 方法来解密值。如果值无法正确解密(例如消息认证码无效时),将会抛出 Illuminate\Contracts\Encryption\DecryptException 异常。
1use Illuminate\Contracts\Encryption\DecryptException;2use Illuminate\Support\Facades\Crypt;3 4try {5 $decrypted = Crypt::decryptString($encryptedValue);6} catch (DecryptException $e) {7 // ...8}