利用Composer中文镜像优化PHP项目容器化镜像构建速度（Docker优化）-composer-PHP中文网

docker构建php镜像必须显式配置composer中文镜像源，否则默认直连packagist.org导致tls超时、dns卡死、下载失败；需确保repo.packagist键名正确、type值为composer、url以/结尾，并配合清缓存、删lock、优化docker层顺序及参数组合。

利用composer中文镜像优化php项目容器化镜像构建速度（docker优化）

国内环境下，不显式配置 Composer 中文镜像源，Docker 构建 PHP 镜像必然慢——不是你网络差，是容器默认直连 packagist.org，TLS 握手超时、DNS 解析卡死、下载反复失败，composer install 卡在 Loading composer repositories 或 Downloading https://packagist.org/packages.json 是常态。

为什么 `composer config -g repo.packagist` 在 Dockerfile 里写了却没用

这条命令必须在容器内以可写用户身份执行，且路径存在；很多基础镜像（如 php:8.1-cli-slim）默认没创建 /root/.composer，或权限不足，导致配置静默写入失败。

执行前先确认路径可写：RUN mkdir -p /root/.composer && chown -R root:root /root/.composer
键名必须是 repo.packagist（不能是 repos.packagist 或 packagist），中间的 composer 是 type 值，不可省略
URL 必须以 / 结尾，否则拼出 https://mirrors.aliyun.com/composerpackages.json → 404
验证是否生效：RUN composer config -g repo.packagist 输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空值或仍显示 packagist.org 就等于没配成

`composer install` 在 Docker 构建中仍卡住的四个硬性原因

即使镜像源配对了，构建仍可能卡住，本质是环境链断裂，而非下载慢。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

DNS 缓存污染：PHP 的 cURL 复用 DNS 缓存，把 mirrors.aliyun.com 解析到海外 IP —— 可加 RUN echo 'options timeout:1 attempts:2' >> /etc/resolv.conf 强制短超时
缓存未清：换源后旧缓存仍含 packagist.org 元数据，Composer 会优先读缓存并尝试校验原地址 → 必须加 RUN composer clear-cache
composer.lock 不兼容：它记录的是旧源的包哈希，和镜像返回的元数据不一致，会报 hash does not match → 换源后建议删掉 composer.lock 重生成
并发数设太高：设 http-max-concurrent-downloads=15 容易触发 file_put_contents(/tmp/): failed to open stream（tmpfs inode 耗尽），推荐固定为 8

多阶段构建中 vendor 层缓存失效的致命操作

缓存链一断，每次代码变更都重下全量包，CI 构建从 30 秒拉长到 5 分钟。

COPY . /app 放在 COPY composer.json composer.lock ./ 前面 → 任何源码改动都会让后续所有层失效
在 COPY composer.json composer.lock ./ 和 RUN composer install 之间插了任意指令（如 RUN chmod、RUN mkdir）→ 破坏缓存链
没启用 BuildKit 缓存挂载，又没固定 COMPOSER_CACHE_DIR → 每次都从零下载，镜像源再快也白搭
正确顺序只有一条：COPY composer.json composer.lock ./ → RUN composer install --no-dev --optimize-autoloader --classmap-authoritative --no-scripts

`composer install` 参数组合必须严格匹配运行时环境

参数不是越多越好，错配会导致 autoload.php 找不到、类加载失败、甚至容器启动即崩。

--no-dev 必加：避免把 phpunit、phpstan 等 dev 依赖打进生产镜像，增大体积且引入安全风险
--optimize-autoloader 和 --classmap-authoritative 必配：否则 vendor/autoload.php 生成不完整，运行时报 Failed opening required 'vendor/autoload.php'
--ignore-platform-reqs 是危险开关：仅调试用，它绕过 PHP 版本、扩展检查，但最终镜像在目标环境大概率运行失败
禁用 Xdebug：有些 PHP 镜像默认启用，会让 composer install 变慢 3–5 倍 → 加 RUN docker-php-ext-disable xdebug

最易被忽略的一点：镜像源只加速 HTTP 下载，但若 composer.lock 里锁的是 git 地址（如 "source": {"type": "git", "url": "https://github.com/xxx"}），Composer 仍会直连 GitHub —— 这类依赖无法靠换源解决，得提前用 composer config --global github-oauth.github.com xxx 或改用 dist 包锁定。