PHP-ML已归档、不兼容PHP 8.1+且从Packagist下架，composer require必然失败；强行安装会导致类型错误或Fatal error；推荐改用Python训练模型+PHP调用API，或选用维护中的math-php替代。
别装 PHP-ML 了——它已归档、不兼容 PHP 8.1+，且 Packagist 上彻底下架。你执行 composer require php-ml/php-ml 或 php-ai/php-ml 报错或超时，不是配置问题，是库本身已失效。强行拉取历史 commit 会触发类型错误、依赖冲突或 Fatal error: Uncaught TypeError。
PHP 版本和扩展必须先验证
PHP-ML（v0.9）仅支持 PHP 7.2–8.0，2026 年主流 PHP 8.2/8.3/8.5 均无法运行。即使降级 PHP，以下扩展缺一不可：
-
mbstring：字符串处理，缺失会导致CsvDataset解析崩溃 -
json：所有数据序列化依赖，缺失时$classifier->train()静默失败 -
gmp或bcmath：KNN 距离计算需高精度，缺则构造器直接Fatal error -
zlib：Composer 下载包必需，zlib extension is missing错误会卡死整个安装流程
验证命令：php -v 和 php -m | grep -E "(mbstring|json|gmp|bcmath|zlib)"。注意：CLI 和 Web SAPI 的 php.ini 可能不同，composer 只认 CLI 配置。
Composer 本身要能正常下载和解压
Composer 不只是“装包工具”，它在安装 PHP-ML 时要下载 tar.gz 包并解压——这一步强依赖 zlib 和 zip 扩展。常见陷阱：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：装了
php-zip但没启extension=zip，报错却是failed to open stream: operation failed，误导你去查网络 - Windows：
php_zlib.dll文件存在但php.ini写成extension=zlib.dll（应为extension=php_zlib.dll或 PHP 8.0+ 的extension=zlib） - Homebrew PHP 用户：
brew install php@8.2默认不含intl，虽不影响 PHP-ML，但若后续加 Laravel 等依赖会连锁报错
为什么 composer require php-ai/php-ml 看似成功却用不了
因为 php-ai/php-ml 是未发布的 ^1.0 分支，类名、命名空间、示例代码全部重构，文档断档，vendor/autoload.php 加载后仍会抛 Class not found。真实可用的唯一版本是 php-ml/php-ml:^0.9，但它：
- 已于 2021 年从 Packagist 移除，
composer require php-ml/php-ml必报Could not find package - GitHub 仓库已
Archived，无任何维护，PHP 8.1+ 的void返回类型、联合类型均不兼容 - 即使硬用
"minimum-stability": "dev"拉取某次 commit，也会因symfony/console版本冲突导致composer install中断
真正该做的，是放弃本地训练——用 Python 训练模型，PHP 只做 file_get_contents() 或 cURL 调用 API；若只需简单拟合，改用仍在维护的 markrogoyski/math-php，它不叫“机器学习库”，但 Linear 回归、标准差、相关系数全都能跑，且兼容 PHP 8.5。
