PHP Docker 容器化部署：`Dockerfile` 优化与 `Docker Compose` 配置

各位好，今天咱们就来聊聊 PHP Docker 容器化部署的那些事儿，重点是 Dockerfile 优化和 Docker Compose 配置。听起来是不是有点儿高大上？别怕，咱们一步一个脚印，保证让大家听得懂，用得上。

开场白：为啥要容器化？

想象一下，你开发了一个酷炫的 PHP 应用，信心满满地部署到服务器上，结果发现跑不起来！为啥？因为服务器上的 PHP 版本不对，缺了这个扩展，少了那个依赖。是不是很崩溃？

Docker 就是来拯救你的！它把你的应用和所有依赖打包成一个镜像，然后运行在一个隔离的容器里。这样，无论你的应用跑到哪里，环境都是一样的，再也不用担心环境问题了。这就是容器化的魅力！

第一部分：Dockerfile 优化：打造高效镜像

Dockerfile 是构建 Docker 镜像的蓝图，它的每一行指令都会影响镜像的大小和构建速度。所以，优化 Dockerfile 至关重要。

1. 选择合适的基础镜像

基础镜像就是你的镜像的起点。选择一个合适的基础镜像可以省去很多麻烦。

• Alpine Linux: 最小巧，速度快，但有些工具需要手动安装。
• Debian/Ubuntu: 常用，软件源丰富，但镜像相对较大。
• PHP 官方镜像: 已经包含了 PHP 运行环境，可以直接使用。

选择哪个？取决于你的应用需求。如果你的应用对体积要求很高，或者对性能有极致追求，Alpine Linux 是个不错的选择。如果你的应用依赖很多系统级别的工具，Debian/Ubuntu 可能更适合。通常，建议直接使用官方的 PHP 镜像，因为它已经帮你做好了很多配置。

# 使用 PHP 官方镜像
FROM php:8.2-fpm-alpine

# 或者使用 Debian
# FROM php:8.2-fpm-slim-buster

2. 精简指令，减少层数

Docker 镜像是由一层一层叠加起来的。每一条 RUN 指令都会创建一个新的层。层数越多，镜像越大。所以，要尽量把多个指令合并成一条。

错误示范：

RUN apt-get update
RUN apt-get install -y --no-install-recommends git
RUN apt-get install -y --no-install-recommends zip unzip

正确示范：

RUN apt-get update && 
    apt-get install -y --no-install-recommends git zip unzip && 
    rm -rf /var/lib/apt/lists/*

解释一下：

• &&：把多个命令连接起来，只有前面的命令执行成功，才会执行后面的命令。
• apt-get update: 更新软件包列表。
• apt-get install -y --no-install-recommends git zip unzip: 安装 git, zip, unzip 工具。 -y 表示自动确认安装，--no-install-recommends 表示不安装推荐的依赖，可以减少镜像大小。
• rm -rf /var/lib/apt/lists/*: 清理 apt 缓存，进一步减小镜像大小。

3. 使用多阶段构建 (Multi-stage Builds)

多阶段构建允许你在一个 Dockerfile 中使用多个 FROM 指令，每个 FROM 指令代表一个构建阶段。你可以利用一个阶段来构建你的应用，然后把构建好的产物复制到另一个干净的阶段，最终生成一个体积更小的镜像。

举个例子，如果你需要用 Composer 安装 PHP 依赖，可以这样做：

# 第一阶段：构建阶段
FROM composer:latest AS composer

# 设置工作目录
WORKDIR /app

# 复制 composer.json 和 composer.lock 文件
COPY composer.json composer.lock ./

# 安装依赖
RUN composer install --no-dev --optimize-autoloader --no-interaction --prefer-dist

# 第二阶段：运行阶段
FROM php:8.2-fpm-alpine

# 安装必要的扩展
RUN docker-php-ext-install pdo pdo_mysql

# 设置工作目录
WORKDIR /var/www/html

# 复制应用代码
COPY --from=composer /app ./

# 复制应用代码
COPY . .

# 设置权限
RUN chown -R www-data:www-data /var/www/html

# 暴露 9000 端口
EXPOSE 9000

# 启动 PHP-FPM
CMD ["php-fpm"]

解释一下：

• FROM composer:latest AS composer: 使用 Composer 镜像作为构建阶段，并命名为 composer。
• COPY --from=composer /app ./: 从 composer 阶段复制 /app 目录下的文件到当前阶段。
• --no-dev: 不安装开发依赖。
• --optimize-autoloader: 优化自动加载器。
• --no-interaction: 非交互式安装。
• --prefer-dist: 优先使用稳定版本。

4. 合理利用缓存

Docker 在构建镜像时会缓存每一层的结果。如果某一层没有发生变化，Docker 会直接使用缓存，而不会重新执行指令。所以，要把不经常变化的指令放在前面，经常变化的指令放在后面。

例如，COPY composer.json composer.lock ./ 应该放在 RUN composer install 之前，因为 composer.json 和 composer.lock 文件不经常变化。

5. 使用 .dockerignore 文件

.dockerignore 文件的作用类似于 .gitignore，它可以排除一些不必要的文件和目录，避免它们被复制到镜像中。这可以减小镜像大小，加快构建速度。

例如，你可以排除 vendor 目录、日志文件、临时文件等。

vendor/
*.log
tmp/

6. 其他优化技巧

• 使用环境变量： 把一些配置信息放在环境变量中，方便修改和管理。
• 设置用户： 避免以 root 用户运行容器，增加安全性。
• 健康检查： 添加健康检查，让 Docker 知道你的应用是否正常运行。

第二部分：Docker Compose 配置：编排多容器应用

Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。它使用 YAML 文件来配置应用的服务、网络和卷。

1. docker-compose.yml 文件

docker-compose.yml 文件是 Docker Compose 的核心。它定义了你的应用需要哪些服务，以及这些服务之间的关系。

一个简单的 docker-compose.yml 文件可能长这样：

version: "3.9"

services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "80:80"
    volumes:
      - .:/var/www/html
    depends_on:
      - db
    environment:
      DB_HOST: db
      DB_DATABASE: mydatabase
      DB_USERNAME: myuser
      DB_PASSWORD: mypassword

  db:
    image: mysql:8.0
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: mydatabase
      MYSQL_USER: myuser
      MYSQL_PASSWORD: mypassword
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

解释一下：

• version: Docker Compose 文件的版本。
• services: 定义了应用的服务。
  • web: Web 应用服务。
    • build: 指定构建镜像的方式。
      • context: 构建上下文，表示 Dockerfile 所在的目录。
      • dockerfile: Dockerfile 的文件名。
    • ports: 端口映射，把容器的 80 端口映射到宿主机的 80 端口。
    • volumes: 卷挂载，把宿主机的当前目录挂载到容器的 /var/www/html 目录。这样，你修改代码后，容器里的代码也会同步更新。
    • depends_on: 定义服务之间的依赖关系，表示 web 服务依赖于 db 服务。 Docker Compose 会先启动 db 服务，再启动 web 服务。
    • environment: 定义环境变量。
  • db: 数据库服务。
    • image: 使用 mysql:8.0 镜像。
    • environment: 定义环境变量，设置 MySQL 的 root 密码、数据库名、用户名和密码。
    • volumes: 卷挂载，把 db_data 卷挂载到容器的 /var/lib/mysql 目录。这样，数据库的数据会被持久化存储。
• volumes: 定义卷。
  • db_data: 一个命名卷，用于存储数据库的数据。

2. 常用 Docker Compose 命令

• docker-compose up: 构建并启动应用。
• docker-compose down: 停止并删除应用。
• docker-compose build: 构建镜像。
• docker-compose ps: 查看应用的状态。
• docker-compose logs: 查看应用的日志。
• docker-compose exec: 在容器中执行命令。

3. Docker Compose 优化技巧

• 使用 extends 继承配置： 可以把一些公共配置放在一个文件中，然后让其他服务继承这些配置。
• 使用 profiles 定义不同环境的配置： 可以定义 development、staging、production 等不同的配置，方便在不同的环境中使用不同的配置。
• 使用 healthcheck 定义健康检查： 可以让 Docker Compose 知道你的应用是否正常运行，如果应用不正常，Docker Compose 会自动重启它。
• 使用 restart 定义重启策略： 可以定义容器在退出后是否自动重启。

举例说明：使用 extends 继承配置

创建一个 base.yml 文件，定义一些公共配置：

version: "3.9"

services:
  base:
    image: php:8.2-fpm-alpine
    volumes:
      - .:/var/www/html
    environment:
      APP_ENV: development

然后，在 docker-compose.yml 文件中继承这些配置：

version: "3.9"

services:
  web:
    extends:
      file: base.yml
      service: base
    ports:
      - "80:80"
    depends_on:
      - db
    environment:
      DB_HOST: db
      DB_DATABASE: mydatabase
      DB_USERNAME: myuser
      DB_PASSWORD: mypassword

  db:
    image: mysql:8.0
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: mydatabase
      MYSQL_USER: myuser
      MYSQL_PASSWORD: mypassword
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

举例说明：使用 profiles 定义不同环境的配置

version: "3.9"

services:
  web:
    image: php:8.2-fpm-alpine
    ports:
      - "80:80"
    volumes:
      - .:/var/www/html
    environment:
      APP_ENV: development
    profiles: ["development"]

  web-production:
    image: php:8.2-fpm-alpine
    ports:
      - "80:80"
    volumes:
      - .:/var/www/html
    environment:
      APP_ENV: production
    profiles: ["production"]

在这个例子中，web 服务只会在 development 环境下启动，web-production 服务只会在 production 环境下启动。

你可以使用 docker-compose --profile development up 命令来启动 development 环境，使用 docker-compose --profile production up 命令来启动 production 环境。

总结：容器化的最佳实践

• 镜像要小： 镜像越小，下载和部署速度越快。
• 配置要灵活： 使用环境变量来配置应用，方便在不同的环境中使用不同的配置。
• 监控要到位： 添加健康检查，让 Docker 知道你的应用是否正常运行。
• 安全要重视： 避免以 root 用户运行容器，定期更新镜像。

尾声：容器化的未来

容器化技术正在快速发展，未来它将在更多领域发挥重要作用。希望今天的分享能帮助大家更好地理解和应用容器化技术，让你的 PHP 应用跑得更快、更稳、更安全！

祝大家容器化愉快！