[ Laravel 5.7 文档 ] 安全系列 —— 加密

简介

Laravel 的加密器使用 OpenSSL 来提供 AES-256 和 AES-128 加密。强烈建议使用 Laravel 自带的加密设置，不要尝试推出自己“土生土长”的加密算法。所有 Laravel 加密过的值都使用消息授权码（MAC）进行签名以便底层值一经加密就不能修改。

配置

在使用 Laravel 的加密器之前，必须在配置文件 config/app.php 中设置 key 选项为 32 位随机字符串。可以使用 php artisan key:generate 命令来生成这个key，该 Artisan 命令会使用 PHP 的安全随机字节生成器来构建 key 的值。如果这个值没有被设置，所有 Laravel 加密过的值都是不安全的。

使用加密器

加密

你可以使用辅助函数 encrypt 对数据进行加密，所有加密值都使用 OpenSSL 和 AES-256-CBC 密码（cipher）进行加密。此外，所有加密值都通过一个消息认证码（MAC）来进行签名以防止对加密字符串的任何修改。

<?php

namespace App\Http\Controllers;

use App\User;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * 存储用户安全信息.
     *
     * @param  Request  $request
     * @param  int  $id
     * @return Response
     */
    public function storeSecret(Request $request, $id)
    {
        $user = User::findOrFail($id);

        $user->fill([
            'secret' => encrypt($request->secret)
        ])->save();
    }
}

不进行序列化的加密

加密值在加密期间都会经过序列化函数 serialize 进行处理，从而允许对对象和数组的加密。因此，非 PHP 客户端接收的加密数据需要进行 unserialize 反序列化。如果你想要在加密和解密数据时不进行序列化操作，可以使用 Crypt 门面提供的 encryptString 和 decryptString 方法：

use Illuminate\Support\Facades\Crypt;

$encrypted = Crypt::encryptString('Hello world.');

$decrypted = Crypt::decryptString($encrypted);

解密

你可以使用辅助函数 decrypt 对加密数据进行解密。如果该值不能被解密，例如 MAC 无效，将会抛出一个 Illuminate\Contracts\Encryption\DecryptException 异常：

use Illuminate\Contracts\Encryption\DecryptException;

try {
    $decrypted = decrypt($encryptedValue);
} catch (DecryptException $e) {
    //
}

示例

我们在 routes/web.php 定义一个路由进行简单测试：

Route::get('/test/crypt', function (){
    $raw_str = encrypt('Laravel学院');
    $decrypted_str = decrypt($raw_str);
    dd(['after_encryt' => $raw_str, 'after_decrypt' => $decrypted_str]);
});

在浏览器中访问 http://blog.test/test/crypt 页面输出如下：