{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

{{< /details >}}

本指南涵盖了 PHP 项目的基本构建说明。

涵盖了两种测试场景:使用 Docker executor 和使用 Shell executor。

使用 Docker executor 测试 PHP 项目

虽然可以在任何系统上测试 PHP 应用程序,但这需要开发人员手动配置。为了解决这个问题,我们使用官方的 PHP Docker 镜像,可以在 Docker Hub 上找到。

这使我们能够针对不同版本的 PHP 测试 PHP 项目。然而,并不是所有的东西都是即插即用的,您仍然需要手动配置一些内容。

与每个任务一样,您需要创建一个有效的 .gitlab-ci.yml 来描述构建环境。

首先指定用于任务处理的 PHP 镜像。(您可以通过阅读关于 使用 Docker 镜像 的内容了解镜像的含义。)

首先将镜像添加到您的 .gitlab-ci.yml 中:

image: php:5.6

官方镜像很棒,但缺少一些有用的测试工具。我们需要首先准备构建环境。解决这个问题的一种方法是创建一个脚本,在实际测试之前安装所有必要条件。

让我们在我们存储库的根目录中创建一个 ci/docker_install.sh 文件,内容如下:

#!/bin/bash

# We need to install dependencies only for Docker
[[ ! -e /.dockerenv ]] && exit 0

set -xe

# Install git (the php image doesn't have it) which is required by composer
apt-get update -yqq
apt-get install git -yqq

# Install phpunit, the tool that we will use for testing
curl --location --output /usr/local/bin/phpunit "https://phar.phpunit.de/phpunit.phar"
chmod +x /usr/local/bin/phpunit

# Install mysql driver
# Here you can install any other extension that you need
docker-php-ext-install pdo_mysql

您可能想知道 docker-php-ext-install 是什么。简而言之,它是由官方 PHP Docker 镜像提供的脚本,您可以用它轻松安装扩展。

现在我们创建了包含构建环境所有先决条件的脚本,让我们将其添加到 .gitlab-ci.yml 中:

before_script:
  - bash ci/docker_install.sh > /dev/null

最后一步,使用 phpunit 运行实际测试:

test:app:
  script:
    - phpunit --configuration phpunit_myapp.xml

最后,提交您的文件并推送到极狐 GitLab 以查看您的构建是否成功(或失败)。

最终的 .gitlab-ci.yml 应类似于以下内容:

default:
  # Select image from https://hub.docker.com/_/php
  image: php:5.6
  before_script:
    # Install dependencies
    - bash ci/docker_install.sh > /dev/null

test:app:
  script:
    - phpunit --configuration phpunit_myapp.xml

在 Docker 构建中针对不同的 PHP 版本进行测试

针对多个 PHP 版本进行测试非常简单。只需添加另一个具有不同 Docker 镜像版本的任务,runner 会完成其余的工作:

default:
  before_script:
    # Install dependencies
    - bash ci/docker_install.sh > /dev/null

# We test PHP5.6
test:5.6:
  image: php:5.6
  script:
    - phpunit --configuration phpunit_myapp.xml

# We test PHP7.0 (good luck with that)
test:7.0:
  image: php:7.0
  script:
    - phpunit --configuration phpunit_myapp.xml

在 Docker 构建中自定义 PHP 配置

有时,您需要通过将 .ini 文件放入 /usr/local/etc/php/conf.d/ 来自定义 PHP 环境。为此添加一个 before_script 操作:

before_script:
  - cp my_php.ini /usr/local/etc/php/conf.d/test.ini

当然,my_php.ini 必须存在于您的存储库的根目录中。

使用 Shell executor 测试 PHP 项目

shell executor 在您的服务器上的终端会话中运行您的任务。要测试您的项目,您必须首先确保所有依赖项都已安装。

例如,在运行 Debian 8 的虚拟机中,首先更新缓存,然后安装 phpunitphp5-mysql

sudo apt-get update -y
sudo apt-get install -y phpunit php5-mysql

接下来,将以下代码片段添加到您的 .gitlab-ci.yml 中:

test:app:
  script:
    - phpunit --configuration phpunit_myapp.xml

最后,推送到极狐 GitLab 并让测试开始!

在 Shell 构建中针对不同的 PHP 版本进行测试

phpenv 项目允许您管理不同版本的 PHP,每个版本都有自己的配置。这在使用 Shell executor 测试 PHP 项目时特别有用。

使用 phpenv 还允许您通过以下方式配置 PHP 环境:

phpenv config-add my_config.ini

重要提示: 似乎 phpenv/phpenv 已被废弃。有一个分支 madumlao/phpenv 尝试将项目复活。CHH/phpenv 似乎也是一个不错的选择。选择任何提到的工具都可以使用基本的 phpenv 命令。指导您选择正确的 phpenv 超出了本教程的范围。*

安装自定义扩展

由于这是 PHP 环境的一个相当基础的安装,您可能需要一些当前构建机器上没有的扩展。

要安装其他扩展,请执行:

pecl install <extension>

不建议将此添加到 .gitlab-ci.yml 中。您应该只执行一次此命令,以设置构建环境。

扩展您的测试

使用 atoum

除了 PHPUnit,您可以使用任何其他工具来运行单元测试。例如,您可以使用 atoum

test:atoum:
  before_script:
    - wget http://downloads.atoum.org/nightly/mageekguy.atoum.phar
  script:
    - php mageekguy.atoum.phar

使用 Composer

大多数 PHP 项目使用 Composer 来管理他们的 PHP 软件包。要在运行测试之前执行 Composer,请将以下内容添加到您的 .gitlab-ci.yml 中:

# Composer stores all downloaded packages in the vendor/ directory.
# Do not use the following if the vendor/ directory is committed to
# your git repository.
default:
  cache:
    paths:
      - vendor/
  before_script:
    # Install composer dependencies
    - wget https://composer.github.io/installer.sig -O - -q | tr -d '\n' > installer.sig
    - php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
    - php -r "if (hash_file('SHA384', 'composer-setup.php') === file_get_contents('installer.sig')) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
    - php composer-setup.php
    - php -r "unlink('composer-setup.php'); unlink('installer.sig');"
    - php composer.phar install

访问私有软件包或依赖项

如果您的测试套件需要访问私有存储库,您需要配置 SSH 密钥 以便能够克隆它。

使用数据库或其他服务

大多数时候,您需要一个正在运行的数据库才能运行测试。如果您使用的是 Docker executor,您可以利用 Docker 链接到其他容器。使用极狐 GitLab Runner,这可以通过定义一个 service 来实现。

此功能在CI 服务文档中有介绍。