Docker构建PHP镜像必须显式配置Composer中文镜像源，否则默认直连packagist.org导致TLS超时、DNS卡死、下载失败；需确保repo.packagist键名正确、type值为composer、URL以/结尾，并配合清缓存、删lock、优化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 构建中仍卡住的四个硬性原因
即使镜像源配对了，构建仍可能卡住，本质是环境链断裂，而非下载慢。
- 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 分钟。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
-
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 包锁定。
