Prev Next

第3章 PHPUnit のインストール

PHPUnit をインストールするには PEAR インストーラを使います。これは PHP Extension and Application Repository の根幹をなすものであり、 PHP のパッケージを配布する仕組みを提供しています。

注意

OS のディストリビューションや PHP の環境によっては、 ここで説明する手順を実行する前に まず PEAR をインストールしたり既存の PEAR をアップデートしたりする必要があるかもしれません。

既存の PEAR 環境のアップデートは、通常は sudo pear upgrade PEAR を実行するだけのことです。PEAR の新規インストール方法は PEAR マニュアル に説明があります。

注記

PHPUnit 3.6 は PHP 5.2.7 以降のバージョンで動作しますが、PHP 5.3.9 以降を使うことを強く推奨します。

PHPUnit では PHP_CodeCoverage というライブラリを使ってコードカバレッジ情報を処理していますが、 このライブラリを使うには Xdebug 2.0.5 以降が必要です。 しかし、Xdebug 2.1.3 以降を使うことを強く推奨します。

次のふたつのコマンドを実行するだけで (root として実行しなければならないかもしれません)、PHPUnit に必要なものがすべて PEAR インストーラを使ってインストールできます。

pear config-set auto_discover 1
pear install pear.phpunit.de/PHPUnit

オプションのパッケージとして、これらが使えます。

DbUnit

DbUnit の PHP/PHPUnit 向けの移植。データベースとのやりとりをテスト可能にする。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/DbUnit
PHPUnit_Selenium

PHPUnit 用の Selenium RC インテグレーション。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_Selenium
PHPUnit_Story

PHPUnit で振る舞い駆動開発をするための、ストーリーベースのテストランナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_Story
PHPUnit_TestListener_DBUS

イベントを DBUS に送信するテストリスナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_TestListener_DBUS
PHPUnit_TestListener_XHProf

XHProf を使ってテスト対象コードの自動プロファイリングを行うテストリスナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_TestListener_XHProf
PHPUnit_TicketListener_Fogbugz

Fogbugz issue API 用のチケットリスナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_TicketListener_Fogbugz
PHPUnit_TicketListener_GitHub

GitHub issue API 用のチケットリスナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_TicketListener_GitHub
PHPUnit_TicketListener_GoogleCode

Google Code issue API 用のチケットリスナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_TicketListener_GoogleCode
PHPUnit_TicketListener_Trac

Trac issue API 用のチケットリスナー。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHPUnit_TicketListener_Trac
PHP_Invoker

タイムアウト時に何かをコールするためのユーティリティクラス。 このパッケージは、strict モードでテストのタイムアウトを強制するために必要です。

このパッケージは、次のコマンドでインストールします。

pear install phpunit/PHP_Invoker

インストールすると、PHPUnit のソースファイルがローカルの PEAR ディレクトリに格納されます。場所は、通常は /usr/lib/php/PHPUnit です。

Prev Next
1. 自動テスト
2. PHPUnit の目標
3. PHPUnit のインストール
4. PHPUnit 用のテストの書き方
テストの依存性
データプロバイダ
例外のテスト
PHP のエラーのテスト
出力内容のテスト
アサーション
assertArrayHasKey()
assertClassHasAttribute()
assertClassHasStaticAttribute()
assertContains()
assertContainsOnly()
assertCount()
assertEmpty()
assertEqualXMLStructure()
assertEquals()
assertFalse()
assertFileEquals()
assertFileExists()
assertGreaterThan()
assertGreaterThanOrEqual()
assertInstanceOf()
assertInternalType()
assertLessThan()
assertLessThanOrEqual()
assertNull()
assertObjectHasAttribute()
assertRegExp()
assertStringMatchesFormat()
assertStringMatchesFormatFile()
assertSame()
assertSelectCount()
assertSelectEquals()
assertSelectRegExp()
assertStringEndsWith()
assertStringEqualsFile()
assertStringStartsWith()
assertTag()
assertThat()
assertTrue()
assertXmlFileEqualsXmlFile()
assertXmlStringEqualsXmlFile()
assertXmlStringEqualsXmlString()
5. コマンドラインのテストランナー
Command-Line switches
6. Fixtures
tearDown() よりも setUp()
バリエーション
Fixture の共有
グローバルな状態
7. テストの構成
ファイルシステムを用いたテストスイートの構成
XML 設定ファイルを用いたテストスイートの構成
8. データベースのテスト
データベースのテストに対応しているベンダー
データベースのテストの難しさ
データベーステストの四段階
1. データベースのクリーンアップ
2. フィクスチャの準備
3–5. テストの実行、結果の検証、そして後始末
PHPUnit のデータベーステストケースの設定
getConnection() の実装
getDataSet() の実装
データベーススキーマ (DDL) とは?
ヒント: 自前でのデータベーステストケースの抽象化
データセットとデータテーブルについて知る
利用できる実装
外部キーには注意
自作のデータセットやデータテーブルの実装
接続 API
データベースアサーション API
テーブルの行数のアサーション
テーブルの状態のアサーション
クエリの結果のアサーション
複数のテーブルの状態のアサーション
よくある質問
PHPUnit は、テストごとにデータベーススキーマを作り直すの?
PDO を使ったアプリケーションじゃないと Database Extension を使えないの?
Too much Connections というエラーが出たらどうすればいい?
フラット XML や CSV のデータセットで NULL を扱う方法は?
9. 不完全なテスト・テストの省略
不完全なテスト
テストの省略
10. テストダブル
スタブ
モックオブジェクト
ウェブサービスのスタブおよびモック
ファイルシステムのモック
11. テストの進め方
開発中のテスト
デバッグ中のテスト
12. テスト駆動開発
銀行口座の例
13. 振舞駆動開発
ボウリングゲームの例
14. コードカバレッジ解析
カバーするメソッドの指定
コードブロックの無視
ファイルのインクルードや除外
エッジケース
15. テストのその他の使用法
アジャイルな文書作成
複数チームでのテスト
16. 雛形ジェネレータ
テストケースクラスの雛形の作成
テストケースクラスからのクラスの雛形の作成
17. PHPUnit と Selenium
Selenium Server
PHPUnit_Extensions_Selenium2TestCase
PHPUnit_Extensions_SeleniumTestCase
18. ログ出力
テスト結果 (XML)
テスト結果 (TAP)
テスト結果 (JSON)
コードカバレッジ (XML)
コードカバレッジ (テキスト)
19. PHPUnit の拡張
PHPUnit_Framework_TestCase のサブクラスの作成
カスタムアサーションの作成
PHPUnit_Framework_TestListener の実装
PHPUnit_Extensions_TestDecorator のサブクラスの作成
PHPUnit_Framework_Test の実装
A. アサーション
B. アノテーション
@assert
@author
@backupGlobals
@backupStaticAttributes
@codeCoverageIgnore*
@covers
@dataProvider
@depends
@expectedException
@expectedExceptionCode
@expectedExceptionMessage
@group
@outputBuffering
@runTestsInSeparateProcesses
@runInSeparateProcess
@test
@testdox
@ticket
C. XML 設定ファイル
PHPUnit
テストスイート
グループ
コードカバレッジ対象のファイルの追加や除外
ログ出力
テストリスナー
PHP INI 項目や定数、グローバル変数の設定
Selenium RC の設定ブラウザ
D. 目次
E. 参考文献
F. 著作権