Laravel 中文文档

主题

全部文档

加密 ​

简介 ​

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 环境变量中列出先前的加密密钥。该变量可以是以逗号分隔的既往加密密钥列表：

ini
APP_KEY="base64:J63qRTDLub5NuZvP+kb8YIorGS6qFYHKVo6u7179stY="
APP_PREVIOUS_KEYS="base64:2nLsGFGzyoae2ax3EF2Lyq/hH6QghBGLIq5uL+Gp8/w="

设置该环境变量后，Laravel 在加密时会始终使用「当前」加密密钥。但在解密时，Laravel 会先尝试当前密钥；若用当前密钥解密失败，则会依次尝试所有先前密钥，直到某个密钥能成功解密该值为止。

这种平滑解密方式可让用户在加密密钥轮换后仍能不中断地使用应用。

使用加密器 ​

加密值 ​

你可以使用 Crypt facade 提供的 encryptString 方法加密值。所有加密值都使用 OpenSSL 与 AES-256-CBC 密码算法加密，并会用消息认证码（MAC）签名。集成的消息认证码可防止解密被恶意用户篡改过的值：

php
<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Crypt;

class DigitalOceanTokenController extends Controller
{
    /**
     * Store a DigitalOcean API token for the user.
     */
    public function store(Request $request): RedirectResponse
    {
        $request->user()->fill([
            'token' => Crypt::encryptString($request->token),
        ])->save();

        return redirect('/secrets');
    }
}

解密值 ​

你可以使用 Crypt facade 提供的 decryptString 方法解密值。若值无法正确解密（例如消息认证码无效），将抛出 Illuminate\Contracts\Encryption\DecryptException：

php
use Illuminate\Contracts\Encryption\DecryptException;
use Illuminate\Support\Facades\Crypt;

try {
    $decrypted = Crypt::decryptString($encryptedValue);
} catch (DecryptException $e) {
    // ...
}