Composer安装php-lz4失败是因为它不是Packagist上的PHP类库包，而是需编译安装的C扩展，必须通过phpize、configure、make、install流程部署，并在php.ini中启用lz4.so，无法用composer require安装。
php-lz4 并不是一个通过 Composer 官方包管理器安装的标准 PHP 扩展库 —— 它本质上是 PHP 对 liblz4 C 库的封装，必须以 PHP 扩展（extension）形式编译安装，不能用 composer require 直接拉取。
为什么 composer require 会失败
搜索 Packagist 或运行 composer require lz4/lz4、composer require php-lz4 等常见组合，结果都是「Package not found」。因为：
• php-lz4 没有发布为 Composer 可识别的 PSR-4 类库；
• 它依赖系统级 liblz4 开发头文件和动态链接库；
• 所有功能（如 lz4_compress()、lz4_uncompress()）都是通过 PHP 的 extension 机制暴露的函数，不是纯 PHP 类。
正确安装路径：编译 PHP 扩展
需分三步走，缺一不可：
- 确保系统已安装
liblz4-dev（Ubuntu/Debian）或lz4-devel（CentOS/RHEL/Fedora） - 克隆官方扩展源码：
git clone https://github.com/kjdev/php-ext-lz4.git - 进入目录后执行：
phpize && ./configure && make && sudo make install - 在
php.ini中添加：extension=lz4.so（注意确认生成的.so文件名，部分版本可能是lz4.la或带 PHP 版本号） - 重启 PHP-FPM 或 Apache，并运行
php -m | grep lz4验证是否加载成功
验证与使用：别直接调用未定义函数
扩展装完不代表函数立即可用 —— 常见错误是写 lz4_uncompress($data) 却报 Call to undefined function：
立即学习“PHP免费学习笔记（深入）”；
- 先检查
phpinfo()页面是否有lz4模块区块，或运行php -r "print_r(get_extension_funcs('lz4'));" - 可用函数包括：
lz4_compress()、lz4_uncompress()、lz4_compress64k()、lz4_uncompress64k()，不支持流式解压或自定义字典 - 输入必须是 string，输出也是 string；压缩失败返回
false，不是抛异常，需手动判断 - 若用在 CLI 脚本中，记得
php -d extension=lz4.so script.php显式启用（避免依赖全局配置）
性能对比与替代建议
实测在小数据（lz4_compress() 比 gzencode() 快 3–5 倍，但压缩率低约 30%；大文件则优势收窄，且不支持增量压缩。
- 如果你只是想快速压缩日志或缓存键值，
lz4是合适选择； - 但若需要兼容性（如跨语言解压）、流式处理或高压缩率，
zstd（PHP 8.3+ 原生支持）或igbinary+zlib组合更稳妥； - 注意：LZ4 不做校验和，传输中损坏会导致
lz4_uncompress()返回false，务必在外层加base64_encode()或crc32()校验逻辑
真正卡住人的从来不是命令行那几行编译指令，而是没意识到它根本不是 Composer 包 —— 把它当普通类库去 require，只会浪费半小时查文档。
