composer require失败常见原因是php版本或扩展缺失，如hash扩展未启用、php 8.4与v1.x不兼容、包名拼错或算法参数不满足硬性条件。
直接用 composer require lastguest/murmurhash 就能装上，但装完不能直接当普通函数用——它不提供全局函数，得靠类调用或适配 PHP 8.1+ 的 hash_init() 接口。
安装时为什么 composer require 会失败
常见原因是 PHP 版本或扩展缺失。这个库最低要求 PHP 7.2，但如果你用的是 PHP 8.4，lastguest/murmurhash 的原始版本（v1.x）没适配新版本的 hash_*() 系统行为，会导致 hash_init('murmur3a') 报错。
- 确认已启用
hash扩展：运行php -m | grep hash，没输出就需在php.ini中取消注释extension=hash - PHP 8.1+ 用户注意：
lastguest/murmurhashv1.0.0 不支持options参数传['seed' => 0]，会触发E_DEPRECATED；升级到 v1.1.0 或更高才修复 - 若 Composer 报 “package not found”，检查是否拼错包名：
lastguest/murmurhash（不是murmurhash-php或php-murmurhash）
hash_init('murmur3a') 调用失败的三个典型原因
PHP 原生 hash_init() 在 8.1+ 支持 MurmurHash3，但必须满足三个硬性条件，缺一不可。
- 算法名必须是
'murmur3a'、'murmur3f'或'murmur3c'（大小写敏感），'murmurhash3'或'murmur'都无效 -
flags不能设为HASH_HMAC—— MurmurHash 是非加密哈希，PHP 明确禁止对它做 HMAC -
options数组里只认'seed'键，且值必须是整数；传字符串'seed' => '123'会触发E_DEPRECATED，未来版本将直接抛ValueError
正确示例：
php
$ctx = hash_init('murmur3a', 0, [], ['seed' => 0x9747b28c]);
hash_update($ctx, 'hello world');
echo hash_final($ctx); // 输出 32 位十六进制字符串
用 lastguest/murmurhash 类时 seed 和输出长度怎么选
这个库封装了 MurmurHash3 的三种变体，但默认行为和原生 hash_*() 不一致，尤其要注意 seed 和返回值类型。
- 构造时传
0作为 seed（如new MurmurHash3(0)），结果和hash_init('murmur3a', 0, [], ['seed' => 0])一致；但传null或不传，则使用内部默认 seed（0xc2b2ae3d），容易和别处结果对不上 -
hash32()返回 int，可能为负数（PHP int 有符号）；需要无符号效果得手动& 0xffffffff -
hash128()返回 16 字节二进制字符串，不是 hex；要转成 32 位小写 hex 得用bin2hex() - 性能上，
hash32()比hash128()略慢——这点反直觉，但 MurmurHash3 实现里 128 位是并行计算，32 位反而多一次截断
为什么本地测试结果和线上不一致
最常被忽略的是字节序和 seed 默认值差异。MurmurHash3 对输入字节严格敏感，一个空格、换行符、BOM 都会改变结果。
- 确认输入字符串编码一致：
mb_convert_encoding($str, 'UTF-8', 'auto')比直接(string)$str更可靠 - Linux 和 Windows 下
file_get_contents()读文件可能带\r\n，而 Mac 是\n；哈希前统一用str_replace("\r\n", "\n", $content) - PHP 8.3+ 的
hash_init('murmur3a')默认 seed 是 0，但某些旧版lastguest/murmurhash类默认用 0xc2b2ae3d，混用就会错
真正麻烦的不是“怎么调用”，而是“怎么确保每次调用都得到相同结果”——seed、编码、换行、字节序，四个点漏一个，哈希值就对不上。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
