koenhendriks/phpdocker

koenhendriks/phpdocker 镜像文档

镜像概述

koenhendriks/phpdocker 是一个预配置的Docker镜像，主要设计用于CI（持续集成）环境，也可根据需求灵活使用。镜像集成了多种PHP开发工具和运行环境，方便PHP项目的测试、构建与代码质量检查。镜像可在 https://hub.docker.com/r/koenhendriks/phpdocker/ 获取。

核心功能与特性

内置应用

• GIT：版本控制工具，用于代码拉取与管理。
• PHP：基于官方 https://registry.hub.docker.com/_/php/%EF%BC%8C%E6%AF%8F%E4%B8%AA%E9%95%9C%E5%83%8F%E4%BB%85%E5%8C%85%E5%90%AB%E4%B8%80%E4%B8%AAPHP%E7%89%88%E6%9C%AC%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%A7%8D%E7%89%88%E6%9C%AC%EF%BC%88%E5%A6%827.0%E3%80%817.1%E3%80%817.2%E3%80%817.3%E3%80%817.4%E7%AD%89%EF%BC%89%E3%80%82
  • XDebug：PHP调试工具，默认不启用（避免影响性能，如Composer运行）。启用方式：php -d$XDEBUG_EXT [命令] 或 php_xdebug [命令]。
• NodeJS：JavaScript运行环境，包含包管理工具 Yarn。
• Composer：PHP依赖管理工具，已全局安装，可直接运行 composer 命令。
• PHP_CodeSniffer：PHP代码规范检查工具，全局安装，可通过 phpcs 命令使用。
• PHPUnit：PHP单元测试框架，全局安装，可直接运行 phpunit 命令。

使用场景

• CI环境中多版本PHP单元测试（如Gitlab CI、Jenkins等）。
• 代码质量检查（通过PHP_CodeSniffer）。
• 生成代码覆盖率报告（结合XDebug和PHPUnit）。
• PHP项目的本地开发与测试（快速搭建包含全套工具的环境）。

使用方法

标签说明

镜像标签基于包含的PHP版本，通过Git分支管理。可在 https://hub.docker.com/r/koenhendriks/phpdocker/tags/ 查看所有可用标签。例如：

• koenhendriks/phpdocker:7.2：包含PHP 7.2的镜像
• koenhendriks/phpdocker:7.4：包含PHP 7.4的镜像

Gitlab CI配置示例

多版本PHP单元测试

yml
phpunit_72:
  image: docker.xuanyuan.run/koenhendriks/phpdocker:7.2
  stage: test
  script:
    - php ./vendor/bin/phpunit --colors=never -c phpunit-runner.xml

phpunit_73:
  image: docker.xuanyuan.run/koenhendriks/phpdocker:7.3
  stage: test
  script:
    - php ./vendor/bin/phpunit --colors=never -c phpunit-runner.xml

带XDebug覆盖率的测试

yml
phpunit74:
  image: docker.xuanyuan.run/koenhendriks/phpdocker:7.4
  stage: test
  script:
    - php -d$XDEBUG_EXT ./vendor/bin/phpunit --coverage-text --colors=never --coverage-clover ./coverage/phpunit.coverage.xml --log-junit ./coverage/phpunit.report.xml
  artifacts:
    expire_in: 1 week
    reports:
      junit: ./coverage/phpunit.report.xml
    paths:
      - ./coverage/
  only:
    - master
    - tags

基本使用命令

• 直接运行PHP命令：

  bash
  docker run --rm docker.xuanyuan.run/koenhendriks/phpdocker:7.4 php -r "echo 'Hello PHP';"
  

• 使用Composer安装依赖：

  bash
  docker run --rm -v $(pwd):/app docker.xuanyuan.run/koenhendriks/phpdocker:7.4 composer install
  

• 运行PHP_CodeSniffer检查代码规范：

  bash
  docker run --rm -v $(pwd):/app docker.xuanyuan.run/koenhendriks/phpdocker:7.4 phpcs --standard=PSR2 -nsp src tests
  

• 启用XDebug运行PHPUnit：

  bash
  docker run --rm -v $(pwd):/app docker.xuanyuan.run/koenhendriks/phpdocker:7.4 php_xdebug vendor/***/phpunit --coverage-text