使用容器进行 PHP 开发

先决条件

完成 PHP 应用程序的容器化。

概述

在本部分中，您将了解如何为容器化应用程序设置开发环境。这包括：

添加本地数据库并持久化数据
添加phpMyAdmin与数据库交互
配置 Compose 以在您编辑和保存代码时自动更新正在运行的 Compose 服务
创建包含开发依赖项的开发容器

添加本地数据库并持久化数据

您可以使用容器来设置本地服务，例如数据库。要对示例应用程序执行此操作，您需要执行以下操作：

更新Dockerfile以安装扩展以连接到数据库
更新compose.yaml文件以添加数据库服务和卷来保存数据

更新 Dockerfile 以安装扩展

要安装 PHP 扩展，您需要更新Dockerfile.在 IDE 或文本编辑器中打开 Dockerfile，然后更新内容。以下 Dockerfile包括安装pdo和pdo_mysql 扩展的一条新线路。所有评论已被删除。

# syntax=docker/dockerfile:1

FROM composer:lts as deps
WORKDIR /app
RUN --mount=type=bind,source=composer.json,target=composer.json \
    --mount=type=bind,source=composer.lock,target=composer.lock \
    --mount=type=cache,target=/tmp/cache \
    composer install --no-dev --no-interaction

FROM php:8.2-apache as final
RUN docker-php-ext-install pdo pdo_mysql
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
COPY --from=deps app/vendor/ /var/www/html/vendor
COPY ./src /var/www/html
USER www-data

有关安装 PHP 扩展的更多详细信息，请参阅 PHP 的官方 Docker 镜像。

更新 compose.yaml 文件以添加数据库并保留数据

compose.yaml在 IDE 或文本编辑器中打开文件。您会注意到它已经包含 PostgreSQL 数据库和卷的注释掉指令。对于此应用程序，您将使用 MariaDB。有关 MariaDB 的更多详细信息，请参阅 MariaDB 官方 Docker 镜像。

src/database.php在 IDE 或文本编辑器中打开文件。您会注意到它读取环境变量以便连接到数据库。

在该compose.yaml文件中，您需要更新以下内容：

取消注释并更新 MariaDB 的数据库说明。
向服务器服务添加一个secret以传入数据库密码。
将数据库连接环境变量添加到服务器服务中。
取消注释卷指令以保留数据。

以下是更新后的compose.yaml文件。所有评论已被删除。

services:
  server:
    build:
      context: .
    ports:
      - 9000:80
    depends_on:
      db:
        condition: service_healthy
    secrets:
      - db-password
    environment:
      - PASSWORD_FILE_PATH=/run/secrets/db-password
      - DB_HOST=db
      - DB_NAME=example
      - DB_USER=root
  db:
    image: mariadb
    restart: always
    user: root
    secrets:
      - db-password
    volumes:
      - db-data:/var/lib/mysql
    environment:
      - MARIADB_ROOT_PASSWORD_FILE=/run/secrets/db-password
      - MARIADB_DATABASE=example
    expose:
      - 3306
    healthcheck:
      test:  ["CMD", "/usr/local/bin/healthcheck.sh", "--su-mysql", "--connect",  "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
volumes:
  db-data:
secrets:
  db-password:
    file: db/password.txt

笔记
要了解有关 Compose 文件中的说明的更多信息，请参阅 Compose 文件参考。

在使用 Compose 运行应用程序之前，请注意此 Compose 文件使用 secrets并指定一个password.txt文件来保存数据库的密码。您必须创建此文件，因为它不包含在源存储库中。

在该docker-php-sample目录中，创建一个名为的新目录db，并在该目录内创建一个名为password.txt.在 IDE 或文本编辑器中打开password.txt并添加以下密码。密码必须位于单行中，文件中不得有任何其他行。

example

保存并关闭password.txt文件。

您的目录中现在应该有以下内容docker-php-sample。

├── docker-php-sample/
│ ├── .git/
│ ├── db/
│ │ └── password.txt
│ ├── src/
│ ├── tests/
│ ├── .dockerignore
│ ├── .gitignore
│ ├── compose.yaml
│ ├── composer.json
│ ├── composer.lock
│ ├── Dockerfile
│ ├── README.Docker.md
│ └── README.md

运行以下命令来启动您的应用程序。

$ docker compose up --build

打开浏览器并在http://localhost:9000/database.php查看应用程序。您应该看到一个简单的 Web 应用程序，其中包含文本和每次刷新时都会递增的计数器。

按ctrl+c终端停止您的应用程序。

验证数据是否保留在数据库中

在终端中，运行docker compose rm以删除容器，然后运行docker compose up以再次运行应用程序。

$ docker compose rm
$ docker compose up --build

在浏览器中刷新 http://localhost:9000/database.php并验证之前的计数是否仍然存在。如果没有卷，删除容器后数据库数据将不会保留。

按ctrl+c终端停止您的应用程序。

添加phpMyAdmin与数据库交互

您可以通过更新文件轻松地将服务添加到应用程序堆栈中compose.yaml。

更新您的compose.yamlphpMyAdmin 添加新服务。有关更多详细信息，请参阅 phpMyAdmin 官方 Docker 镜像。以下是更新后的compose.yaml文件。

services:
  server:
    build:
      context: .
    ports:
      - 9000:80
    depends_on:
      db:
        condition: service_healthy
    secrets:
      - db-password
    environment:
      - PASSWORD_FILE_PATH=/run/secrets/db-password
      - DB_HOST=db
      - DB_NAME=example
      - DB_USER=root
  db:
    image: mariadb
    restart: always
    user: root
    secrets:
      - db-password
    volumes:
      - db-data:/var/lib/mysql
    environment:
      - MARIADB_ROOT_PASSWORD_FILE=/run/secrets/db-password
      - MARIADB_DATABASE=example
    expose:
      - 3306
    healthcheck:
      test:  ["CMD", "/usr/local/bin/healthcheck.sh", "--su-mysql", "--connect",  "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
  phpmyadmin:
    image: phpmyadmin
    ports:
      - 8080:80
    depends_on:
      - db
    environment:
      - PMA_HOST=db
volumes:
  db-data:
secrets:
  db-password:
    file: db/password.txt

在终端中，运行docker compose up以再次运行您的应用程序。

$ docker compose up --build

在浏览器中打开 http://localhost:8080访问phpMyAdmin。使用root用户名和example密码登录。您现在可以通过 phpMyAdmin 与数据库交互。

按ctrl+c终端停止您的应用程序。

自动更新服务

使用 Compose Watch 在您编辑和保存代码时自动更新正在运行的 Compose 服务。有关 Compose Watch 的更多详细信息，请参阅使用 Compose Watch。

compose.yaml在 IDE 或文本编辑器中打开文件，然后添加 Compose Watch 指令。以下是更新后的compose.yaml文件。

services:
  server:
    build:
      context: .
    ports:
      - 9000:80
    depends_on:
      db:
        condition: service_healthy
    secrets:
      - db-password
    environment:
      - PASSWORD_FILE_PATH=/run/secrets/db-password
      - DB_HOST=db
      - DB_NAME=example
      - DB_USER=root
    develop:
      watch:
        - action: sync
          path: ./src
          target: /var/www/html
  db:
    image: mariadb
    restart: always
    user: root
    secrets:
      - db-password
    volumes:
      - db-data:/var/lib/mysql
    environment:
      - MARIADB_ROOT_PASSWORD_FILE=/run/secrets/db-password
      - MARIADB_DATABASE=example
    expose:
      - 3306
    healthcheck:
      test:  ["CMD", "/usr/local/bin/healthcheck.sh", "--su-mysql", "--connect",  "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
  phpmyadmin:
    image: phpmyadmin
    ports:
      - 8080:80
    depends_on:
      - db
    environment:
      - PMA_HOST=db
volumes:
  db-data:
secrets:
  db-password:
    file: db/password.txt

运行以下命令以使用 Compose Watch 运行您的应用程序。

$ docker compose watch

打开浏览器并验证应用程序是否正在 http://localhost:9000/hello.php运行。

对本地计算机上应用程序源文件的任何更改现在都将立即反映在正在运行的容器中。

在 IDE 或文本编辑器中打开hello.php并将字符串更新Hello, world!为Hello, Docker!.

保存更改hello.php，然后等待几秒钟以使应用程序同步。在浏览器中刷新 http://localhost:9000/hello.php并验证是否显示更新的文本。

按ctrl+c终端中的来停止 Compose Watch。docker compose down在终端中运行以停止应用程序。

创建开发容器

此时，当您运行容器化应用程序时，Composer 不会安装开发依赖项。虽然这个小映像非常适合生产，但它缺少开发时可能需要的工具和依赖项，并且不包含目录tests。您可以使用多阶段构建在同一个 Dockerfile 中构建开发和生产阶段。有关更多详细信息，请参阅多阶段构建。

在中Dockerfile，您需要更新以下内容：

将deps舞台分为两个阶段。一个阶段用于生产 ( prod-deps)，一个阶段 ( dev-deps) 用于安装开发依赖项。
创建一个共同的base舞台。
development开创发展新阶段。
更新final阶段以从新prod-deps阶段复制依赖项。

以下是Dockerfile修改前和修改后的情况。

# syntax=docker/dockerfile:1

FROM composer:lts as deps
WORKDIR /app
RUN --mount=type=bind,source=composer.json,target=composer.json \
    --mount=type=bind,source=composer.lock,target=composer.lock \
    --mount=type=cache,target=/tmp/cache \
    composer install --no-dev --no-interaction

FROM php:8.2-apache as final
RUN docker-php-ext-install pdo pdo_mysql
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
COPY --from=deps app/vendor/ /var/www/html/vendor
COPY ./src /var/www/html
USER www-data

# syntax=docker/dockerfile:1

FROM composer:lts as prod-deps
WORKDIR /app
RUN --mount=type=bind,source=./composer.json,target=composer.json \
    --mount=type=bind,source=./composer.lock,target=composer.lock \
    --mount=type=cache,target=/tmp/cache \
    composer install --no-dev --no-interaction

FROM composer:lts as dev-deps
WORKDIR /app
RUN --mount=type=bind,source=./composer.json,target=composer.json \
    --mount=type=bind,source=./composer.lock,target=composer.lock \
    --mount=type=cache,target=/tmp/cache \
    composer install --no-interaction

FROM php:8.2-apache as base
RUN docker-php-ext-install pdo pdo_mysql
COPY ./src /var/www/html

FROM base as development
COPY ./tests /var/www/html/tests
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
COPY --from=dev-deps app/vendor/ /var/www/html/vendor

FROM base as final
RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
COPY --from=prod-deps app/vendor/ /var/www/html/vendor
USER www-data

compose.yaml通过添加针对开发阶段的指令来更新您的文件。

以下是该compose.yaml文件的更新部分。

services:
  server:
    build:
      context: .
      target: development
      # ...

您的容器化应用程序现在将安装开发依赖项。

运行以下命令来启动您的应用程序。

$ docker compose up --build

打开浏览器并在http://localhost:9000/hello.php查看应用程序。您仍然应该看到简单的“Hello, Docker!”应用。

按ctrl+c终端停止您的应用程序。

虽然应用程序看起来相同，但您现在可以使用开发依赖项。继续下一部分，了解如何使用 Docker 运行测试。

概括

在本部分中，您了解了如何设置 Compose 文件以添加本地数据库并保留数据。您还了解了如何使用 Compose Watch 在更新代码时自动同步您的应用程序。最后，您学习了如何创建包含开发所需的依赖项的开发容器。

下一步

在下一节中，您将学习如何使用 Docker 运行单元测试。

运行您的测试