chialab/php-dev

Docker PHP 开发镜像文档

镜像概述和主要用途

本镜像基于 https://hub.docker.com/r/_/php/ 构建，通过 https://github.com/mlocati/docker-php-extension-installer 添加了常用扩展，专门用于PHP 应用的开发调试环境。镜像托管于 https://hub.docker.com/r/chialab/php-dev/%EF%BC%8C%E9%80%9A%E8%BF%87%E8%87%AA%E5%8A%A8%E5%8C%96%E6%9E%84%E5%BB%BA%E6%9C%BA%E5%88%B6%E4%BF%9D%E6%8C%81%E6%9B%B4%E6%96%B0%EF%BC%8C%E7%A1%AE%E4%BF%9D%E5%8C%85%E5%90%AB%E5%AE%98%E6%96%B9 PHP 镜像的最新安全补丁。

注意：本镜像仅用于开发调试，生产环境建议使用 https://hub.docker.com/r/chialab/php/%E3%80%82

核心功能和特性

扩展支持

在官方 PHP 镜像基础上，额外预装以下扩展（按 PHP 版本兼容情况标注）：

• bcmath
• bz2
• calendar
• exif
• gd
• iconv
• intl
• ldap
• mbstring
• mcrypt（仅支持 PHP ≤ 7.1）
• memcached
• mysql（仅支持 PHP 5.x）
• mysqli
• pdo_mysql
• pdo_pgsql
• pgsql
• redis
• soap
• sockets
• xdebug（调试工具，需手动配置）
• xsl
• Zend OPcache
• zip

开发工具

• Composer：全局安装，用于 PHP 依赖管理，具体使用参见 Composer 官方文档。
• Prestissimo：全局安装的 Composer 插件，通过并行配置依赖安装过程。

使用场景和适用范围

适用于需要快速搭建 PHP 开发环境的场景，尤其适合：

• PHP 应用的本地开发和调试
• 需要多版本 PHP 环境（5.6~8.0）的开发场景
• 需预安装多种常用扩展的开发环境（避免手动配置扩展的繁琐）

不建议用于生产环境，生产环境请选择精简版镜像以减少***面。

详细使用方法和配置说明

可用标签

所有标签基于对应版本的官方 PHP 镜像构建，支持以下标签：

• latest（默认最新版本）
• 5.6、5.6-apache、5.6-fpm
• 7.0、7.0-apache、7.0-fpm
• 7.1、7.1-apache、7.1-fpm
• 7.2、7.2-apache、7.2-fpm
• 7.3、7.3-apache、7.3-fpm
• 7.4、7.4-apache、7.4-fpm
• 8.0、8.0-apache、8.0-fpm

基础使用示例

1. 直接运行（Docker Run）

以 PHP 8.0 Apache 版本为例，启动开发服务：

bash
docker run -d -p 80:80 -v $(pwd):/var/www/html chialab/php-dev:8.0-apache

• -v $(pwd):/var/www/html：将当前目录挂载到容器内 Apache 网站根目录
• -p 80:80：映射容器 80 端口到主机 80 端口

2. Docker Compose 配置

创建 docker-compose.yml：

yaml
version: '3'
services:
  php-dev:
    image: chialab/php-dev:8.0-apache
    ports:
      - "80:80"
    volumes:
      - ./src:/var/www/html  # 本地代码目录挂载
    environment:
      - PHP_INI_SCAN_DIR=/usr/local/etc/php/conf.d  # PHP 配置扫描目录

启动服务：

bash
docker-compose up -d

配置 XDebug

XDebug 已预装但未默认配置，需通过 Apache 或 Nginx 配置启用远程调试等功能。

Apache 环境

在目标目录的 Apache 配置中添加 php_value 参数：

apache
# 例如在 .htaccess 或虚拟主机配置中
php_value xdebug.remote_enable 1          # 启用远程调试
php_value xdebug.remote_host 192.168.99.1  # 主机 IP（根据实际网络调整）
php_value xdebug.remote_port 9003         # 调试端口（默认 9003）

Nginx + FPM 环境

在 Nginx 配置中通过 fastcgi_param 传递 PHP 配置：

nginx
location ~ \.php$ {
    fastcgi_pass php-dev:9000;  # 指向 FPM 服务（需与容器名匹配）
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    # XDebug 配置
    fastcgi_param PHP_VALUE "xdebug.remote_enable=1\nxdebug.remote_host=192.168.99.1\nxdebug.remote_port=9003";
    include fastcgi_params;
}

自定义镜像

若无需部分预装扩展，建议克隆 https://github.com/chialab/docker-php%EF%BC%8C%E4%BF%AE%E6%94%B9 Dockerfile 移除不需要的扩展后重新构建：

bash
git clone https://github.com/chialab/docker-php.git
cd docker-php
# 编辑 Dockerfile，移除不需要的扩展安装命令
docker build -t my-php-dev .

贡献指南

• 发现问题或需求请 https://github.com/Chialab/docker-php/issues%EF%BC%8C%E5%B9%B6%E6%8F%90%E4%BE%9B%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%E3%80%82
• 欢迎提交 Pull Request，提交前需运行 make build 和 make test，并遵循 Dockerfile 最佳实践。

许可证

本项目基于 https://github.com/chialab/docker-php/blob/master/LICENSE 开源。