virtuasa/php-dev

Docker Image - PHP DEV

镜像概述和主要用途

PHP开发专用Docker镜像，支持PHP 5.3-8.3版本和NodeJS 18/20/22版本，提供CLI、FPM、NGINX和Apache等多种运行环境，集成了开发所需的各种工具和扩展，旨在为PHP应用开发提供一致、便捷的开发环境。

镜像仓库信息

• Docker Hub: https://hub.docker.com/r/virtuasa/php-dev
• Smile Registry: registry.smile.fr/smile-suisse/

  可将镜像标签中的"virtuasa/"替换为"registry.smile.fr/smile-suisse/"以使用Smile仓库

镜像类型和标签说明

基础镜像

virtuasa/php-dev:bookworm-sury

基于Debian的基础镜像，包含基础工具。

PHP镜像

标签格式: virtuasa/php-dev:${PHP_VERSION}-${TYPE}-bookworm-sury

支持的PHP版本: 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3

CLI镜像

用于PHP命令行环境

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-cli-bookworm-sury
• 示例: virtuasa/php-dev:8.3-cli-bookworm-sury

FPM镜像

包含PHP CLI和FPM服务

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-fpm-bookworm-sury
• 示例: virtuasa/php-dev:8.3-fpm-bookworm-sury

NGINX镜像

包含PHP CLI和NGINX网站服务

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-nginx-bookworm-sury
• 示例: virtuasa/php-dev:8.3-nginx-bookworm-sury

Apache镜像

包含PHP CLI和Apache网站服务

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-apache-bookworm-sury
• 示例: virtuasa/php-dev:8.3-apache-bookworm-sury

带NodeJS的PHP镜像

标签格式: virtuasa/php-dev:${PHP_VERSION}-${TYPE}-node-${NODE_VERSION}-bookworm-sury

支持的NodeJS版本: 18, 20, 22

CLI镜像(带NodeJS)

用于PHP命令行环境，包含NodeJS工具

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-cli-node-${NODE_VERSION}-bookworm-sury
• 示例: virtuasa/php-dev:8.3-cli-node-22-bookworm-sury

FPM镜像(带NodeJS)

包含PHP CLI、FPM服务和NodeJS工具

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-fpm-node-${NODE_VERSION}-bookworm-sury
• 示例: virtuasa/php-dev:8.3-fpm-node-22-bookworm-sury

NGINX镜像(带NodeJS)

包含PHP CLI、NGINX网站服务和NodeJS工具

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-nginx-node-${NODE_VERSION}-bookworm-sury
• 示例: virtuasa/php-dev:8.3-nginx-node-22-bookworm-sury

Apache镜像(带NodeJS)

包含PHP CLI、Apache网站服务和NodeJS工具

• 标签模板: virtuasa/php-dev:${PHP_VERSION}-apache-node-${NODE_VERSION}-bookworm-sury
• 示例: virtuasa/php-dev:8.3-apache-node-22-bookworm-sury

核心功能和特性

预装组件和工具

开发辅助功能

• 内置XDebug支持，方便代码调试
• Blackfire集成，支持性能分析
• 多种PHP版本支持，便于多版本兼容性测试
• 集成NodeJS环境，适合现代PHP应用开发
• 灵活的环境变量配置，适应不同开发需求

使用场景和适用范围

适用场景

• PHP应用程序开发环境
• 多版本PHP兼容性测试
• Web应用本地开发和调试
• CI/CD流程中的自动化测试
• 需要NodeJS工具链的PHP项目(如前端资源构建)

不适用场景

• 生产环境部署(该镜像针对开发优化，非生产环境安全和性能优化)
• 需要极端资源限制的环境

使用方法和配置说明

基础使用方法

使用Docker Run运行

bash
# PHP CLI示例
docker run --rm -v $(pwd):/data virtuasa/php-dev:8.3-cli-bookworm-sury php -v

# Apache示例
docker run -d -p 8080:80 -v $(pwd):/data virtuasa/php-dev:8.3-apache-bookworm-sury

Docker Compose示例

yaml
version: '3.9'

services:
  web:
    image: virtuasa/php-dev:8.3-nginx-node-22-bookworm-sury
    user: ${FIXUID:-1000}:${FIXGID:-1000}
    volumes:
      - .:/data
    ports:
      - "8080:80"
      - "443:443"
    environment:
      - HISTFILE=/data/var/.docker_bash_history
      - HISTFILESIZE=1000
      - DOCUMENT_ROOT=public
      - SSL_FORCE=yes
      - SERVER_NAMES=app.docker.local
      - XDEBUG_CLIENT_HOST=host.docker.internal
    extra_hosts:
      - 'host.docker.internal:host-gateway'

环境变量配置

基础镜像变量

PHP镜像变量

PHP Apache变量

PHP Nginx变量

注意:

• 带*的路径是相对于Docker容器挂载路径，即项目根目录
• 带**的路径是Docker容器内的绝对路径，如果需要，不要忘记添加/data挂载路径

FIXUID和FIXGID设置

如果主机Linux用户ID不是1000（可通过id命令检查），请将全局变量设置为您的会话ID：

bash
printf "FIXUID=`id -u`\nFIXGID=`id -g`" >> ~/.profile

使用docker-compose文件时，为容器设置user参数：

yaml
user: ${FIXUID:-1000}:${FIXGID:-1000}

Blackfire.io性能分析

要使用Blackfire.io分析PHP脚本，需要在官网创建个人账户。

在计算机上定义以下环境变量，从blackfire.io设置/凭据获取值：

bash
BLACKFIRE_CLIENT_ID="<Client ID>"
BLACKFIRE_CLIENT_TOKEN="<Client Token>"
BLACKFIRE_SERVER_ID="<Server ID>"
BLACKFIRE_SERVER_TOKEN="<Server Token>"

可将这些值放入~/.profile文件中，以便计算机重启后保留这些信息。无需重启计算机，只需导出变量并执行docker up。

分析方法：

• Google Chrome
• Firefox
• PHP CLI：在docker内使用blackfire run <php命令>

特殊工具命令

PHP镜像工具

构建镜像

使用make help查看构建目标。

示例：

• make all 构建所有镜像
• make all-php 构建所有PHP镜像
• make base php-8.3 php-8.3-node-18 构建特定版本镜像