Docker环境下仅重建Yii2代码及加速开发调试的方法

嘿，这个问题我太有发言权了！之前维护一个大型Yii2项目时，每次Docker构建要等5+分钟，改一行代码就要重来一遍，简直心态爆炸。下面给你几个亲测有效的优化方法，帮你把构建时间压缩到几秒，调试效率拉满：

1. 利用Docker分层缓存，分离依赖安装与代码复制 #

Docker的构建是分层的，只要某一层的内容没变化，就会直接复用缓存。你现在的Dockerfile是先把所有代码复制进去再跑composer install，这意味着只要代码有任何改动，整个依赖安装层都会重新执行——这就是慢的根源！

修改思路：先复制composer.json和composer.lock这两个仅和依赖相关的文件，先执行composer install，之后再复制其余代码。这样只有当依赖文件更新时，才会重新安装依赖；代码改动只会触发最后一层的复制，速度快到飞起。

修改后的Dockerfile片段：

FROM php:5.6-apache

# 先安装系统依赖和PHP扩展（这层也会被缓存，除非你改扩展需求）
RUN apt-get update && \
    apt-get install -y curl nano unzip zlib1g-dev git && \
    docker-php-ext-install pdo pdo_mysql zip && \
    curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer && \
    # 清理apt缓存，减小镜像体积
    apt-get clean && rm -rf /var/lib/apt/lists/*

# 先复制依赖配置文件，触发composer安装（仅当composer.json/lock变化时重建）
COPY composer.json composer.lock /var/www/html/
WORKDIR /var/www/html
RUN composer install --prefer-dist --no-progress

# 再复制项目其余代码（代码改动仅影响这一层，复用前面所有缓存）
COPY . /var/www/html/

# 后续的Apache配置、目录权限等操作（如果这些内容不变，也会复用缓存）
ENV APACHE_DOCUMENT_ROOT /var/www/html/web
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf
RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf

RUN mkdir -p web/assets/ && chmod 777 web/assets
RUN mv vendor/bower-asset/ vendor/bower/

2. 开发阶段用卷挂载，跳过构建直接调试 #

开发时最烦的就是改代码还要重新build+run，用Docker卷挂载可以把本地代码直接映射到容器里，本地修改的代码实时同步到容器，完全不需要重新构建！

调整你的docker run命令，加上卷挂载参数：

docker run --name myapp -p 8000:8000 \
  -v $(pwd):/var/www/html \
  -v /var/www/html/vendor \  # 排除vendor目录，用容器里已安装的依赖，避免本地vendor冲突
  myapp:mytag

解释：

• -v $(pwd):/var/www/html：把当前本地目录挂载到容器的项目目录，本地改代码容器立刻生效
• -v /var/www/html/vendor：这是一个“匿名卷”，用来覆盖挂载的vendor目录，强制使用容器里已安装的依赖（如果本地也有vendor，可能会因为环境不同出问题）

这样每次改完代码，刷新浏览器就能看到效果，调试效率提升N倍！

3. 优化Composer安装速度 #

• 加上--prefer-dist：优先下载压缩包，比克隆Git仓库快很多
• 加上--no-dev（生产环境）：跳过安装开发依赖，减少安装时间和镜像体积
• 如果是国内环境，临时设置Composer镜像：在composer install前加RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（按需添加）

4. 其他小优化 #

• 改用Alpine基础镜像：如果项目兼容，可以用php:5.6-apache-alpine，镜像体积比Debian版小一半以上，构建和拉取速度更快
• 合并RUN命令：把多个小RUN合并成一个，减少镜像层数（你原来的Dockerfile已经做了部分合并，继续保持）

最后说下调整后的流程：

1. 第一次构建（或依赖更新时）：docker build -t myapp:mytag .——这次会完整安装依赖，但之后只要依赖不变，再build就会复用缓存
2. 开发调试时：用上面带卷挂载的docker run命令，改代码直接生效，无需重新构建

内容的提问来源于stack exchange，提问作者Lina