napp/php-ci

Napp PHP CI Docker镜像

本仓库包含一套用于通过Gitlab CI运行PHP测试的工具集合。

支持的标签及对应Dockerfile链接

• https://github.com/Napp/php-ci/blob/master/php/7.0/Dockerfile
• https://github.com/Napp/php-ci/blob/master/php/7.1/Dockerfile

镜像未设置VOLUME目录，因为每次运行测试前会重新下载最新源码。

核心功能

基于https://registry.hub.docker.com/_/php/%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%A2%9D%E5%A4%96%E5%8C%85%E5%90%AB%EF%BC%9A

• 所有扩展已编译，可通过docker-php-ext-enable加载
• PECL扩展：memcache、redis、mongo、xdebug
• 通过msmtprc配置的sendmail命令（默认中继到localhost，可修改/etc/msmtprc设置中继服务器）
• Debian官方仓库的Git客户端
• Composer、PHPUnit、PHP Code Sniffer、PHP Mess Detector
• Node.js v6（来自Node.js Debian官方仓库）
• mysql客户端（用于数据库操作）

PHP模块说明

部分模块默认启用（编译内置），部分需在.gitlab-ci.yml的before_script中通过docker-php-ext-enable启用：

编译内置模块

ctype curl date dom ereg fileinfo filter hash iconv json libxml mysqlnd openssl pcre pdo pdo_sqlite phar posix readline recode reflection session simplexml spl sqlite3 standard tokenizer xml xmlreader xmlwriter zlib

可用核心模块

bcmath bz2 calendar dba enchant exif ftp gd gettext gmp imap intl ldap mbstring mcrypt mssql mysql mysqli opcache pcntl pdo pdo_dblib pdo_mysql pdo_pgsql pgsql pspell shmop snmp soap sockets sysvmsg sysvsem sysvshm tidy wddx xmlrpc xsl zip

可用PECL模块

memcache memcached mongo mongodb redis xdebug

配置说明

环境变量

运行镜像时可传递以下变量：

• WITH_XDEBUG=1：启用xdebug扩展
• TIMEZONE=America/New_York：设置系统和php.ini时区（也可在.gitlab-ci.yml中配置）
• COMPOSER_GITHUB=<YOUR_GITHUB_TOKEN>：添加Github OAuth令牌，避免Composer因API速率限制被阻止（令牌获取地址：https://github.com/settings/tokens%EF%BC%89

自定义php.ini

• 方式1：将指令添加到/usr/local/etc/php/conf.d/[任意名称].ini
• 方式2：容器启动时挂载本地文件：docker run ... -v /home/user/php.ini:/usr/local/php/etc/php.ini ...

使用场景

适用于Gitlab CI环境下的PHP项目自动化测试，支持多版本PHP（7.0/7.1）的单元测试、代码检查等流程。

示例配置

yaml
stages:
  - test

before_script:
  # 启用PHP扩展
  - docker-php-ext-enable zip soap gd pdo_mysql mysqli
  # Composer操作
  - composer self-update
  - composer install --no-progress --no-interaction

variables:
  WITH_XDEBUG: "1"
  MYSQL_ROOT_PASSWORD: mysql
  MYSQL_DATABASE: mydb
  MYSQL_USER: myuser
  MYSQL_PASSWORD: somepassword
  COMPOSER_HOME: /cache/composer
  REDIS_PORT: "6379"

test_php70:
  image: napp/php-ci:7.0
  stage: test
  script:
    - phpunit --testsuite=unit

test_php71:
  image: napp/php-ci:7.1
  stage: test
  script:
    - phpunit --testsuite=unit