Docker PHP 镜像使用教程

1. 项目目录结构及介绍

Docker PHP 镜像是在 Docker 官方镜像仓库上的一个镜像集合，可以从 https://hub.docker.com/_/php 访问。这个项目位于 GitHub 上，地址是 https://github.com/docker-library/php。它的主要目录结构如下：

主要目录

• Dockerfile 文件：这里包含了构建不同版本和配置的 PHP 环境的 Dockerfile。
• testdata 目录：包含了一些测试数据和脚本，用于验证镜像的功能。
• .github 目录：存放 Github 自动化流程相关的配置文件，例如工作流（Workflows）。
• scripts 目录：包含了构建过程中使用的辅助脚本。

每一个 PHP 的版本都对应一个或多个 Dockerfile，分别定义了不同的运行时环境，如 Alpine Linux、Debian 或者 Stretch 等。这些文件描述了如何从基础镜像构建出具有 PHP 功能的 Docker 映像。

2. 项目的启动文件介绍

Docker PHP 镜像并没有特定的"启动文件"，而是通过在 Docker 容器中执行 PHP 命令来启动 PHP 解析器或者 CLI。例如，你可以运行下面的命令启动 PHP CLI 来执行 PHP 脚本：

docker run --rm -v "$PWD":/usr/src/myapp -w /usr/src/myapp php:7.4-fpm php your_script.php

在这个例子中，我们使用 -v 参数将本地目录挂载到容器内，-w 设定了工作目录，并且执行 php your_script.php 命令来运行 PHP 脚本。

3. 项目的配置文件介绍

Docker PHP 镜像的配置主要是通过环境变量来调整 PHP 的配置。一些常见的环境变量包括：

• PHP_INI_DIR: 指定 PHP 配置文件所在目录，默认为 /usr/local/etc/php。
• PHP_EXTRA_CONFIGURE_ARGS: 添加额外的 configure 参数来定制编译 PHP。
• PHP_CONFDIR: 在某些扩展的安装中可能会用到，用来指定扩展的配置文件路径。
• LD_FLAGS, CFLAGS, CPPFLAGS: 影响构建过程中的链接器和编译器标志。

例如，要启用 PHP 的拓展 mysqli 和 gd，可以在运行容器时设置以下环境变量：

docker run --name some-php-app -e "PHP_EXTENSION_MYSQLI=1" -e "PHP_EXTENSION_GD=1" -d php:7.4-apache

此外，可以通过挂载卷的方式，覆盖默认配置文件，实现自定义配置。例如，把本地的 php.ini 文件挂载到容器内的 /usr/local/etc/php/php.ini：

docker run --rm -v "$PWD/php.ini:/usr/local/etc/php/php.ini" -d php:7.4-fpm

这样，容器内的 PHP 将使用你提供的配置文件。

以上就是 Docker PHP 镜像的基本使用方法和配置介绍。确保理解这些概念，你就可以灵活地根据项目需求构建和管理 PHP 运行环境了。