如何判断PHP的password_hash函数是否支持thread参数？

核心检测逻辑 #

thread（官方规范命名为threads，复数）参数仅对Argon2系列散列算法生效，且仅当PHP使用libargon2实现时支持，你可以通过以下两种方式在运行时检测：

方案1：内置常量检测（推荐，性能无开销） #

PHP 7.4及以上版本提供了PASSWORD_ARGON2_PROVIDER常量直接标记Argon2的实现方，直接判断即可：

function isPasswordThreadsSupported(): bool
{
    // 不存在该常量说明环境无可用的Argon2实现，或PHP版本过低
    if (!defined('PASSWORD_ARGON2_PROVIDER')) {
        return false;
    }
    return PASSWORD_ARGON2_PROVIDER === 'libargon2';
}

返回true时可安全传入threads参数，返回false时需从选项中移除该参数避免报错。

方案2：容错探测（兼容特殊编译/低版本环境） #

如果你的类库需要兼容版本低于7.4，或者存在自定义编译的PHP环境，可以通过静默探测的方式判断，不会对外抛出错误：

function isPasswordThreadsSupported(): bool
{
    // 先判断环境是否支持Argon2算法，否则参数无意义
    if (!in_array('argon2i', password_algos(), true)) {
        return false;
    }
    
    // 临时屏蔽错误，探测参数是否可用
    $originErrorLevel = error_reporting(0);
    $testResult = @password_hash('test', PASSWORD_ARGON2I, [
        'memory_cost' => 1024,
        'time_cost' => 1,
        'threads' => 1
    ]);
    error_reporting($originErrorLevel);
    
    return $testResult !== false;
}

类库开发适配建议 #

• 优先使用方案1，仅在有明确兼容需求时使用方案2
• 检测到参数不可用时，直接从传入的选项数组中移除threads项即可，无需额外降级处理，libargon2和libsodium的其他参数规则一致
• 不要通过PHP版本号判断兼容性，部分Linux发行版会向低版本PHP向后移植算法实现，版本判断可靠性远低于运行时检测

内容的提问来源于stack exchange，提问作者Danack