artfocus/phpdocker

phpdocker/phpdocker 镜像文档

概述

phpdocker/phpdocker 是一个基于官方PHP镜像构建的自定义Docker镜像，主要设计用于持续集成（CI）场景，也可灵活用于其他开发需求。该镜像集成了PHP开发所需的多种工具和服务，旨在简化PHP项目的构建、测试和部署流程。

核心功能与特性

多版本PHP支持

• 基于官方PHP镜像构建，提供多个PHP版本，包括5.6、7.0、8.0、8.2、8.3等
• 内置常用PHP扩展：XDebug（默认不启用）、SSH2、Redis、APCu、Memcached

丰富的内置工具与服务

• 版本控制：Git
• JavaScript生态：NodeJS及相关工具（Yarn、Grunt、Gulp、Bower）
• 数据库服务：MariaDB、Redis
• PHP开发工具：Composer（全局安装）、PHP_CodeSniffer（全局安装）、PHPUnit（全局安装）

实用Bash脚本

• 内置check-status-code脚本，用于检查HTTP请求的状态码

使用场景

• PHP项目的持续集成流程（如代码检查、单元测试、集成测试）
• PHP项目的自动化构建与部署
• 本地PHP开发环境的快速搭建

使用方法

镜像获取

镜像托管于Docker Hub，可直接通过以下命令拉取：

bash
docker pull docker.xuanyuan.run/phpdocker/phpdocker:[TAG]

标签说明

镜像标签基于包含的PHP版本，可在https://hub.docker.com/r/phpdocker/phpdocker/tags/%E6%9F%A5%E7%9C%8B%E6%89%80%E6%9C%89%E5%8F%AF%E7%94%A8%E6%A0%87%E7%AD%BE%E3%80%82%E4%B8%BB%E8%A6%81%E6%A0%87%E7%AD%BE%E5%AF%B9%E5%BA%94%E5%85%B3%E7%B3%BB%EF%BC%9A

• PHP 5.6: phpdocker/phpdocker:5.6
• PHP 7.0: phpdocker/phpdocker:7.0
• PHP 8.0: phpdocker/phpdocker:8.0
• PHP 8.2: phpdocker/phpdocker:8.2bw
• PHP 8.3: phpdocker/phpdocker:8.3

内置应用使用指南

PHP

• PHP服务自动启动，可直接执行PHP命令：

  bash
  php -r "echo 'Hello World';"
  

• XDebug使用：默认不启用，可通过以下方式启用：

  bash
  # 方式1: 使用-d参数
  php -d$XDEBUG_EXT vendor/bin/phpunit
  
  # 方式2: 使用php_xdebug命令
  php_xdebug vendor/bin/phpunit
  

MariaDB

• 启动服务：需手动启动

  bash
  service mysql start
  

• 使用示例：

  bash
  # 创建数据库
  mysql -e 'create database test;'
  
  # 连接数据库（默认用户root，无密码）
  mysql -u root
  

Redis

• 启动服务：需手动启动

  bash
  service redis-server start
  

• 使用示例：

  bash
  redis-cli ping  # 测试连接，返回PONG表示成功
  

Composer

• 已全局安装，直接使用composer命令：

  bash
  composer self-update  # 更新Composer
  composer install      # 安装项目依赖
  

PHP_CodeSniffer

• 已全局安装，直接使用phpcs命令：

  bash
  # 检查代码规范（PSR2标准）
  phpcs --standard=PSR2 -nsp src tests
  

PHPUnit

• 已全局安装，直接使用phpunit命令：

  bash
  # 执行测试并生成报告
  phpunit --log-junit shippable/testresults/junit.xml --coverage-xml shippable/codecoverage -c tests/configuration.xml tests
  

内置Bash脚本

check-status-code

• 功能：发送HTTP请求并检查返回状态码
• 用法：

  bash
  # 检查状态码是否为200（默认）
  URL="https://www.example.com" check-status-code
  
  # 检查状态码是否为403
  URL="https://www.example.com" STATUS=403 check-status-code
  

• 返回值：状态码不符合预期时返回非零退出码

使用示例

可作为CI环境的自定义容器，例如Shippable CI的配置（参考https://bitbucket.org/hranicka/composer-sandbox/src/master/shippable.yml?at=master&fileviewer=file-view-default%EF%BC%89%E3%80%82