[ Laravel 5.3 文档 ] 安全 —— 加密

1、简介

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

2、配置

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

3、使用加密器

加密

你可以使用辅助函数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
{
    /**
     * Store a secret message for the user.
     *
     * @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

解密

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

use Illuminate\Contracts\Encryption\DecryptException;

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

学院君

学院君 has written 548 articles

资深PHP工程师,Laravel学院院长