边缘节点PHP控制端上线慢主因是Composer依赖下载卡顿，需严格配置阿里云镜像、开启并行下载、强制dist模式、清缓存，并用dump-autoload生成权威类映射以减少IO。
边缘节点上 PHP 控制端上线慢，90% 是 Composer 卡在下载依赖上——不是代码写得慢，是包没拉下来。
composer config -g repo.packagist 命令必须带全四个要素
阿里云镜像配不生效？大概率是这条命令写错了。它不是“差不多就行”，漏一个就静默失败：
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/—— 四个部分缺一不可：-g（全局）、repo.packagist（注意是单数，不是repos）、composer（type 字段，必须写，不是注释）、https://mirrors.aliyun.com/composer/（末尾斜杠/不能少） - 写成
repos.packagist：配置进错字段，composer config -g repo.packagist查出来为空，install 还走官方源 - URL 少斜杠（如
https://mirrors.aliyun.com/composer）：请求路径拼成/composerpackages.json，直接 404，不报错但卡住 - Windows 用户改完要重启终端，否则 PHP 进程读不到新环境变量
为什么改了镜像还是走 packagist.org？权限和用户搞混了
CI/CD 或 Docker 构建时，sudo composer config -g 写进了 root 用户的 ~/.composer/config.json，但构建用的是 www-data 或普通用户，根本读不到这个配置。
验证是否真生效，别信 config -g 输出：
立即学习“PHP免费学习笔记（深入）”；
- 跑
composer diagnose，看Repo packagist.org:后面是不是你设的地址 - 加
-vvv跑composer update，grep mirrors.aliyun.com看日志里有没有命中 - 卡在
Loading composer repositories30 秒？不是镜像没配，是超时太短——Composer 默认单源等满 30 秒才切下一个，DNS 慢、TLS 握手卡、IPv6 fallback 都会拖满这 30 秒
边缘节点资源紧张，必须关掉干扰项再装依赖
装完 Composer 后立刻执行这三步，否则第一次 install 就会慢到怀疑人生：
- 换镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 开并行下载（Composer 2.2+）：
composer config -g parallel-downloads 10 - 强制 dist 模式：
composer config -g prefer-dist true - 清旧缓存：
composer clear-cache—— 否则它可能还在用 packagist.org 的元数据，镜像等于白配
部署时加参数精简流程：composer install --no-dev --prefer-dist --no-autoloader --no-scripts。边缘设备不需要 dev 包、不需要生成 autoload、也不需要执行 post-install 脚本，省下几秒就是关键。
autoloader 优化对 IoT 设备影响最大
边缘节点 CPU 和 I/O 资源有限，类自动加载不能靠运行时扫描文件。必须用这条命令生成权威类映射：
composer dump-autoload --optimize --classmap-authoritative
效果是：
- 跳过
file_exists()检查，直接查内存里的 classmap - 避免 PSR-4 命名空间路径遍历，减少磁盘 IO
- 启动耗时下降 40%~70%，尤其在小内存设备（如 512MB RAM 的 ARM 边缘网关）上感知明显
注意：--classmap-authoritative 意味着所有类必须出现在 classmap 中，漏掉的类会直接 fatal error——所以务必确保 src/ 目录结构和 autoload 配置完全匹配，别留空目录或临时测试文件。
真正卡住边缘设备上线的，从来不是代码逻辑，而是第一次 composer install 时 DNS 解析失败、TLS 握手超时、或者 autoloader 每次请求都扫一遍 vendor 目录。这些点不提前压住，再好的物联网架构也起不来。
