加密

简介

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（包括 session cookie）都是由 Laravel 加密的。另外，用旧密钥加密的数据也再也解不开了。

为了缓解这个问题，Laravel 允许你把之前的加密密钥列在应用的 APP_PREVIOUS_KEYS 环境变量里。这个变量可以包含一个用逗号分隔的旧加密密钥列表：

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

设置了这个环境变量后，Laravel 加密数据时始终使用「当前」加密密钥。但在解密时，Laravel 会先尝试当前密钥，如果用当前密钥解密失败，Laravel 会依次尝试所有旧密钥，直到有一个密钥能成功解密。

这种平滑解密的方式让你在轮换密钥时用户还能继续无感使用应用。

使用加密器

加密一个值

你可以用 Crypt 门面提供的 encryptString() 方法来加密一个值。所有加密值都通过 OpenSSL 和 AES-256-CBC 算法加密，并且都会用消息认证码（MAC）签名。集成的消息认证码会阻止解密任何被恶意用户篡改过的值：

<?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 门面提供的 decryptString() 方法来解密一个值。如果值不能被正确解密（例如消息认证码无效），会抛出一个 Illuminate\Contracts\Encryption\DecryptException 异常：

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

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