php-ml下载慢是因为其依赖链需从packagist.org解析元数据并从github下载zip，两步均受dns解析慢、tls握手卡、首字节延迟高等影响；临时加镜像源可解决：composer require php-ai/php-ml --repository=https://mirrors.aliyun.com/composer/。
直接用 composer require 加国内镜像源就能下，不用改任何配置文件，也不需要手动下载 ZIP 包。
为什么 php-ml 下载特别慢？
不是 php-ml 本身大，而是它的依赖链里包含多个带二进制扩展或文档资源的包（比如 symfony/console、ext-gmp 相关提示），Composer 默认会去 packagist.org 解析元数据 + 从 GitHub 下 ZIP —— 这两步在国内都容易卡在 TLS 握手或首字节延迟上。你看到 Loading composer repositories with package information 卡住 2 分钟以上，基本就是这个原因。
临时加镜像源，一行命令搞定安装
不需要提前配全局镜像，也不用进项目目录，直接运行：
composer require php-ai/php-ml --repository=https://mirrors.aliyun.com/composer/
这条命令会：
- 只对本次
require生效，不影响其他项目 - 强制所有元数据和 ZIP 包都走阿里云镜像（包括其上游依赖）
- 跳过本地
composer.json是否已存在该包的校验，适合首次引入
如果报 Could not find package php-ai/php-ml，说明镜像 URL 拼写错误或已失效 —— 当前（2026年7月）确认可用的地址是：https://mirrors.aliyun.com/composer/（注意结尾必须有 /），不是 php-compose 或旧版 phpcomposer.com。
装完发现 vendor/php-ai/php-ml 里缺文件？检查这三处
php-ml 依赖 ext-gmp 和 ext-json，但 Composer 不会自动报错，只会跳过部分功能：
- 运行
php -m | grep gmp，没输出就说明gmp扩展没启用 —— 编辑php.ini，取消;extension=gmp前的分号 -
composer.lock里查"php-ai/php-ml"的dist.shasum，用它拼出镜像 ZIP 地址，手动curl -I看是否返回200（避免镜像同步延迟） - 如果用了
--no-dev或COMPOSER_NO_DEV=1，php-ml的测试工具类（如Phpml\Dataset\Demo）不会被加载，不是 bug 是预期行为
长期用 php-ml 的项目，别只靠临时镜像
每次 composer update 都要加 --repository 太麻烦，而且 CI 构建时容易漏。正确做法是进项目根目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
它会往 composer.json 写入 repositories 字段，但注意：
- 不要手动编辑
composer.json的repositories—— JSON 格式错一个逗号就导致composer install报Could not load package - 如果项目已有私有仓库配置，这条命令会追加而非覆盖，安全
- 执行后立刻生效，不需要
composer dump-autoload或重启服务
真正容易被忽略的是：镜像只加速下载，不解决 php-ml 本身的内存占用问题。训练小数据集就卡死？先试 COMPOSER_MEMORY_LIMIT=-1 composer require php-ai/php-ml，再调代码里的 ini_set('memory_limit', '512M')。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
