RTFM First! docker-phpdev

镜像概述和主要用途

本镜像为PHP开发提供基础环境，仅用于开发目的。

该镜像在开发阶段实现了许多实用功能，但在生产环境中使用极其危险（例如，以root用户运行php-fpm）。

核心功能和特性

• 包含优化的php-fpm及多种PHP扩展，满足开发需求
• 集成nginx、crontab、composer、mhsendmail和python等工具
• 支持PHP 8.0及以上版本的Dockerfile自动生成，便于维护新版本
• 对已结束生命周期（EOL）的旧PHP版本提供手动编辑支持

项目结构

• legacy：包含不再维护的PHP版本的项目文件。若这些版本出现问题需要修复，可手动编辑此目录下的任何Dockerfile
• out：包含自动构建的PHP版本的项目文件。请勿手动编辑这些文件
• skeletons：包含用于构建项目的模板。此目录中所有*.template文件均通过jinja2模板引擎解析
• Readme.md：本文档
• config.yaml：指定特定PHP版本使用的模板以及自动维护的PHP版本列表

构建方法

PHP 8.0及以上版本的Dockerfile自动生成，请勿手动编辑这些版本的Dockerfile

添加新PHP版本

1. 编辑config.yaml文件，在out列表中添加新的PHP版本
2. 在Dockerhub添加新标签（将自动构建值设为OFF）：[***]
3. 将更改推送到master分支以触发构建

（可选）若需本地构建获取Dockerfile，执行：

bash
docker run --rm -u $(id -u ${USER}):$(id -g ${USER}) -v ${PWD}:/data m4x0nus/multiplicator update -d /data -c /data/config.yaml

需手动编辑的Dockerfile

legacy目录包含已过时且已达生命周期结束（EOL）的PHP版本。若这些版本出现问题需要修复，可手动编辑。

构建特定PHP版本

bash
docker build -t aheadworks/phpdev:7.2 --build-arg PHP_VERSION=7.2 .

带XDebug支持：

bash
docker build -t aheadworks/phpdev:7.1-xdebug --build-arg PHP_VERSION=7.1-xdebug --build-arg WITH_XDEBUG=1 .

可用构建参数

FPM_USER="root"          # php-fpm运行用户
FPM_GROUP="root"         # php-fpm运行组
PHP_MEMORY_LIMIT=2048M   # PHP内存限制
XDEBUG_IDEKEY="PHPSTORM" # XDebug IDE密钥
XDEBUG_REMOTE_ENABLE="on" # 启用远程调试
XDEBUG_REMOTE_PORT=9001  # 远程调试端口
XDEBUG_REMOTE_CONNECT_BACK="on" # 允许反向连接

包含组件

基础工具

• php-fpm
• nginx
• crontab
• composer
• mhsendmail
• python

PHP扩展

• bcmath
• gd
• intl
• mbstring
• pdo_mysql
• soap
• sockets
• xsl
• xdebug（可选）
• zip

使用方法

基本运行

不带命令运行时，将启动nginx（监听80端口）、fpm（监听9000端口）等服务：

bash
docker run -p80:80 aheadworks/phpdev:7.2 
Starting crond...
Starting nginx & fpm...
[20-Dec-2018 08:44:20] NOTICE: fpm is running, pid 10
[20-Dec-2018 08:44:20] NOTICE: ready to handle connections

带命令运行时，参数将直接传递给shell：

bash
docker run aheadworks/phpdev:7.2 uname -a
Linux b89a1a21b62d 4.9.125-linuxkit #1 SMP Fri Sep 7 08:20:28 UTC 2018 x86_64 Linux

在Windows/Mac上运行XDebug

由于Mac/Windows平台下的路由非透明问题，需将XDEBUG_REMOTE_CONNECT_BACK设置为0。这将强制XDebug连接回host.docker.internal（主机的通用别名）。