加密

• 简介
• 配置
• 使用

简介

Laravel 的加密器使用 OpenSSL 提供的 AES-256 和 AES-128 加密。强烈建议您使用 Laravel 内置的加密工具，而不要尝试使用自己「本土」加密算法。所有 Laravel 加密的值都使用消息认证码（MAC）进行签名，因此加密后数据无法被修改。

配置

在使用 Laravel 的加密器之前，必须在 config/app.php 配置文件中设置 key 配置项。应该使用 php artisan key:generate 命令来生成密钥，因为该 Artisan 命令会使用 PHP 的安全随机字节生成器来创建此密钥。如果未正确设置此值，则 Laravel 加密的所有值都将不安全。

使用

加密一个值

可以使用 encrypt 辅助函数来加密一个值。所有加密值都使用 OpenSSL 和 AES-256-CBC 密码进行加密。此外，所有加密值都使用消息认证码（MAC）进行签名，来检测加密字符串是否有任何修改：

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