PHP と Bitbucket Pipelines
このガイドでは、Bitbucket Pipelines を使用して、Docker コンテナで PHP を使用するソフトウェア プロジェクトをビルドおよびテストする方法について説明します。
このデモではこのリポジトリをインポートし、最初のパイプラインを実行するためにパイプラインを有効化します。
bitbucket.org にアクセスしてログインし、このリポジトリをインポートします。その後、次の操作を行います。
プラス記号をクリックします。
[インポート] から、[リポジトリ] を選択します。
次の URL を貼り付けます: https://bitbucket.org/bitbucketpipelines/pipelines-guide-php/src/master/
インポートしたリポジトリに名前を付けます。
左側のナビゲーション バーで [Pipelines] をクリックし、下にスクロールして bitbucket-pipelines.yml ファイルを表示します。[有効化] をクリックします。
ビルドが実行されるのを確認します。
注意: Bitbucket Pipelines には、アカウントごとに 50 分の無料利用時間が含まれています (本記事の執筆時点での情報)。自身のアバター > [Bitbucket 設定] > [プランの詳細] で、その月のチームまたはアカウントの時間の使用量を、分単位で確認できます。
手動でセットアップしたい場合、構成の大部分は Pipelines がビルドを定義するために使用する bitbucket-pipelines.yml ファイル内で行います。
Docker で PHP のバージョンを指定する
Bitbucket Pipelines は、構成ファイルの最初に指定したイメージを使用し、すべてのビルドを Docker コンテナで実行します。Docker Hub にあるいずれかの公式 PHP Docker イメージを使用することで、Bitbucket Pipelines で簡単に PHP を使用できます。
たとえば、次のように bitbucket-pipelines.yml ファイルの先頭でイメージを指定して PHP 7.1.1 を使用できます。
image: php:7.1.1
pipelines:
default:
- step:
script:
- php -v異なるバージョンの PHP を使用したい場合、Docker イメージのタグを変更します。次の例は、PHP 5.6.30 のコンテナを開始します。
image: php:5.6.30サポートされている全 PHP バージョンと対応するイメージ タグの一覧については、https://hub.docker.com/_/php/ を参照してください。
アトラシアンのオンライン バリデーターでご使用の bitbucket-pipelines.yml ファイルをチェックできます。
依存関係をインストールする
Composer を使用して依存関係を管理する
ビルド スクリプトの一環として Composer をインストールおよび使用できます。
例えば、次の手順をコピーして bitbucket-pipelines.yml ファイルに貼り付けると、依存関係として monolog が指定されます。
image: php:7.1.1
pipelines:
default:
- step:
script:
- apt-get update && apt-get install -y unzip
- curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
- composer require monolog/monolog
- composer installPear を使用して依存関係を管理する
Pear は PHP Docker イメージにバンドルされており、次のようにビルド スクリプトで直接使用して依存関係をインストールできます。
image: php:7.1.1
pipelines:
default:
- step:
script:
- pear -V
- pear install pear/PHP_CodeSnifferPHP 拡張機能のインストールと有効化
PHP Docker イメージ には拡張機能のインストールと構成を容易にする次の 3 つのヘルパー スクリプト コマンドが付属しています。
docker-php-ext-configure: このコマンドにより、エクステンションのカスタム引数の指定が可能になります。docker-php-ext-install: このコマンドを使用してコンテナに新しいエクステンションをインストールします。docker-php-ext-enable: このコマンドを使用して PHP エクステンションを有効化します。
たとえば、ビルド プロセスの一部として gd エクステンションをインストールする場合、bitbucket-pipelines.yml を次のように構成します。
image: php:7.1.1
pipelines:
default:
- step:
script:
# Installing first the libraries necessary to configure and install gd
- apt-get update && apt-get install -y libfreetype6-dev libjpeg62-turbo-dev libpng12-dev
# Now we can configure and install the extension
- docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/
- docker-php-ext-install -j$(nproc) gdPECL および docker-php-ext-enable ヘルパー スクリプトを使用してエクステンションをインストールすることもできます。
image: php:7.1.1
pipelines:
default:
- step:
script:
# Installing first the libraries necessary to configure and install memcached
- apt-get update && apt-get install -y libmemcached-dev zlib1g-dev
# Now we can configure and install the extension
- pecl install memcached-2.2.0
- docker-php-ext-enable memcachedデータベース
Bitbucket Pipelines では、サービスを定義して適切な段階でインスタンス化することで、パイプラインの実行中に追加のサービスを起動できます。
ご使用のデータベースで使用する際に役立つように、bitbucket-pipeline.yml の例の一覧を用意しています。
テスト
PHPUnit でのテスト
Composer を使用して PHPUnit をインストールし、テストを実行できます。PHPUnit の依存関係がリポジトリにチェックインされたことを示す composer.json ファイルがある場合、composer install を実行してから phpunit コマンドを呼び出すだけでテストを実行できます。
image: php:7.1.1
pipelines:
default:
- step:
script:
- apt-get update && apt-get install -y unzip
- curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
- composer install
- vendor/bin/phpunitcomposer.json ファイルがない場合、ビルド スクリプトで PHPUnit を指定することによって、PHPUnit をインストールできます。
image: php:7.1.1
pipelines:
default:
- step:
script:
- apt-get update && apt-get install -y unzip
- curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
- composer require phpunit/phpunit
- vendor/bin/phpunitアトラシアンのオンライン バリデーターでご使用の bitbucket-pipelines.yml ファイルをチェックすることができます。