phpEnv 默认启用 hash 扩展但需确认 PHP ≥ 5.1.2 且未被禁用；验证方法包括 php -m | grep hash、phpinfo() 查看 enabled 状态及 hash_algos() 返回结果；启用步骤为编辑对应版本 php.ini 取消 extension=hash 注释或新增该行并重启服务；注意 hash 仅提供单向摘要，不可用于密码存储（应使用 password_hash()）或加解密（需 openssl 扩展）。
phpEnv 默认已启用 hash 扩展，无需手动开启 —— 但必须确认 PHP 版本 ≥ 5.1.2，且未被禁用（如通过 disable_functions 或 extension= 注释掉）。
如何验证 hash 扩展是否真正可用
很多人以为装了 phpEnv 就“自动支持”，结果调用 hash_algos() 报错或返回空数组。根本原因是：phpEnv 的不同 PHP 版本包可能默认关闭部分扩展，或用户修改过 php.ini。
- 运行
php -m | grep hash（命令行），若无输出，说明扩展未加载 - 检查
phpinfo()页面中 “hash” 模块是否显示为 “enabled”，注意看 “Registered hash functions” 下是否有算法列表（如sha256、whirlpool） - 直接执行
var_dump(hash_algos());，若返回bool(false)或空数组，大概率是extension=hash被注释或写错路径
phpEnv 中启用 hash 扩展的实操步骤
phpEnv 的配置文件位于 phpenv\php\{version}\conf\php.ini，不是系统级全局 ini。改错位置等于白改。
- 用记事本或 VS Code 打开对应 PHP 版本的
php.ini - 搜索
;extension=hash，去掉前面的分号（;），确保为extension=hash - 如果该行不存在，就在
[Dynamic Extensions]段落末尾新增一行extension=hash - 保存后，**必须重启 phpEnv 的 Web 服务（如 Apache/Nginx）或 CLI 进程**，否则修改不生效
hash 扩展 ≠ 数据加密，别混淆用途
这是最容易踩坑的地方：hash 扩展只提供摘要（digest），不是加密（encryption）。它不能“还原”，也不带密钥保护 —— 除非你主动组合使用 hash_hmac()。
立即学习“PHP免费学习笔记（深入）”；
-
hash('sha256', $data)是纯摘要，适合校验文件完整性，但**绝不能用于密码存储** -
hash_hmac('sha256', $data, $key)带密钥，可防篡改，但仍是单向，无法解密 - 需要加解密（比如存手机号后还能读出来），必须用
openssl_encrypt()+openssl_decrypt()，且依赖openssl扩展已启用 - 密码哈希请无条件用
password_hash()，它底层调用的是 bcrypt/Argon2，和hash扩展无关
常见报错与绕过陷阱
即使 hash 扩展开着，也常因参数或环境出错：
-
hash(): Unknown hashing algorithm→ 传入了不支持的算法名，比如'blake3'（PHP 8.2+ 才原生支持），先用hash_algos()看实际可用列表 -
hash_hmac(): Unknown cipher algorithm→ 把hash_hmac()的第三个参数（key）误当成了算法名，注意顺序：hash_hmac($algo, $data, $key) - Windows 下 phpEnv 调用
hash_pbkdf2()失败 → 某些旧版 phpEnv 的 OpenSSL 库缺失 PBKDF2 支持，升级到 PHP 7.4+ 或改用password_hash() - 用
hash_init('md5')后忘记hash_final()→ 增量哈希必须配对调用，否则返回空或警告
真正麻烦的从来不是“怎么开扩展”，而是搞清你要解决的问题属于哪一层：摘要？消息认证？密码存储？还是双向加解密？选错函数名、传错参数类型、混用算法强度，比扩展没开更难排查。
