PHPの人気のフレームワークLaravelではWebサイトの管理画面を開発することができます。
開発の手順に関しては以下の記事にて具体的に紹介をしていきました。
さらに開発後のデプロイの手順は以下で解説していきました。
この記事ではPHPUnitでLaravelのAPIテストをする方法について解説しています。
におすすめの記事となっています。これを読めばいよいよLaravelで開発した管理画面をリリースする準備ができますよ。
まず作業の前に、最低限やりたいことを決めておきます。
今回はLaravelの認証後のAPIのテストを書けるようにしたいので、以下の要件にしました。
● CookieのAPI認証の部分はテストせず、認証済として扱う
● 認証後の管理者ユーザーの一覧取得のAPIをテストする
Cookie認証のAPIは以前の記事で実装したものを利用します。
CookieによるAPI経由のユーザー認証機能を作る【Laravel6とNuxt.jsで作る管理画面】
LaravelではデフォルトでPHPUnitが使えるようになっていますが、
実際にテスト書いていくためには、いくつか準備が必要なので、そちらを進めていきます。
開発環境のデータに影響を与えないようにするため、まずは、以下コマンドを実行してテスト用のDBを作成しましょう。
mysql> create database laravel_test;
PHPUnitではデフォルトでsqlite
を使う設定になっていますが、本番DBと環境を揃えるため、テストでもMySQLを使うようにします。
次に下記コマンドでテスト用の.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.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
側からは削除しています。
次に以下コマンドを実行します。
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)
事前準備が完了したので、ここからは実際にテストを書いていきます。
Laravelでは、testsディレクトリの下にFeatureディレクトリとUnitディレクトリがあり、
この中にテストコードを配置します。
FeatureにはController
やMiddleware
といったHTTPリクエストによる機能テスト、Unitにはそれ以外の単体テストについて書きます。
それ以外のディレクトリ構成にすることも出来ますが、基本の構成を踏襲した方が可読性が上がって良いでしょう。
今回はAPIのテストなので、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を作成します。
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),
];
});
これで管理者ユーザーを作ることが出来るようになりました。
次に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
として提供されており、上記のコードではRefreshDatabase
とWithoutMiddleware
を利用しています。
今回使っているAPIではAjax以外の通信を403エラーにするMiddleware
を指定していますが、テストでは不要なため除外するようにしています。
編集できたら、テスト実行後に以下のコマンドを実行します。
php artisan tinker --env=testing
テストが成功し、以下のようにデータがリセットされていればOKです。
今回はPHPUnitでLaravelの認証付きAPIのテストを行いました。
本記事では一覧取得のテストケースのみ紹介しましたが、同様にCRUDのテストケースを書けますね。
本日紹介したようなものを外注してみるのはいかがでしょうか。 dehaソリューションズではオフショア開発によって低コストで迅速な開発をサポートしています。
Laravelに関して詳しくお話を聞きたい方、開発相談や無料お見積りをしたい方はこちらからご気軽にお問い合わせください。
▼ dehaソリューションへの簡単見積もりの依頼はこちら
2025年8月時点におけるドル/円(USD/JPY)の為替レートは、およそ ¥146.9です。 円安傾向は続いており、過去数十年のトレンドとも重なりつつ、依然として投資・政策動向から注目を浴びています。 この記事ではそんな円安に着目してオフショア開発に与える影響を見ていこうと思います。 オフショア開発を始めたい方 社内のIT人材が不足している方 開発効率を上げたい方 これらに当てはまる方におすすめの記事となっています。これを読めばオフショア開発に円安がどう影響するのかがわかるのはもちろん、いつ始めるべきかまで丸わかりですよ。 (more…)
近年、生成AI(Generative AI)はビジネスの在り方を大きく変革する技術として急速に普及しています。 文章、画像、音声、コードなど、多様なコンテンツを自動生成できるこの技術は、従来の業務効率化だけでなく、新たな価値創出や顧客体験の革新にも直結します。 特にエンタープライズ(大企業)においては、膨大なデータ資産や高度なセキュリティ要件、複雑な業務プロセスを背景に、生成AIの導入が戦略的な投資対象として注目されています。 この記事ではそんなエンタープライズ向け生成AIについて具体的な活用事例や導入ステップなど徹底解説していきます。 (more…)
近年、生成AI(Generative AI)は文章生成、画像生成、音声合成、プログラムコードの自動生成など、幅広い分野で実用化が進んでいます。 業務効率化や新しい価値創造の手段として注目され、さまざまな業種で導入が加速しています。 しかし、生成AIサービスを導入するにあたり、どのような形態で利用するかは企業の戦略や要件によって異なります。 この記事では、主な導入形態としてSaaS型の生成AIサービス、オンプレミス型生成AIサービス、API/PaaS活用型生成AIサービスに着目し、それぞれの特徴・メリット・デメリット・選び方のポイントを整理します。 生成AIサービスを導入したい方 生成AIサービスのタイプを知りたい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めば生成AIサービスについてどんな特徴があるのかがわかるのはもちろん、適切な選び方まで丸わかりですよ。 (more…)
2025年、生成AIはビジネスと社会の在り方を大きく変えつつあります。 大規模言語モデル(LLM)、マルチモーダルAI、RAG、AIエージェントといった技術革新が進み、企業の業務効率化から新しい価値創造まで、その活用範囲は急速に広がっています。 この記事ではそんな生成AI市場について、今後の展望や業務への活用について動向などを見ていきます。 生成AIを活用したい企業の方 業務を効率化したい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めば生成AI市場について現状と今後の展望が丸わかりですよ。 (more…)
近年、AI技術の進化とともに、業務効率化やサービス向上を目的とした「AIエージェント」の導入が急速に進んでいます。 弊社でも、この流れを受けてAIエージェントの導入を進め、多くの現場で業務の質とスピードの両立を実現することができました。 この記事では、実際に弊社が取り組んだAIエージェントの活用事例を紹介しながら、AI導入によるメリットとその可能性についてご紹介いたします。 AIエージェントが気になる方 AIエージェントの事例が知りたい方 社内の人材不足にお悩みの方 これらに当てはまる方におすすめの記事となっています。これを読めばAIエージェントの成功事例が丸わかりですよ。 (more…)
近年、業務効率化や顧客対応の高度化を目的として、企業や自治体、教育機関など多くの組織で「AIエージェント」の導入が進んでいます。 AIエージェントとは、人工知能を活用して自動的に応答や処理を行うシステムの総称で、チャットボットやバーチャルアシスタント、RPA(Robotic Process Automation)などが含まれます。 しかしながら、AIエージェントの導入には多くの期待が寄せられる一方で、現場ではさまざまな課題に直面するケースも少なくありません。 この記事では、AIエージェント導入によくある課題とその解決方法について、具体的に解説していきます。 AIエージェントに興味がある方 AIエージェントの導入に不安がある方 社内の人材不足にお悩みの方 これらに当てはまる方におすすめの記事となっています。これを読めばAIエージェントの特徴がわかるのはもちろん、うまく活用するための方法もわかりますよ。 (more…)