如何通过Composer安装 PHP-Safe-Password 库实现符合安全标准的密码哈希

PHP没有php-safe-password包，因其并不存在于Packagist；安全密码哈希应直接使用PHP原生password_hash()和password_verify()函数，默认bcrypt（PHP 5.5+）或Argon2ID（PHP 7.2+需启用扩展）。

你可能会在搜索引擎里见过“php-safe-password”这个名称，甚至有人误以为它是一个现成的Composer包。可现实是——它根本不存在于Packagist，也没有官方维护版本。直接跑 composer require php-safe-password，只会收到一句冷冰冰的报错：Package php-safe-password not found。

为什么搜不到 php-safe-password？

这个误会其实很常见：很多开发者把“安全密码哈希”当成某个具体库的名字，而事实上，PHP自身早已把这项工作做得足够好了。所谓“安全密码哈希”，核心就是两个原生函数：password_hash() 和 password_verify()。它们默认采用bcrypt（PHP 5.5+），同时还支持argon2（PHP 7.2+，不过需要编译时开启libsodium或argon2扩展）。

• Packagist上从来没有一个叫php-safe-password的标准包，也没有任何社区认可的稳定版本
• 偶尔有第三方库用类似的命名，但要么是玩具项目，要么早已停止维护——生产环境绝对不推荐
• 真正需要做的不是“装一个名字里带safe的包”，而是把PHP原生密码API用对、用熟

替代方案：用原生 password_hash() 实现合规哈希

如果仔细看看OWASP和NIST对密码存储的要求，你会发现password_hash()几乎都满足：自动生成盐、可调迭代次数、抗时序攻击。更棒的是，它不需要任何第三方依赖。

• 默认算法PASSWORD_BCRYPT，兼容性好，强度足够应付绝大多数场景
• 如果环境支持，可以用PASSWORD_ARGON2ID（前提是ext-argon2已启用），防护等级更高
• 哈希结果是完整字符串（包含算法标识、成本因子、盐和密文），直接存数据库即可，连“单独存盐”都省了
• 验证时只用password_verify($input, $hash)，函数自动解析参数，完全不用操心内部结构

// 正确示例：生成与验证
$hash = password_hash('myPass123!', PASSWORD_ARGON2ID, ['memory_cost' => 65536, 'time_cost' => 4, 'threads' => 3]);
if (password_verify('myPass123!', $hash)) {
    echo 'Valid';
}

如果坚持要“第三方封装”，该注意什么？

少数项目确实会做一层薄薄的封装——比如加类型约束、统一异常处理、适配老旧PHP版本。但如果你真要使用这类包，必须严加审查：

• 检查源码是否只是对password_hash()/password_verify()的简单包装，而不是自己从头写哈希逻辑
• 确认没有把成本因子写死（比如bcrypt cost=10），应该允许运行时配置
• 避免依赖过时扩展（如mcrypt）或弃用函数（如sha1() + 自己拼盐）
• 如果发现某个包要求你composer require safe/password之类的，大概率是个人练手项目，别放到生产环境

真正容易被忽视的反而是这些细节：很多人花时间满世界找“安全密码库”，却忘了检查PHP版本是否≥7.2（否则PASSWORD_ARGON2ID不可用），或者根本没在部署时确认extension=argon2.so是否加载。哈希安全从来不是因为包名里带个“safe”，而是取决于你是否用对了原生函数、是否更新了运行时环境。这一点，值得反复提。