使用容器進行 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 檔案以新增資料庫和持久化資料

在 IDE 或文字編輯器中開啟 compose.yaml 檔案。您會注意到它已經包含了 PostgreSQL 資料庫和卷的註釋掉的說明。對於此應用程式，您將使用 MariaDB。有關 MariaDB 的更多詳細資訊，請參見 MariaDB 官方 Docker 映象.

在 IDE 或文字編輯器中開啟 src/database.php 檔案。您會注意到它讀取環境變數以連線到資料庫。

在 compose.yaml 檔案中，您需要更新以下內容

取消註釋並更新 MariaDB 的資料庫說明。
向伺服器服務新增一個秘密以傳入資料庫密碼。
向伺服器服務新增資料庫連線環境變數。
取消註釋卷說明以持久化資料。

以下是更新後的 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

開啟瀏覽器，並在 https://:9000/database.php 上檢視應用程式。您應該看到一個簡單的 Web 應用程式，其中包含文字和一個計數器，每次重新整理時都會遞增。

在終端中按 ctrl+c 以停止您的應用程式。

驗證資料是否持久化到資料庫中

在終端中，執行 docker compose rm 以刪除您的容器，然後執行 docker compose up 以再次執行您的應用程式。

$ docker compose rm
$ docker compose up --build

重新整理瀏覽器中的 https://:9000/database.php 並驗證之前的計數是否仍然存在。如果沒有卷，則在您刪除容器後，資料庫資料將不會持久化。

在終端中按 ctrl+c 以停止您的應用程式。

新增 phpMyAdmin 以與資料庫互動

您可以透過更新 compose.yaml 檔案輕鬆地嚮應用程式堆疊新增服務。

更新您的 compose.yaml 以新增 phpMyAdmin 的新服務。有關更多詳細資訊，請參見 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

開啟瀏覽器，並在 https://:8080 上訪問 phpMyAdmin。使用 root 作為使用者名稱和 example 作為密碼登入。您現在可以透過 phpMyAdmin 與資料庫進行互動。

在終端中按 ctrl+c 以停止您的應用程式。

自動更新服務

使用 Compose Watch 在您編輯和儲存程式碼時自動更新正在執行的 Compose 服務。有關 Compose Watch 的更多詳細資訊，請參見使用 Compose Watch.

在 IDE 或文字編輯器中開啟 compose.yaml 檔案，然後新增 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

開啟瀏覽器，並驗證應用程式是否正在 https://:9000/hello.php 上執行。

對您本地計算機上的應用程式原始檔所做的任何更改現在都會立即反映在正在執行的容器中。

在 IDE 或文字編輯器中開啟 hello.php，並將字串 Hello, world! 更新為 Hello, Docker!。

將更改儲存到 hello.php，然後等待幾秒鐘讓應用程式同步。重新整理 https://: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

開啟瀏覽器，在 https://:9000/hello.php 檢視應用程式。你仍然應該看到簡單的“Hello, Docker!”應用程式。

在終端中按 ctrl+c 以停止您的應用程式。

雖然應用程式看起來相同，但你現在可以使用開發依賴項。繼續下一部分了解如何使用 Docker 執行測試。

總結

在本節中，你瞭解瞭如何設定 Compose 檔案以新增本地資料庫並持久化資料。你還了解了如何使用 Compose Watch 在更新程式碼時自動同步應用程式。最後，你瞭解瞭如何建立一個包含開發所需依賴項的開發容器。

相關資訊

下一步

在下一部分中，你將學習如何使用 Docker 執行單元測試。

執行您的測試