加密-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 环境变量中。该变量可以包含以逗号分隔的所有历史加密密钥列表：

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) {
    // ...
}