codeigniter 4 中使用 firebase/php-jwt 生成 jwt 时，`jwt::encode()` 方法必须传入三个参数：载荷（payload）、密钥（key）和签名算法（如 'hs256'），缺一不可。

在 CodeIgniter 4 项目中集成 JWT（例如通过 firebase/php-jwt 库）时，常见错误之一是调用 JWT::encode() 时仅传入两个参数，导致 PHP 报错：Expected 3 arguments. Found 2。这是因为该方法自 v6.0 起已强制要求第三个参数——签名算法（signing algorithm），不再支持默认值或自动推断。

✅ 正确用法如下：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

use Firebase\JWT\JWT;

$key = getenv('TOKEN_SECRET') ?: 'your-secret-key';
$payload = [
    'iat' => time(),           // 签发时间（建议用 time() 动态生成）
    'nbf' => time() + 10,      // 生效时间（10秒后生效，可选）
    'uid' => $user['id'],
    'email' => $user['email']
];

// ✅ 必须指定算法，HS256 是最常用、推荐的对称加密算法
$token = JWT::encode($payload, $key, 'HS256');

⚠️ 注意事项：

• 算法必须显式声明：'HS256'、'HS384'、'HS512'（HMAC-SHA 系列）或 'RS256'（RSA 非对称）等；不支持空字符串或省略。
• 密钥安全性：确保 TOKEN_SECRET 在 .env 中安全配置，且长度足够（HS256 建议 ≥32 字符随机字符串）。
• 版本兼容性：确认安装的是 firebase/php-jwt:^6.0 或更高版本（v5.x 允许两参数，但已弃用且存在安全隐患）。
• 错误处理建议：生产环境应包裹 try-catch，捕获 DomainException、InvalidArgumentException 等异常：

try {
    $token = JWT::encode($payload, $key, 'HS256');
} catch (\Exception $e) {
    log_message('error', 'JWT encode failed: ' . $e->getMessage());
    throw new \RuntimeException('Token generation failed.');
}

? 总结：JWT 签名是安全核心环节，算法参数不可省略。始终显式指定强算法（首选 'HS256'），并配合安全密钥与健全的异常处理，才能构建健壮的 API 认证体系。