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ソリューションへの簡単見積もりの依頼はこちら
企業が競争力を維持し、業務効率を高めるために、AI(人工知能)の導入はますます重要になっています。 特に、生成AIを活用した社内業務システムの効率化は、企業の成長を促進する大きな要因となり得ます。 この記事では、生成AIを導入することによるメリットや、導入時に注意すべき点について詳しく解説します。 生成AIを活用して業務効率化を図りたい方 社内のIT人材が不足している方 生成AIの使い方を知りたい方 これらに当てはまる方におすすめの記事となっています。これを読めば生成AI活用を活用するメリットや気をつけるべきことが丸わかりですよ。 生成AIの活用方法 自動化されたデータ処理と分析 生成AIは、大量のデータを高速かつ正確に処理し、パターンやトレンドを抽出する能力を持っています。 これにより、従業員が手動でデータを分析する時間を大幅に削減し、より戦略的な意思決定をサポートすることができます。 例えば、日常的なレポート作成や予測分析を自動化することで、リソースをより重要な業務に集中させることが可能です。 カスタマイズされた業務プロセスの提案 生成AIは、各部門の業務フローや要件に基づき、最適なプロセス改善案を提案することができます。 これにより、従来のシステムでは考慮されなかった細かい調整が可能となり、業務効率をさらに向上させることができます。…
ベトナムにおけるERP(エンタープライズ・リソース・プランニング)システム市場は、近年急速な成長を遂げています。 この急速な市場拡大は、デジタルトランスフォーメーションの推進、クラウドERPの普及、中小企業のニーズの高まりなど、さまざまな要因によって支えられています。 この記事では、ベトナムでのERP市場の現状と今後の展望について詳しく見ていきます。 ベトナムでのERP市場の現状について知りたい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばERPシステム市場 の今後の展望が丸わかりですよ。 ERP(エンタープライズ・リソース・プランニング)システムとは ERP(エンタープライズ・リソース・プランニング)システムは、企業のさまざまな業務プロセスを統合的に管理するためのソフトウェアです。 財務、人事、製造、供給チェーン管理、販売、在庫管理、顧客関係管理(CRM)など、企業内の主要な業務を一元化し、リアルタイムで情報を共有することが可能です。 ERPシステムの導入により、企業は業務の効率化、コスト削減、意思決定の迅速化を図ることができます。 例えば、財務部門では、売上や支出のデータが他の部門と連携し、予算管理や経営分析がスムーズに行えます。また、在庫管理では、需要予測に基づいて適切な在庫量を維持し、無駄を減らすことが可能です。 さらに、クラウドベースのERPシステムが普及することで、場所やデバイスに依存せずにアクセスでき、特に中小企業にとっては初期コストが低く、スケーラブルなソリューションとして人気が高まっています。 ERPは、企業の競争力を強化し、グローバル市場での成功を支える重要なツールであり、現代のビジネス環境において不可欠な存在となっています。 ベトナムでのERPシステム市場規模 ERPシステムの市場規模は、ベトナムにおいて急速に拡大しています。…
データドリブン経営が成功するためには、膨大なデータを効果的に分析し、価値あるインサイトを引き出すことが重要です。 AI技術は、これを実現する強力なツールとして注目されています。 この記事では、AIがデータドリブン経営を支援する具体的な方法を紹介します。 データドリブン経営に興味がある方 データドリブン経営×AIの方法を知りたい方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばAIを活用したデータドリブン経営の方法が丸わかりですよ。 (more…)
デジタル変革(DX)が進む現代、企業経営において「データドリブン経営」の重要性がますます高まっています。 データドリブン経営とは、企業の意思決定や戦略立案をデータに基づいて行う経営手法です。 この記事では、データドリブン経営の概要、DX推進におけるメリット、成功のためのポイント、そして注意すべき点について解説します。 データドリブン経営に興味がある方 DX化をすすめている企業の方々 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばデータドリブン経営がどういうものなのかや、データドリブン経営を成功させるためのポイントが丸わかりですよ。 (more…)
デジタルトランスフォーメーション(DX)は、企業や国の競争力を左右する重要な要素となっています。 特にベトナムは、急速な経済成長とテクノロジーの革新により、東南アジアの中で注目される存在です。 この記事では、そんなベトナムのDX市場の現状と今後の動向について、具体的なデータとトレンドを基に詳しく探っていきます。 ベトナムDX市場に興味がある方 社内のIT人材が不足している方 オフショア開発に興味がある方 これらに当てはまる方におすすめの記事となっています。これを読めばベトナムのDX市場の状況やトレンドについて丸わかりですよ。 (more…)
AIアシスタントは、人工知能を活用したソフトウェアで、音声やテキストを介してユーザーの指示に従い、情報提供やタスクの自動化を行います。 多くの企業が業務効率化や顧客サポートの強化を目的にAIアシスタントの導入を検討していますが、その前に知っておくべき重要なポイントがいくつかあります。 この記事ではそんなAIアシスタント導入前に考慮すべき7つの点を解説します。 AIアシスタントに興味がある方 社内のIT人材が不足している方 これらに当てはまる方におすすめの記事となっています。これを読めばAIアシスタントを導入する前に気をつけるべきことが明確化しますよ。 (more…)