システム開発

Laravel+PHPUnitで認証付きAPIのテストを行う

PHPの人気のフレームワークLaravelではWebサイトの管理画面を開発することができます。

開発の手順に関しては以下の記事にて具体的に紹介をしていきました。

さらに開発後のデプロイの手順は以下で解説していきました。

この記事ではPHPUnitでLaravelのAPIテストをする方法について解説しています。

  • Laravelを使って構築をしたい方
  • Webサイト構築の具体的な手法が知りたい方

におすすめの記事となっています。これを読めばいよいよLaravelで開発した管理画面をリリースする準備ができますよ。

最低限やりたいことを決める

まず作業の前に、最低限やりたいことを決めておきます。
今回はLaravelの認証後のAPIのテストを書けるようにしたいので、以下の要件にしました。

● CookieのAPI認証の部分はテストせず、認証済として扱う
● 認証後の管理者ユーザーの一覧取得のAPIをテストする

Cookie認証のAPIは以前の記事で実装したものを利用します。

CookieによるAPI経由のユーザー認証機能を作る【Laravel6とNuxt.jsで作る管理画面】

テストを書くための前準備

LaravelではデフォルトでPHPUnitが使えるようになっていますが、
実際にテスト書いていくためには、いくつか準備が必要なので、そちらを進めていきます。

テスト用のDBを作成

開発環境のデータに影響を与えないようにするため、まずは、以下コマンドを実行してテスト用のDBを作成しましょう。

mysql> create database laravel_test;

PHPUnitではデフォルトでsqliteを使う設定になっていますが、本番DBと環境を揃えるため、テストでもMySQLを使うようにします。

テスト用の.envファイルを作成

次に下記コマンドでテスト用の.envファイルを作成します。

cp .env.example .env.testing

ファイルが作成できたら、以下の内容で.env.testingを修正します。

APP_NAME=Laravel
//testingに変更
APP_ENV=testing
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost

LOG_CHANNEL=stack

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
//追加したデータベース名に変更
DB_DATABASE=laravel_test
DB_USERNAME=root
DB_PASSWORD=

修正が完了したら、次に以下コマンドでテスト用のAPP_KEYを作成します。

php artisan key:generate --env=testing

以下のような値が.env.testingに作成されればOKです。

APP_KEY=base64:XXXXXXX

PHPUnitの設定をMySQLを使うように変更

次に以下の内容でphpunit.xmlを変更します。

<php>
    <server name="APP_ENV" value="testing"/>
    <server name="BCRYPT_ROUNDS" value="4"/>
    <server name="CACHE_DRIVER" value="array"/>
    //ここを変更
    <server name="DB_CONNECTION" value="mysql"/>
    <server name="MAIL_DRIVER" value="array"/>
    <server name="QUEUE_CONNECTION" value="sync"/>
    <server name="SESSION_DRIVER" value="array"/>
</php>

PHPUnitは.env.{APP_ENVの値}の.envファイルを自動で読み込む作りになっています。
そのため、DB_DATABASE.env.testingの値が設定されるので、phpunit.xml側からは削除しています。

テスト用のDBにマイグレーションを実行

次に以下コマンドを実行します。

php artisan migrate --env=testing

以下のようにマイグレーションが反映されればOKです。

Migration table created successfully.
Migrating: 2014_10_12_000000_create_users_table
Migrated:  2014_10_12_000000_create_users_table (0.05 seconds)
Migrating: 2014_10_12_100000_create_password_resets_table
Migrated:  2014_10_12_100000_create_password_resets_table (0.06 seconds)
Migrating: 2019_08_19_000000_create_failed_jobs_table
Migrated:  2019_08_19_000000_create_failed_jobs_table (0.03 seconds)
Migrating: 2020_05_09_010620_create_admin_users_table
Migrated:  2020_05_09_010620_create_admin_users_table (0.05 seconds)

テストコードの作成

事前準備が完了したので、ここからは実際にテストを書いていきます。

FeatureとUnitの使い分けについて

Laravelでは、testsディレクトリの下にFeatureディレクトリとUnitディレクトリがあり、
この中にテストコードを配置します。

FeatureにはControllerMiddlewareといったHTTPリクエストによる機能テスト、Unitにはそれ以外の単体テストについて書きます。

それ以外のディレクトリ構成にすることも出来ますが、基本の構成を踏襲した方が可読性が上がって良いでしょう。

今回はAPIのテストなので、Featureテストを書いていきます。

Featureテストの雛形ファイルを作成

まず以下のコマンドでFeatureテストのファイルを作成します。

php artisan make:test Api/AdminUserTest

次のような内容のtests/Feature/Api/AdminUserTest.phpが作られていればOKです。

<?php

namespace Tests\Feature\Api;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithFaker;
use Tests\TestCase;

class AdminUserTest extends TestCase
{
    /**
     * A basic feature test example.
     *
     * @return void
     */    public function testExample()
    {
        $response = $this->get('/');

        $response->assertStatus(200);
    }
}

スクリプトファイルでテストを実行

Laravelは設定ファイルをキャッシュして高速化しているため、DBを扱うテストコードを実行する前には php artisan config:clear を実行することが公式ドキュメントで勧められています。

これをしておかないと、キャッシュで本番DBがリセットされてしまうという問題も起こりかねません。
そのため、以下の内容のtest.shというスクリプトファイルを作成します。

#!/bin/bash

php artisan config:clear
./vendor/bin/phpunit tests/Feature/Api

ファイルが出来たら下記コマンドでテストを実行します。

chmod +x test.sh //実行権限を付与(最初の1回だけでOK)
./test.sh

以下のような画面が出ればOKです。

管理者ユーザー用のFactoryを追加

ログインのテストをするために管理者ユーザーのアカウントを作成します。
こういったテスト用データの用意には、Factoryを使いましょう。

以下コマンドで管理者ユーザー用のFactoryを作成します。

php artisan make:factory AdminUserFactory --model=AdminUser

作成されたdatabase/factories/AdminUserFactory.phpを以下内容に編集します。

<?php

/** @var \Illuminate\Database\Eloquent\Factory $factory */
use App\AdminUser;
use Faker\Generator as Faker;

$factory->define(AdminUser::class, function (Faker $faker) {
    static $password;

    return [
        'name' => $faker->name,
        'email' => $faker->unique()->safeEmail,
        'email_verified_at' => now(),
        'password' => $password ?: $password = bcrypt('secret'),
        'remember_token' => Str::random(10),
    ];
});

これで管理者ユーザーを作ることが出来るようになりました。

一覧取得(Index)のテストケースを追加

次にtests/Feature/Api/AdminUserTest.phpを以下の内容に編集します。

<?php

namespace Tests\Feature\Api;

use App\AdminUser;

use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\WithFaker;
use Tests\TestCase;

class AdminUserTest extends TestCase
{
    // テストデータのリセット
    use RefreshDatabase;
    // ミドルウェアの無効化
    use WithoutMiddleware;

    private $adminUser;

    public function testIndex()
    {
        // テストデータをFactoryで作成
        $adminUser1 = factory(AdminUser::class)->create();
        $adminUser2 = factory(AdminUser::class)->create();

        $response = $this->json('GET', '/api/admin_users');
        $response
            ->assertStatus(200)
            ->assertJson(
                [
                    [
                        'id' => $adminUser1->id,
                        'name' => $adminUser1->name,
                        'email' => $adminUser1->email,
                    ],
                    [
                        'id' => $adminUser2->id,
                        'name' => $adminUser2->name,
                        'email' => $adminUser2->email,
                    ]
                ]
            );
    }
}

Laravelでは便利な共通処理がtraitとして提供されており、上記のコードではRefreshDatabaseWithoutMiddlewareを利用しています。

今回使っているAPIではAjax以外の通信を403エラーにするMiddlewareを指定していますが、テストでは不要なため除外するようにしています。

動作を確認する

編集できたら、テスト実行後に以下のコマンドを実行します。

php artisan tinker --env=testing

テストが成功し、以下のようにデータがリセットされていればOKです。

おわりに

今回はPHPUnitでLaravelの認証付きAPIのテストを行いました。
本記事では一覧取得のテストケースのみ紹介しましたが、同様にCRUDのテストケースを書けますね。

本日紹介したようなものを外注してみるのはいかがでしょうか。 dehaソリューションズではオフショア開発によって低コストで迅速な開発をサポートしています。

Laravelに関して詳しくお話を聞きたい方、開発相談や無料お見積りをしたい方はこちらからご気軽にお問い合わせください。

▼ dehaソリューションへの簡単見積もりの依頼はこちら

Mai Tran

Recent Posts

【保存版・発注者向け】アプリ開発の方法についてゼロから解説

アプリ開発を検討する企業や個人にとって、最初に直面する課題は「どのようにアプリを作るか」です。 そこで本記事ではアプリ開発について、どのような工程があるのかゼロから徹底解説していきたいと思います。 アプリ開発をしたい方 アプリ開発初心者の方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばアプリ開発の効率の良い方法が丸わかりですよ。 アプリ開発に関わるすべての工程や手法を理解することで、発注者としてより良い判断ができ、プロジェクトを円滑に進めることが可能になります。 アプリを開発する4つの方法 スクラッチ開発とは スクラッチ開発とは、既存のテンプレートやツールを使わずに、プログラムのコードをゼロから書いてアプリやシステムを作る開発方法です。 完全に自由な設計ができるため、自社の業務や目的にぴったり合った機能やデザインを実現できます。 たとえば、高度な処理能力が必要なシステムや、他にはない独自の機能を持たせたい場合に最適です。 主なメリット・機能やデザインを自由に設計できる(カスタマイズ性が高い)・処理速度や操作性などのパフォーマンスを最適化しやすい・他社にはない独自機能を実装しやすい 主なデメリット・開発に時間と費用がかかる・高度な技術や専門知識が必要 スクラッチ開発は、「こだわりたいポイントが多い」「長期的に使い続けたい」システムに向いています。反対に、早く・安く始めたい場合は、別の開発手法を検討するのがよいでしょう。…

8 hours ago

チャイナプラスワンとは?製造業だけではなく、IT業界も注目

近年、製造業を中心に広がってきた「チャイナプラスワン(China Plus One、中国+1)」戦略が、IT業界でも注目され始めています。 中国に依存しすぎない経営体制を構築するためのこの動きは、製造業の枠を越え、ソフトウェア開発やITインフラといったデジタル領域にも拡大しています。 この記事では、チャイナプラスワンの概要から背景、IT業界における注目理由、そしてオフショア開発との関係性や活用事例までを詳しく解説します。 チャイナプラスワンについて知りたい方 オフショア開発に興味がある方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばチャイナプラスワンの概要がわかるだけでなく、今後の展望も分かりますよ。 (more…)

1 day ago

【2025年版】スマホ(iPhone/Android)OS端末シェアランキング(世界と日本市場)

スマートフォン市場におけるOS(オペレーティングシステム)は、ユーザー体験の根幹を担う要素のひとつです。 特に「Android」と「iOS」の二大OSは、長年にわたって競争を続けており、地域によってその勢力図は大きく異なります。 この記事では、2025年4月時点における世界および日本のスマホOSシェアを、StatCounterの最新データをもとに詳しく解説します。 OS端末シェアについて知りたい方 スマホOS別に広告出稿の戦略を立てたい人 国や地域ごとのユーザー属性やシェア構造を把握したい人 これらに当てはまる方におすすめの記事となっています。これを読めば世界と日本のOSシェアの特徴や違いが丸わかりですよ。 (more…)

6 days ago

【2025年版】ハイブリッドアプリ開発のおすすめフレームワークランキング5選

スマートフォンアプリ開発において、iOSとAndroidの両方に対応するハイブリッドアプリは、開発コストや工数を抑えられる点で多くの企業や開発者に選ばれています。 2025年現在、技術の進化によりハイブリッドアプリ開発フレームワークも多様化・高機能化が進み、それぞれの強みを活かす選定が重要になってきました。 この記事ではそんな2025年におすすめのハイブリッドアプリ開発フレームワークをランキング形式で5つご紹介します。 ハイブリットアプリに興味がある方 最新のハイブリットアプリについて知りたい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばハイブリットアプリの最新情報が丸わかりですよ。 (more…)

1 week ago

要件定義とは?オフショア開発で進め方や成功のコツ

システム開発やアプリ開発において、プロジェクトの成功を左右する「要件定義」。 特にオフショア開発では、言語や文化の違いから誤解が生まれやすく、要件定義の質が成果に直結します。 この記事では、要件定義の基本から、オフショア開発での進め方、成功のコツまでを解説します。 オフショア開発に興味がある方 要件定義の仕方について知りたい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばオフショア開発をうまく進めるための要件定義の方法が丸わかりですよ。 (more…)

2 weeks ago

BAとは?オフショア開発での役割、BrSE & ITコミュニケーターとの違いをご紹介

BA(ビジネスアナリスト)とはオフショア開発プロセスにおいて重要な役割を果たします。 彼らは、クライアントと開発チームの間で情報のやり取りを担当し、ビジネスの視点からソフトウェア開発プロジェクトを導きます。 本日はそんなBA(ビジネスアナリスト)について具体的にどう言った特徴があるのかや、BrSE(ブリッジSE)& ITコミュニケーターとの違いについて解説していきます。 BA(ビジネスアナリスト)に興味がある方 オフショア開発に興味がある方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばBA(ビジネスアナリスト)の具体的な役割が丸わかりですよ。 (more…)

2 weeks ago