docphpro/php

docphpro/php镜像说明

镜像概述

本Docker镜像基于PHP构建，集成了composer包管理工具、php-fpm进程管理器和xdebug调试工具，预配置了开发常用的php.ini参数、opcache优化设置及xdebug调试环境，帮助开发者快速搭建稳定高效的PHP应用开发与运行环境。

核心功能

1. 依赖管理：集成composer，支持PHP项目的依赖安装与更新；
2. 进程管理：包含php-fpm，提供多进程管理能力，优化PHP应用性能；
3. 代码调试：内置xdebug工具，支持远程调试PHP代码；
4. 预配置环境：提供php.ini开发标准配置、opcache性能优化配置及xdebug调试参数，减少手动配置成本。

使用场景

• 本地PHP应用开发与调试；
• Docker化PHP项目的构建与部署；
• 需要xdebug调试功能的开发环境搭建；
• 快速验证PHP代码运行效果的测试场景。

配置说明

php-fpm配置

路径：/usr/local/etc/php-fpm.d/www.conf，主要配置包括用户组、监听端口、进程管理策略等，示例如下：

ini
[www]
user = root
group = root
listen = [::]:9000
listen.owner = root
listen.group = root
pm = dynamic
pm.max_children = 50
pm.start_servers = 25
pm.min_spare_servers = 25
pm.max_spare_servers = 35
pm.max_requests = 500

php.ini开发标准配置

包含内存限制、错误日志、文件上传等常用参数，如max_execution_time=300、upload_max_filesize=250M等。

配置覆盖示例

路径：/usr/local/etc/php/conf.d/00_php-ini-overrides.ini，可通过挂载该文件覆盖默认配置，示例：

ini
sendmail_path = /usr/sbin/sendmail -S phpro-mailhog:1025
session.save_path = /var/lib/php/sessions
session.save_handler = redis
session.save_path = "tcp://phpro-redis:6379?auth=yourverycomplexpasswordhere"

opcache配置

路径：/usr/local/etc/php/conf.d/00_php-opcache.ini，优化PHP代码缓存，示例：

ini
opcache.enable = 1
opcache.enable_cli = 0
opcache.max_accelerated_files = 100000
opcache.memory_consumption = 192
opcache.interned_strings_buffer = 16
opcache.validate_timestamps = 0

xdebug配置

路径：/usr/local/etc/php/conf.d/90-xdebug.ini，支持远程调试，可通过环境变量调整，示例：

ini
zend_extension="xdebug.so"
xdebug.mode=off
xdebug.start_with_request=trigger
xdebug.discover_client_host=yes
xdebug.client_host=host.docker.internal
xdebug.client_port=9003
xdebug.remote_handler=dbgp

环境变量：

• XDEBUG_SESSION: 设置调试会话标识（如XDEBUG_PHPSTORM）；
• XDEBUG_MODE: 设置调试模式（如debug）。

调试启动方式：

• 自动启动：设置xdebug.start_with_request=yes；
• 请求中启动：调用xdebug_break()（需xdebug.start_with_request=trigger）；
• 错误触发：设置xdebug.start_upon_error=yes，在Notice/Warning或Throwable时启动调试。

部署示例

Docker Run命令

bash
docker run -d -p 9000:9000 docphpro/php

Docker Compose配置（Linux环境）

yaml
version: '3'
services:
  php:
    image: docphpro/php
    ports:
      - "9000:9000"
    extra_hosts:
      - "host.docker.internal:host-gateway" # Linux下解决xdebug连接宿主问题
    volumes:
      - ./php-overrides.ini:/usr/local/etc/php/conf.d/00_php-ini-overrides.ini # 挂载自定义配置