# PHPUnitを使ったユニットテストの書き方入門

## 目次
1. はじめに
2. PHPUnitとは？
3. PHPUnitのインストール方法
4. ユニットテストの基本概念
5. PHPUnitを使ったテストの書き方
   - 5.1. テストクラスとテストメソッド
   - 5.2. アサーション
   - 5.3. テストの実行と結果確認
6. データプロバイダを使ったテスト
7. テストダブル（モック）を使ったテスト
8. まとめ

## 1. はじめに
ユニットテストは、ソフトウェア開発において信頼できるコードを書くために非常に重要です。PHPでは、PHPUnitという強力なテストフレームワークを使ってユニットテストを実装します。本記事では、PHPUnitのインストールから基本的なテストの書き方、さらに高度なテストまで網羅的に解説します。

## 2. PHPUnitとは？
PHPUnitは、PHP用の単体テストフレームワークで、XUnit系のテスト体系に基づいています。PHPUnitでは、テストケースを書いて実行することで、コードが期待通りの動作をするかを確認します。

## 3. PHPUnitのインストール方法
PHPUnitはComposerを使ってインストールするのが一般的です。以下のコマンドを使ってプロジェクトにPHPUnitを追加します。

![img](/mosaic-code.jpg)

## 4. ユニットテストの基本概念
ユニットテストとは、個々のプログラム単位（ユニット）を対象にテストを行うことです。ユニットテストを行うことで、コードの個別機能が正しく動作するか確認でき、保守性を高めつつ、新たなバグの混入を防ぐことができます。

## 5. PHPUnitを使ったテストの書き方

### 5.1 テストクラスとテストメソッド
PHPUnitでは、テストを「テストクラス」として定義し、その中に具体的なテストケースを「テストメソッド」として実装します。テストクラスは`PHPUnit\Framework\TestCase`を拡張して作成します。

![img](/mosaic-code.jpg)

### 5.2 アサーション
テストメソッドでは、期待する結果をアサーションメソッドで確認します。代表的なアサーションとして以下があります。
- `assertEquals($expected, $actual)`: 期待する値と実際の値が等しいことを確認する。
- `assertTrue($condition)`: 条件が真であることを確認する。
- `assertFalse($condition)`: 条件が偽であることを確認する。
- `assertNull($actual)`: 値がnullであることを確認する。

### 5.3 テストの実行と結果確認
テストは以下のコマンドで実行します。

![img](/mosaic-code.jpg)

実行すると、PHPUnitは指定ディレクトリのテストを実行し、結果をターミナルに表示します。

## 6. データプロバイダを使ったテスト
PHPUnitではデータプロバイダを使って、複数のデータセットに対して同じテストを実行できます。データプロバイダメソッドは、テストメソッドに様々なデータを提供します。

![img](/mosaic-code.jpg)

## 7. テストダブル（モック）を使ったテスト
実際のアプリケーションでは、外部依存をもつメソッドをテストすることがあります。この際にモックオブジェクトを使用することで、依存を切り離したテストが可能になります。

![img](/mosaic-code.jpg)

## 8. まとめ
PHPUnitを使うことで、PHPアプリケーションの信頼性を向上させることができます。本記事ではPHPUnitの基本的な使い方から、データプロバイダやモックを用いたテストまでを解説しました。まずは基本を押さえながら、徐々に応用的なテスト手法に挑戦していきましょう。 [cv:issue_marketplace_engineer]

# PHPUnitを使ったユニットテストの書き方入門

## 目次
1. はじめに
2. PHPUnitとは？
3. PHPUnitのインストール方法
4. ユニットテストの基本概念
5. PHPUnitを使ったテストの書き方
   - 5.1. テストクラスとテストメソッド
   - 5.2. アサーション
   - 5.3. テストの実行と結果確認
6. データプロバイダを使ったテスト
7. テストダブル（モック）を使ったテスト
8. まとめ

## 1. はじめに
ユニットテストは、ソフトウェア開発において信頼できるコードを書くために非常に重要です。PHPでは、PHPUnitという強力なテストフレームワークを使ってユニットテストを実装します。本記事では、PHPUnitのインストールから基本的なテストの書き方、さらに高度なテストまで網羅的に解説します。

## 2. PHPUnitとは？
PHPUnitは、PHP用の単体テストフレームワークで、XUnit系のテスト体系に基づいています。PHPUnitでは、テストケースを書いて実行することで、コードが期待通りの動作をするかを確認します。

## 3. PHPUnitのインストール方法
PHPUnitはComposerを使ってインストールするのが一般的です。以下のコマンドを使ってプロジェクトにPHPUnitを追加します。

```bash
composer require --dev phpunit/phpunit
```

## 4. ユニットテストの基本概念
ユニットテストとは、個々のプログラム単位（ユニット）を対象にテストを行うことです。ユニットテストを行うことで、コードの個別機能が正しく動作するか確認でき、保守性を高めつつ、新たなバグの混入を防ぐことができます。

## 5. PHPUnitを使ったテストの書き方

### 5.1 テストクラスとテストメソッド
PHPUnitでは、テストを「テストクラス」として定義し、その中に具体的なテストケースを「テストメソッド」として実装します。テストクラスは`PHPUnit\Framework\TestCase`を拡張して作成します。

```php
use PHPUnit\Framework\TestCase;

class SampleTest extends TestCase
{
    public function testSum()
    {
        $sum = 2 + 3;
        $this->assertEquals(5, $sum);
    }
}
```

### 5.2 アサーション
テストメソッドでは、期待する結果をアサーションメソッドで確認します。代表的なアサーションとして以下があります。
- `assertEquals($expected, $actual)`: 期待する値と実際の値が等しいことを確認する。
- `assertTrue($condition)`: 条件が真であることを確認する。
- `assertFalse($condition)`: 条件が偽であることを確認する。
- `assertNull($actual)`: 値がnullであることを確認する。

### 5.3 テストの実行と結果確認
テストは以下のコマンドで実行します。

```bash
vendor/bin/phpunit tests
```

実行すると、PHPUnitは指定ディレクトリのテストを実行し、結果をターミナルに表示します。

## 6. データプロバイダを使ったテスト
PHPUnitではデータプロバイダを使って、複数のデータセットに対して同じテストを実行できます。データプロバイダメソッドは、テストメソッドに様々なデータを提供します。

```php
public function additionProvider()
{
    return [
        [1, 1, 2],
        [2, 2, 4],
        [3, 3, 6]
    ];
}

/**
 * @dataProvider additionProvider
 */
public function testAdd($a, $b, $expected)
{
    $this->assertEquals($expected, $a + $b);
}
```

## 7. テストダブル（モック）を使ったテスト
実際のアプリケーションでは、外部依存をもつメソッドをテストすることがあります。この際にモックオブジェクトを使用することで、依存を切り離したテストが可能になります。

```php
$mock = $this->createMock(SomeClass::class);
$mock->method('someMethod')->willReturn(true);

$this->assertTrue($mock->someMethod());
```

## 8. まとめ
PHPUnitを使うことで、PHPアプリケーションの信頼性を向上させることができます。本記事ではPHPUnitの基本的な使い方から、データプロバイダやモックを用いたテストまでを解説しました。まずは基本を押さえながら、徐々に応用的なテスト手法に挑戦していきましょう。 [![image](https://firebasestorage.googleapis.com/v0/b/issue-pro-42602.appspot.com/o/topics%2F17fa658b-53c7-4ca0-a28b-e588ed1bd371?alt=media&token=2c00afff-85ff-4428-8d15-696ab676dcb0)](https://i-ssue.com/lp/check_salary)

PHPUnitを使ったユニットテストの書き方入門

目次

続きを読むには単価診断を受けてください（30秒）