README

此 Symfony 扩展包为 LexikJWTAuthenticationBundle 提供了 JWT 编码器，该 Bundle 使用 web-token/jwt-framework 作为 JWT 创建器/加载器。

发布流程

发布流程在此描述。

先决条件

此库至少需要

Symfony 4.3+。

持续集成

已成功使用 PHP 7.2 和 PHP 7.3 进行测试。

我们还使用 Scrutinizer-CI 和 Sensio Insight 跟踪错误和代码质量。

编码标准通过 StyleCI 验证。

未执行代码覆盖率，但使用 行为驱动开发 (BDD) 测试此 Bundle。

安装

Symfony Flex

安装此 Bundle 的首选方法是依靠 Symfony Flex

composer req "spomky-labs/lexik-jose-bridge:^3.0"

手动安装

如果您不使用 Symfony Flex，则使用 Composer 手动安装该 Bundle。

composer require spomky-labs/lexik-jose-bridge

然后，将此 Bundle 和 web-token/jwt-framework Bundle 添加到您的内核中

<?php

use Symfony\Component\Config\Loader\LoaderInterface;
use Symfony\Component\HttpKernel\Kernel;

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            ...
            new Jose\Bundle\JoseFramework\JoseFrameworkBundle(),
            new SpomkyLabs\LexikJoseBundle\SpomkyLabsLexikJoseBundle(),
        ];

        return $bundles;
    }
}

签名/加密算法

此 Bundle 只安装基于 RSA 的签名算法（RS256、RS384 和 RS512）。如果您需要其他签名算法（例如基于 EC 的，HMAC）或想使用加密功能，则必须安装相应的包

签名算法
- 全部：composer require web-token/signature-pack
- HMAC：composer require web-token/jwt-signature-algorithm-hmac
- ECDSA：composer require web-token/jwt-signature-algorithm-ecdsa
- EdDSA：composer require web-token/jwt-signature-algorithm-eddsa
- 无：composer require web-token/jwt-signature-algorithm-none（不推荐）
- 实验性：composer require web-token/jwt-signature-algorithm-experimental（不推荐）
加密算法
- 全部：composer require web-token/encryption-pack
- 密钥加密
  - ECDH-ES：composer require web-token/jwt-encryption-algorithm-ecdh-es
  - AES 密钥包装：composer require web-token/jwt-encryption-algorithm-aeskw
  - RSA：composer require web-token/jwt-encryption-algorithm-rsa
  - AES GCM 密钥包装：composer require web-token/jwt-encryption-algorithm-aesgcmkw
  - 直接：composer require web-token/jwt-encryption-algorithm-dir（不推荐）
  - PBES 2：composer require web-token/jwt-encryption-algorithm-pbes2（不推荐）
- 内容加密
  - AES GCM：composer require web-token/jwt-encryption-algorithm-aesgcm
  - AES CBC：composer require web-token/jwt-encryption-algorithm-aescbc
- 实验性：composer require web-token/jwt-encryption-algorithm-experimental（不推荐）