加密

Laravel 中文文档 / 安全相关

加密

简介

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 的 encryptStringdecryptString 方法:

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) {
    //
}
  上一篇 下一篇  

作者:ilaoniu

牛哥,俗称哞哞。单纯的九零后理工小青年。喜欢折腾,爱玩,爱安卓,爱音乐,爱游戏,爱电影,爱旅游...