PHPUnitはPHP版のxUnit、すなわちユニットテスト自動化のためのフレームワーク。
さほどPHP暦が長くない自分はこれまでテストを書いてこなかったのだけど、現在携わっているプロジェクトの複雑さが増すにつれてテストの必要性を感じるようになった。そこで、ローカルのXAMPP環境にPHPUnitをインストールして、テストの書き方や実施方法などを学習してみようと思う。
以下インストールの覚書。
公式サイト
PHPUnit – The PHP Testing Framework
http://phpunit.de/
PHPUnit マニュアル
https://phpunit.de/manual/current/ja/index.html
インストール
PHPUnit マニュアル – 第1章 PHPUnit のインストール
https://phpunit.de/manual/current/ja/installation.html#installation.optional-packages
1. PHP バイナリ用のディレクトリを作ります(例:C:\bin)
2. ;C:\bin を、環境変数 PATH に追記します (参考資料)。
3. https://phar.phpunit.de/phpunit.phar をダウンロードして、 C:\bin\phpunit.phar に保存します。
4. コマンドプロンプトを開きます ( Windows+R » cmd » ENTER)。
5. 以下のようにして、バッチスクリプト (C:\bin\phpunit.cmd) を作ります。
1 2 3 |
C:\Users\username\> cd C:\bin C:\bin\> echo @php "%~dp0phpunit.phar" %* > phpunit.cmd C:\bin\> exit |
(僕の環境はphpのパスが通っていなかったのでphpをフルパスで指定するように変更)
6. コマンドプロンプトをもう一枚開き、どこからでも PHPUnit を実行できることを確認します。
1 2 |
C:\Users\username\> phpunit --version PHPUnit x.y.z by Sebastian Bergmann. |
試しにテスト
PHPUnit マニュアル – 第2章 PHPUnit 用のテストの書き方
https://phpunit.de/manual/current/ja/writing-tests-for-phpunit.html
テストコード StackTest.php
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
<?php class StackTest extends PHPUnit_Framework_TestCase { public function testPushAndPop() { $stack = array(); $this->assertEquals(0, count($stack)); array_push($stack, 'foo'); $this->assertEquals('foo', $stack[count($stack)-1]); $this->assertEquals(1, count($stack)); $this->assertEquals('foo', array_pop($stack)); $this->assertEquals(0, count($stack)); } } ?> |
実行する。
1 2 3 4 5 6 |
C:\xampp\htdocs\test\>phpunit StackTest PHPUnit 4.3.1 by Sebastian Bergmann. . Time: 31 ms, Memory: 3.75Mb OK (1 test, 5 assertions) C:\xampp\htdocs\test\> |
参考サイト
PHP開発者のためのテストのすゝめ(1):ユニットテストはなぜ必要なの? (1/2) – @IT
http://www.atmarkit.co.jp/ait/articles/0909/14/news103.html
PHP開発者のためのテストのすゝめ(2):PHPUnitでユニットテスト (1/3) – @IT
http://www.atmarkit.co.jp/ait/articles/0911/12/news105.html
PHPUnit3で始めるユニットテスト:特集|gihyo.jp … 技術評論社
http://gihyo.jp/dev/feature/01/php-test