罗罗编程学习记录
本页内容 展开查看

06.5.8.11 Docker 与 Compose 工程化

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.8 PHP 配套技术栈

06.5.8.11-001 Docker 镜像分层是怎么组织的?

一句话结论

镜像由多条只读层叠加而成,每条 Dockerfile 指令产生一层;容器在镜像顶层加一层可写层,联合文件系统把多层合并成统一目录视图;分层让镜像复用与增量构建成为可能。

概念解释

基础镜像层、系统依赖层、PHP 扩展层、应用代码层依次叠加,相同层在镜像间共享。容器写入时采用写时复制:修改文件先从只读层复制到可写层再改。层越多、单层越大,构建与分发成本越高;删除文件不会真正减小底层镜像体积。

原理流程

  1. 基础镜像提供操作系统与 PHP 运行时。
  2. 后续指令依次叠加依赖、扩展、配置与代码层。
  3. 容器启动时在顶部创建可写层承载运行时变更。
  4. 提交新镜像时可写层内容固化为新的只读层。

代码或图示

// 文档示例:Dockerfile 分层视角
// FROM php:8.5-fpm          # 基础运行时层
// RUN docker-php-ext-install pdo_mysql redis  # 扩展层(待确认扩展可用性)
// COPY composer.json composer.lock ./         # 依赖清单层
// COPY . /var/www/html                         # 应用代码层
// 层缓存按指令顺序命中,代码变更只使后续层失效

常见误区

  • 在同一层里删除大文件后以为镜像变小:删除只在可写层掩盖,底层仍保留。
  • 把所有操作写成一条 RUN 与拆成多条随意切换:层数与缓存命中要在构建效率和体积之间权衡。

追问

  • 容器删除后写入数据还在吗?答:可写层随容器删除而销毁,持久数据必须挂卷。
  • 镜像层共享有什么收益?答:多镜像复用同一基础层,减少磁盘占用与传输量。

06.5.8.11-002 如何利用 Docker 构建缓存加速镜像构建?

一句话结论

构建缓存按层顺序命中:指令与上下文未变化则复用上层缓存;把变化少的依赖安装放前面、频繁变更的代码拷贝放后面,可最大化缓存命中;COPY/ADD 上下文变化会使后续全部层失效。

概念解释

Docker 逐条指令检查父层缓存与指令内容、文件校验和是否一致。先拷贝依赖清单并安装依赖,再拷贝业务代码,这样代码改动不会重装 Composer 依赖。缓存失效后该层及其后所有层重新构建。--no-cache 用于强制全量重建排查问题。

原理流程

  1. 按稳定性排序指令:系统依赖 → PHP 扩展 → 依赖清单安装 → 应用代码。
  2. 先 COPY composer.json composer.lock,执行依赖安装。
  3. 再 COPY 业务代码,代码改动只影响最后几层。
  4. 构建时观察缓存命中/失效日志,确认依赖层未被代码变更击穿。

代码或图示

// 文档示例:缓存友好的 Dockerfile 顺序
// COPY composer.json composer.lock /app/
// RUN composer install --no-dev --optimize-autoloader --no-interaction
// COPY . /app/
// 反例:先 COPY . /app/ 再 composer install,任何代码改动都重装依赖

常见误区

  • 依赖清单与代码一起拷贝:代码频繁变更导致依赖层每次重建。
  • 不清理包管理器缓存:依赖安装层把缓存包留在镜像里,体积膨胀。

追问

  • 缓存什么时候必须失效?答:基础镜像升级、扩展版本变化、依赖锁文件变更后应清缓存重建。
  • 多阶段构建缓存如何复用?答:各阶段独立缓存,构建阶段依赖层与运行阶段分离,运行镜像只取产物。

06.5.8.11-003 PHP-FPM 镜像如何选择基础镜像与安装扩展?

一句话结论

生产优先使用官方 PHP FPM 基础镜像,通过 docker-php-ext-install 安装核心扩展,PECL 扩展用 docker-php-ext-pecl install 并启用;系统依赖与编译工具在构建阶段处理,运行镜像保持精简。

概念解释

官方镜像按版本、SAPI(fpm/cli)与变体区分,标签选择要锁定主版本避免漂移。核心扩展随源码提供,PECL 扩展需要编译环境。当前环境为 PHP 8.5.9 CLI,redis、pdo_mysql、Zend OPcache 扩展已装;容器内扩展清单以镜像实际 php -m 为准,未确认的扩展标注待确认。

原理流程

  1. 选定与运行时版本一致的 FPM 基础镜像标签。
  2. 安装扩展所需系统库与编译工具。
  3. 用官方脚本安装核心扩展,PECL 扩展安装后写配置启用。
  4. 清理编译缓存与临时文件,固化 PHP 配置。

代码或图示

// 文档示例:扩展安装片段(扩展名与可用性待确认)
// RUN docker-php-ext-install pdo_mysql opcache \
//  && pecl install redis \
//  && docker-php-ext-enable redis
// 编译期需要的系统包应在同一 RUN 内安装并在结束后清理,避免残留层

常见误区

  • 基础镜像标签用 latest:版本不可控,升级行为不可预期。
  • 只装扩展不装系统依赖库:编译或运行时报缺库,需对照扩展文档补依赖。

追问

  • 扩展配置写在哪里?答:放入 $PHP_INI_DIR/conf.d/ 下的 ini 文件,随镜像固化。
  • 怎么核对镜像内已装扩展?答:容器内执行 php -m 与 php -v,对照运行环境基线。

06.5.8.11-004 什么是多阶段构建,PHP 项目如何用它瘦身?

一句话结论

多阶段构建用独立阶段安装依赖与编译产物,最终镜像只拷贝运行所需文件;构建工具、源码与开发依赖不进入运行镜像,显著减小体积与攻击面。

概念解释

第一阶段基于含 Composer 与编译工具的镜像安装依赖、生成自动加载与静态资源;第二阶段只保留 PHP 运行时、vendor 产物与应用代码。两阶段通过 COPY --from=stage 传递产物。PHP 项目通常不需要编译二进制,但 Composer 开发依赖、测试框架与构建脚本不应进生产镜像。

原理流程

  1. 构建阶段:拷贝清单、composer install --no-dev、生成优化自动加载。
  2. 运行阶段:选精简 FPM 基础镜像,只拷贝代码、vendor 与配置。
  3. 核对运行镜像内无构建工具、测试依赖与源码临时文件。
  4. 对比构建前后镜像体积,确认瘦身效果。

代码或图示

// 文档示例:两阶段 Dockerfile 骨架
// FROM composer:2 AS deps
// WORKDIR /app
// COPY composer.json composer.lock ./
// RUN composer install --no-dev --optimize-autoloader --no-interaction
//
// FROM php:8.5-fpm
// WORKDIR /app
// COPY --from=deps /app/vendor ./vendor
// COPY . /app

常见误区

  • 运行镜像里保留 dev 依赖与测试代码:增大体积,也暴露内部实现。
  • 把构建阶段的编译工具链拷进运行镜像:攻击面扩大,后续维护成本高。

追问

  • 前端静态资源怎么纳入多阶段?答:单独构建阶段生成产物,运行阶段只拷贝发布目录。
  • 多阶段构建影响缓存吗?答:阶段间独立,依赖层缓存不被代码层击穿,通常反而更稳。

06.5.8.11-005 Compose 如何编排 fpm 与 nginx 多容器服务?

一句话结论

Compose 在一个 compose.yml 中定义 fpm、nginx 及依赖服务,各服务在同一自定义网络内用服务名互相解析;nginx 把 .php 请求转发到 fpm 服务名对应端口,代码目录通过共享卷或镜像一致挂载。

概念解释

Compose 是本地与小规模部署的编排工具,服务定义包含镜像/构建、端口、环境变量、卷与依赖关系。fpm 容器只跑 FastCGI,nginx 容器跑 Web 入口;两者通过服务名(如 fpm:9000)通信。生产集群部署另有编排体系,Compose 主要用于开发环境与单机部署。

原理流程

  1. 定义 fpm 服务:构建 Dockerfile、暴露 9000、挂载代码与配置。
  2. 定义 nginx 服务:挂载站点配置与静态资源,转发 fastcgi_pass fpm:9000。
  3. 定义数据库、缓存等依赖服务并挂载数据卷。
  4. up 启动后通过服务名互相访问,端口映射只对外暴露必要入口。

代码或图示

// 文档示例:compose.yml 服务骨架(YAML 写在 compose 文件中)
// services:
//   fpm:
//     build: ./docker/php
//     volumes: [.:/var/www/html]
//   nginx:
//     image: nginx:alpine
//     ports: ["8080:80"]
//     volumes: [./docker/nginx/conf.d:/etc/nginx/conf.d, .:/var/www/html]
//     depends_on: [fpm]

常见误区

  • fpm 与 nginx 各自挂载不同代码目录:两边文件不一致,出现脚本找不到或静态资源缺失。
  • 把数据库等内部服务端口映射到公网:内部服务只在 Compose 网络内通信,不对外暴露。

追问

  • 服务名解析由谁提供?答:Compose 默认网络内置 DNS,按服务名解析到容器内网地址。
  • 同一服务多实例怎么扩?答:Compose 可配置副本数,服务名解析到多个实例;FastCGI 转发轮询行为按 nginx 配置确定。

06.5.8.11-006 Compose 网络与端口映射如何理解?

一句话结论

默认创建 bridge 网络,容器间用服务名互通;ports 把容器端口映射到宿主供外部访问,不映射的端口只在内部网络可达;内部服务不应依赖宿主回环地址互访。

概念解释

bridge 网络隔离不同 Compose 项目的容器;容器间通信走内网 IP 与服务名。端口映射是宿主到容器的单向暴露,外部只能访问已映射端口。容器内连接其他服务用服务名,不能写 127.0.0.1 指向宿主上的依赖(特殊宿主访问方式按平台文档确定,待确认)。

原理流程

  1. Compose 为项目创建默认网络并加入所有服务。
  2. 服务间调用使用服务名与容器内端口。
  3. 对外入口(nginx)配置端口映射;数据库、缓存不映射宿主端口。
  4. 排查连通性时先确认同网络、服务名解析与端口监听。

代码或图示

// 文档示例:网络与地址约定
// fpm 内连接缓存:host = redis(服务名),port = 6379
// fpm 内连接数据库:host = mysql(服务名),port = 3306
// nginx 转发:fastcgi_pass fpm:9000;
// 反例:容器内写 127.0.0.1:3306,指向容器自身而非依赖服务

常见误区

  • 容器间用宿主 IP 或 localhost 互访:网络命名空间隔离,连接不到宿主进程。
  • 所有服务都映射端口:扩大暴露面,内部服务应保持内网可达。

追问

  • 容器怎么访问宿主上的服务?答:按平台提供的宿主访问地址或 host 网络方式,具体名称与行为待确认,不在代码里写死宿主地址。
  • 自定义网络有什么用?答:显式划分网络组,控制哪些服务互通,便于隔离前端与内部服务。

06.5.8.11-007 配置与环境变量如何注入容器?

一句话结论

配置通过环境变量(environment/env_file)注入,敏感配置不写进镜像;容器启动时按环境变量生成配置文件或由应用直接读取,开发与生产用不同环境文件区分。

概念解释

镜像应保持环境无关:数据库地址、密钥、开关在部署时注入。环境变量进入容器进程环境,应用从环境读取;结构化配置可在启动脚本中渲染模板生成。密钥不提交到仓库,不固化进镜像层。.env 文件用于本地默认值,生产机密走部署机密管理。

原理流程

  1. 应用定义需要的环境变量名与默认值。
  2. Compose 用 env_file 或 environment 传入,区分开发/生产。
  3. 启动脚本按需把变量渲染进配置文件,或应用直接读取环境。
  4. 敏感值由部署环境注入,仓库只保存占位与示例。

代码或图示

// 文档示例:环境变量读取(PHP 侧)
$dbHost = getenv('DB_HOST') ?: '127.0.0.1';
$dbName = getenv('DB_NAME') ?: 'app';
// compose.yml:
//   environment:
//     DB_HOST: mysql
//     DB_NAME: app
// 敏感项(密码、密钥)不写入仓库 env 文件,由部署环境注入

常见误区

  • 把生产密码写进 Dockerfile 或提交到仓库:镜像层与历史记录都会留存机密。
  • 配置硬编码在代码里:换环境必须改代码重新构建,违背配置外置原则。

追问

  • 环境变量与配置文件冲突时谁优先?答:按应用配置加载顺序确定,通常环境变量覆盖文件默认值;需在配置层明确约定。
  • 多份配置怎么管理?答:按环境维护示例文件与启动模板,真实值在部署侧注入。

06.5.8.11-008 数据卷有哪几种类型,代码挂载怎么选?

一句话结论

卷分 named volume(Docker 管理持久卷)、bind mount(宿主目录直接挂载)与临时挂载;开发环境用 bind mount 同步代码,生产持久数据用 named volume,容器内临时数据不持久化。

概念解释

bind mount 把宿主目录映射进容器,改动实时反映,适合开发热更新;named volume 由 Docker 管理生命周期,适合数据库数据等持久状态。挂载覆盖容器内同名目录:镜像内预置文件在挂载后被宿主内容遮蔽。代码在生产环境应随镜像发布,而不是依赖宿主挂载。

原理流程

  1. 区分数据性质:应用代码、持久状态、临时文件。
  2. 开发:bind mount 代码目录,便于本地修改即时生效。
  3. 生产:代码打入镜像,持久数据挂 named volume。
  4. 清理时区分卷数据与容器可写层,避免误删持久数据。

代码或图示

// 文档示例:卷挂载方向
// 开发:./:/var/www/html            # bind mount 代码
// 持久:mysql-data:/var/lib/mysql   # named volume 数据库数据
// 临时:/tmp                        # 容器内临时目录,不持久化
// 注意:挂载目录会遮蔽镜像内已拷贝的同名文件

常见误区

  • 生产也 bind mount 代码:宿主目录漂移导致运行版本与镜像不一致。
  • 数据库数据写容器可写层:容器重建后数据丢失,必须挂卷。

追问

  • 卷里的文件怎么备份?答:named volume 按 Docker 数据目录定位,用数据库导出或卷拷贝工具备份;具体方式按部署环境确定。
  • 挂载后权限不对怎么办?答:核对宿主目录属主与容器内运行用户,见权限章节。

06.5.8.11-009 容器内文件权限与运行用户如何处理?

一句话结论

PHP-FPM 容器通常以专用用户运行(官方镜像常见 www-data,具体待确认);挂载目录的属主、组与读写权限要与容器内用户匹配,避免代码目录不可读或上传目录不可写。

概念解释

容器内进程有 UID/GID,bind mount 继承宿主目录权限;UID 不一致会出现「宿主可写、容器内只读」。官方镜像运行用户、UID 与默认目录权限以镜像版本为准,待确认。上传缓存、日志目录需要运行用户可写;不应为图方便把目录权限放开到 777。

原理流程

  1. 确认 FPM 容器运行用户与 UID/GID。
  2. 挂载目录在宿主侧设置匹配属主或组。
  3. 单独标记需要写入的目录(上传、缓存、日志)权限。
  4. 构建镜像时修正目录属主,避免运行时再 chmod 大范围放开。

代码或图示

// 文档示例:权限处理方向
// Dockerfile 内:RUN chown -R app:app /var/www/html/var/cache
// 运行用户:USER app
// 挂载目录:宿主属主 UID 与容器内用户一致
// 待确认:官方 fpm 镜像默认用户名与 UID,以镜像文档为准

常见误区

  • 挂载目录全局可写:越权写入风险,排查问题时先收敛权限。
  • 容器内以 root 跑 FPM:进程提权,破坏容器隔离原则。

追问

  • 宿主 UID 与容器用户不一致怎么改?答:构建时指定与宿主匹配的 UID,或挂载后在启动脚本修正属主;具体按部署规范选择。
  • 上传目录权限怎么验证?答:容器内以运行用户身份试写测试文件,确认目录可写。

06.5.8.11-010 健康检查如何配置,depends_on 能解决什么、不能解决什么?

一句话结论

healthcheck 定期在容器内执行探活命令判定健康状态;depends_on 只控制容器启动顺序,不等待依赖服务真正就绪,就绪判断需要健康检查或启动等待脚本。

概念解释

Compose 的 depends_on 保证先启动依赖容器,但数据库可能还在初始化、FPM 尚未监听端口,此时连接会失败。健康检查通过命令探测端口、进程或接口,健康状态可被编排工具用于判断是否接流量。探活命令要轻量,避免拖垮容器。

原理流程

  1. 为关键服务定义 healthcheck:探测命令、间隔、超时与重试次数。
  2. 应用启动脚本等待依赖就绪(轮询端口或健康接口)后再引导。
  3. Compose 按依赖顺序启动,结合健康状态判断服务可用。
  4. 不健康容器的状态纳入监控与重启策略。

代码或图示

// 文档示例:健康检查方向(命令以镜像内可用工具为准,待确认)
// healthcheck:
//   test: ["CMD-SHELL", "php-fpm-healthcheck || exit 1"]
//   interval: 10s
//   timeout: 3s
//   retries: 3
// 应用侧启动:循环检测 DB 端口可连接后再执行迁移与引导

常见误区

  • 以为 depends_on 后依赖一定可用:容器进程已起 ≠ 服务就绪,初始化期仍会连接失败。
  • 探活命令过重:每次探测占用资源,健康检查应只做轻量连通判断。

追问

  • 健康检查失败会自动重启吗?答:Compose 本身按重启策略处理,健康状态不等于自动重启;编排平台可基于健康状态摘流。
  • 启动等待写多久合适?答:按依赖初始化时间设置上限与重试,超时退出并由守护机制重启。

06.5.8.11-011 服务启动顺序与依赖等待如何落地?

一句话结论

启动顺序靠依赖声明,就绪等待靠应用启动脚本轮询或健康检查;数据库初始化、缓存加载完成前,应用不应开始接流量,失败应退出重试而非带病启动。

概念解释

容器编排只保证进程拉起顺序,服务内部初始化(数据库建表、迁移、配置加载)需要时间。常见做法是入口脚本先等待依赖可达,再执行迁移与引导,最后启动主进程。等待要有超时与失败退出,避免无限阻塞。一次性任务(迁移)与常驻服务分开编排。

原理流程

  1. 入口脚本先检查配置与依赖环境变量。
  2. 轮询数据库/缓存端口与可用状态,达到超时则退出。
  3. 执行必要的初始化(迁移、预热),再启动 FPM 或主进程。
  4. 初始化失败返回非零退出码,由重启策略重新拉起。

代码或图示

// 文档示例:启动等待伪逻辑(shell 入口脚本中表达)
// until php -r "try { new PDO('mysql:host='.getenv('DB_HOST'), getenv('DB_USER'), getenv('DB_PASS')); } catch (Throwable \$e) { exit(1); }"; do
//   echo "waiting db..."; sleep 2;
// done
// php bin/console migrate --no-interaction
// php-fpm

常见误区

  • 应用启动不等待依赖:首屏请求大量连接失败,触发雪崩。
  • 迁移在每个应用容器内重复执行:迁移应由一次性任务执行,避免并发冲突。

追问

  • 数据库首次初始化怎么处理?答:镜像/初始化挂载或独立迁移任务完成,应用容器只等待就绪。
  • 等待脚本占用启动时间有影响吗?答:就绪前不接流量即可;健康检查与重启策略配合避免长期阻塞。

06.5.8.11-012 镜像瘦身有哪些具体手段?

一句话结论

手段包括选择精简基础镜像、多阶段剥离构建依赖、合并 RUN 并清理包缓存与临时文件、不复制开发依赖与文档、区分运行时必需文件;定期分析镜像层找出大文件。

概念解释

镜像体积影响分发速度、磁盘占用与攻击面。包管理器缓存、编译工具、测试框架与示例数据都是可剥离内容。删除文件要在产生它的同一层清理,否则体积不减。镜像分层分析工具可定位最大层与大文件,具体工具与输出以环境为准。

原理流程

  1. 评估基础镜像大小,选择精简变体。
  2. 多阶段构建:构建工具与 dev 依赖不进运行镜像。
  3. 同一 RUN 内安装、清理缓存与临时文件。
  4. 分析各层体积,剔除未使用的文件与目录。

代码或图示

// 文档示例:瘦身 Dockerfile 要点
// RUN apt-get update && apt-get install -y --no-install-recommends libxxx \
//  && docker-php-ext-install pdo_mysql \
//  && rm -rf /var/lib/apt/lists/* /tmp/*
// COPY --from=deps /app/vendor /app/vendor
// .dockerignore 排除:tests、docs、.git、本地日志与临时文件

常见误区

  • 分多条 RUN 安装后单独清理:清理层看不到前面层的文件,体积不下降。
  • 镜像里保留整个源码目录与开发文档:运行时只需要发布产物。

追问

  • 基础镜像越精简越好吗?答:要兼顾排障工具与 glibc 兼容性;极端精简镜像缺少常用命令,排查成本上升。
  • 镜像大怎么定位?答:按层查看大小与文件清单,定位依赖包、日志或大资源文件。

06.5.8.11-013 Composer 依赖在镜像构建中如何处理?

一句话结论

先拷贝 composer.json 与 composer.lock,按锁文件安装依赖并生成优化自动加载;生产安装剔除 dev 依赖,依赖清单与代码层分离以利用构建缓存。

概念解释

锁文件保证依赖版本可复现;--no-dev 排除测试与开发工具,--optimize-autoloader 生成类映射提升自动加载性能。Composer 二进制可由构建阶段提供,运行镜像不必自带 Composer。国内网络环境下的镜像源配置属于部署环境细节,具体配置按项目规范确定。

原理流程

  1. 拷贝清单与锁文件到构建阶段。
  2. 按锁文件安装生产依赖,生成优化自动加载。
  3. 运行阶段只拷贝 vendor 与应用代码。
  4. 锁文件变更触发依赖层重建,代码变更不重装依赖。

代码或图示

// 文档示例:Composer 安装片段
// COPY composer.json composer.lock ./
// RUN composer install --no-dev --no-interaction --optimize-autoloader --prefer-dist
// 校验:容器内 composer show 或查看 vendor 目录确认依赖与版本
// 待确认:Composer 版本与插件兼容性以构建环境为准

常见误区

  • 不提交 composer.lock:生产依赖版本不可复现,构建结果漂移。
  • 生产安装 dev 依赖:带入测试框架与开发工具,增大体积与风险。

追问

  • 自动加载优化在开发环境要开吗?答:开发需要便捷改类,通常不优化;生产开启类映射优化。
  • 私有包怎么安装?答:构建环境配置仓库凭证,凭证不固化进镜像;具体方式按私有源规范确定。

06.5.8.11-014 容器内日志应该输出到哪里?

一句话结论

应用日志输出到 stdout/stderr,由容器运行时收集与轮转;不在容器内磁盘写长期日志文件,避免可写层膨胀与容器重建后日志丢失。

概念解释

容器设计建议进程前台运行、日志走标准流,日志驱动负责转发到日志系统。PHP 应用配置日志通道为标准输出,框架/库的文件日志重定向或关闭。容器内本地临时文件只用于短时处理,持久日志与文件分别走采集服务与对象存储/卷。

原理流程

  1. 应用日志配置输出 stdout/stderr,级别与结构化格式统一。
  2. 容器运行时按日志驱动收集标准流,配置轮转与采集目标。
  3. 不在容器内保存长期日志文件,避免磁盘占满。
  4. 排障时先看容器标准输出日志,再追外部日志系统。

代码或图示

// 文档示例:日志输出方向(PHP 配置层)
// 日志通道:stdout,JSON 结构化字段含 level / message / trace_id / context
// 禁止:在容器内写 /var/log/app/*.log 长期留存
// 采集:运行时日志驱动转发到集中日志系统,轮转策略由驱动配置

常见误区

  • 应用继续写容器内文件:可写层持续增长,重建后日志丢失。
  • 日志不做级别与采样:调试日志占满采集通道,影响后续排查。

追问

  • 框架默认文件日志怎么改?答:在配置中切换到标准输出通道,文件通道仅本地开发使用。
  • 日志文件需要保留在卷上吗?答:集中采集系统负责留存;容器卷不应用于长期日志堆积。

06.5.8.11-015 时区、locale 与 PHP 配置如何固化进镜像?

一句话结论

时区、语言、PHP ini 与 FPM 配置在镜像构建阶段固化,应用不依赖容器默认环境;配置通过 ini 文件或启动模板注入,开发与生产差异走环境变量。

概念解释

基础镜像默认时区与 locale 可能不符合业务要求,需要显式设置 PHP date.timezone 与系统时区。PHP 配置放入 conf.d 目录,FPM 池配置按部署需要挂载或固化。环境相关的开关(调试、错误显示)不在生产镜像中打开。

原理流程

  1. 构建阶段安装时区数据并设置系统与 PHP 时区。
  2. 拷贝自定义 ini 到 PHP 配置目录,固化 OPcache 等运行参数。
  3. FPM 池配置按模板放置,环境差异由变量注入。
  4. 容器内核对 php -i 与配置值,确认生效。

代码或图示

// 文档示例:配置固化方向
// Dockerfile:
//   RUN docker-php-ext-install opcache
//   COPY php.ini /usr/local/etc/php/conf.d/app.ini
//   ENV TZ=Asia/Shanghai
// ini 示例:date.timezone=Asia/Shanghai
// 待确认:基础镜像时区数据包是否需额外安装,以镜像为准

常见误区

  • 依赖镜像默认时区:不同基础镜像默认值不同,时间相关业务出现偏移。
  • 生产镜像开启 display_errors:错误信息外泄,应记录到日志而非输出到响应。

追问

  • 时区在代码里还要不要设置?答:框架/应用可设兜底默认值,但运行时配置是基线,两边保持一致。
  • FPM 进程数配置放镜像还是挂载?答:随环境资源变化的参数挂载或注入,固定基线固化在镜像。

06.5.8.11-016 开发环境与生产环境的 Compose 配置如何分离?

一句话结论

基础 Compose 文件定义服务骨架,开发用覆盖文件加挂载、调试工具与宽松配置;生产用独立编排或精简 Compose,代码打入镜像、关闭开发依赖,环境变量分别管理。

概念解释

Compose 支持多个配置文件叠加,后者覆盖前者。开发场景 bind mount 代码、开启调试、挂热重载;生产场景代码随镜像发布、不挂载源码、限制调试输出。两份配置共享服务命名与网络约定,避免环境间行为漂移。

原理流程

  1. 编写基础 compose.yml 定义服务、网络与卷。
  2. 开发覆盖文件加入代码挂载、调试扩展与工具链。
  3. 生产配置使用固定镜像标签,注入生产环境变量与机密。
  4. 核对两环境配置差异清单,防止开发习惯流入生产。

代码或图示

// 文档示例:多文件叠加方向
// 开发:docker compose -f compose.yml -f compose.dev.yml up
// 生产:固定镜像版本,不挂源码,不装 dev 依赖
// 差异项:代码挂载、调试扩展、错误显示、日志级别、资源限制

常见误区

  • 一套配置打天下:开发挂载与调试能力被带到生产,增加风险。
  • 生产配置靠手改容器内文件:重建后改动丢失,配置必须随编排声明。

追问

  • 开发需要热重载 PHP 吗?答:FPM 无内置热重载,代码改动需 OPcache 失效或 reload FPM;具体机制按运行时配置确定。
  • 生产为什么不用 bind mount?答:保证运行版本与镜像一致,避免宿主目录漂移。

06.5.8.11-017 构建上下文与 .dockerignore 如何影响镜像?

一句话结论

构建上下文是发送给守护进程的目录集合,.dockerignore 排除不需要的文件;忽略无用文件可减小上下文传输、避免敏感文件与本地产物进入镜像。

概念解释

COPY 只能访问构建上下文内文件,上下文过大导致构建慢、缓存命中差。.dockerignore 排除版本控制目录、本地日志、测试文档、系统文件与本地密钥。遗漏排除项会把临时文件或机密打进镜像层。

原理流程

  1. 梳理项目目录中镜像不需要的内容。
  2. 在 .dockerignore 中排除 VCS、本地环境、临时产物与机密文件。
  3. 构建时观察上下文大小与拷贝层内容。
  4. 定期清理忽略清单,避免新目录被误带入。

代码或图示

// 文档示例:.dockerignore 常见条目
// .git
// .env.local
// vendor/            # 依赖在容器内按锁文件安装
// tests/ docs/
// *.log /tmp/
// 注意:需要进入镜像的产物不能被忽略,如 public 发布目录

常见误区

  • 把 .env 本地机密目录打进镜像:上下文与层都会留存敏感值。
  • 忽略了必须的发布目录:镜像内缺文件,运行时 404。

追问

  • 上下文传输慢怎么排查?答:查看被排除目录是否遗漏,减小上下文后观察构建日志。
  • .dockerignore 与仓库 .gitignore 一样吗?答:用途不同,前者服务于镜像构建,需单独维护。

06.5.8.11-018 fpm 与 nginx 容器如何共享代码与配置?

一句话结论

代码一致性靠镜像内相同代码版本或共享卷保证;nginx 容器通过挂载站点配置读取规则,静态资源与脚本路径必须与 fpm 内 DOCUMENT_ROOT 对齐。

概念解释

两容器是独立文件系统,代码来源不一致会出现:nginx 找不到静态文件、fpm 脚本路径错误。开发环境共享 bind mount;生产环境两边镜像包含相同发布版本,nginx 只挂载站点配置。站点配置中的 root 与 fastcgi 参数要和 fpm 目录一致。

原理流程

  1. 确定代码分发方式:开发共享卷,生产同版本镜像。
  2. nginx 挂载/拷贝站点配置,root 指向代码公共目录。
  3. fpm 按相同 DOCUMENT_ROOT 定位脚本。
  4. 联调时核对两边目录结构与文件版本一致。

代码或图示

// 文档示例:路径对齐约定
// 代码根:/var/www/html
// nginx root:/var/www/html/public
// fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name
// 两容器内 /var/www/html 内容一致(共享卷或同版本镜像)

常见误区

  • nginx 与 fpm 代码目录版本不同:静态资源旧、后端新,表现为页面异常。
  • 站点配置 root 指向 fpm 不存在的目录:静态资源 404 或转发路径错误。

追问

  • 静态资源能只放 nginx 容器吗?答:可以,构建时把静态产物打入 nginx 镜像;动态脚本仍在 fpm 镜像,路径规则分别配置。
  • 共享卷性能在开发环境有问题吗?答:宿主与容器间文件同步开销随系统不同,需结合开发机器实测。

06.5.8.11-019 容器重启策略与资源限制如何配置?

一句话结论

重启策略控制退出后是否自动拉起;资源限制约束 CPU 与内存占用,防止单容器耗尽宿主资源;两者结合保证服务自恢复同时避免互相影响。

概念解释

重启策略按场景选择:总是重启、失败时重启或不重启。内存限制需考虑 PHP 进程与 OPcache 占用;CPU 限制影响突发计算性能。资源不足时容器被 OOM 杀死,表现为频繁退出。限制值要结合压测与单进程内存基线设定。

原理流程

  1. 按服务可靠性选择重启策略,区分一次性任务与常驻服务。
  2. 压测单进程内存与 CPU 占用,设定内存上限与 CPU 配额。
  3. 观察容器重启次数与 OOM 记录,调整限制与进程数。
  4. 资源监控纳入宿主与容器两级指标。

代码或图示

// 文档示例:限制方向(数值按压测确定,待确认)
// restart: unless-stopped
// mem_limit: 512m
// cpus: "1.0"
// 排查:容器退出码、OOM 记录、内存峰值与进程数对照

常见误区

  • 不设内存限制:异常进程吃光宿主内存,影响同机其他服务。
  • 限制低于实际峰值:正常请求被 OOM 杀死,错误率上升。

追问

  • 一次性任务要不要自动重启?答:失败任务应受控重试并记录,避免错误结果被反复自动执行。
  • 内存限制与 FPM max_children 什么关系?答:总内存 ≈ 进程数 × 单进程内存,两者必须对齐设定。

06.5.8.11-020 容器化部署常见问题怎么排查?

一句话结论

常见问题包括容器启动即退出、代码改动不生效、扩展缺失、权限拒绝与依赖连不通;排查从退出日志、文件一致性、扩展清单、权限与网络连通性逐项展开。

概念解释

容器问题集中在构建产物、文件系统、运行用户与网络四层。先看容器退出日志与退出码,再核对镜像内文件与扩展,随后检查挂载权限,最后验证服务名连通性。不要在运行容器内手改文件修复问题,应回到 Dockerfile/编排配置修正后重建。

原理流程

  1. 查看容器状态与退出日志,区分启动失败还是运行中崩溃。
  2. 进入容器核对代码版本、vendor 与 php -m 扩展清单。
  3. 检查挂载目录属主与可写目录权限。
  4. 在容器内测试依赖服务连通性,核对网络与环境变量。
  5. 修复配置后重建镜像与容器,验证问题闭环。

代码或图示

// 文档示例:排查清单
// 退出:docker logs <container> / 退出码
// 文件:容器内 ls 代码目录、核对 composer 安装结果
// 扩展:php -m 对照运行时基线
// 权限:运行用户对缓存/上传目录可写
// 网络:容器内 telnet/检测脚本连接依赖服务名与端口
// 待确认:本机无容器运行实例,以上命令在部署环境执行

常见误区

  • 直接改运行容器内文件:重建后问题复现,配置不可追溯。
  • 跳过日志凭经验重启:退出根因未定位,重启只是临时恢复。

追问

  • 代码改动不生效先查什么?答:是否挂了旧目录、OPcache 是否缓存旧字节码、镜像是否重新构建。
  • 扩展报编译缺失怎么办?答:核对构建阶段系统依赖库是否安装、扩展是否在运行镜像层保留。