GitHub ActionsでLaravelを高速化する
最終更新
GitHub ActionsでLaravelを高速化するには、Composerのダウンロードディレクトリをキャッシュし、php artisan test --parallelでテストを並列実行して、MySQLやPostgresサービスにヘルスチェックと高速なテスト設定を用意します。効果が大きいのは通常、テストの並列化と、実行のたびに同じパッケージをインストードしないことです。
このガイドでは、各要素を完全なワークフローとともに説明します。全般的な考え方は、GitHub Actionsの高速化ガイドをご覧ください。
時間がかかっている箇所
直近の実行からステップごとの所要時間を確認してください。Laravelのパイプラインでは通常、PHPと拡張機能のセットアップ、composer install、npm ciとvite build、データベースのマイグレーション、テスト実行に時間がかかります。RefreshDatabaseを使うテストや機能テストが多い場合、そこが最も長い処理になりがちです。
PHPセットアップとComposerキャッシュ
shivammathur/setup-phpを使うと、ホステッドランナー上でPHPと拡張機能を素早くインストールできます。READMEではv2タグが使われており、入力としてphp-version、extensions、coverage、toolsがあります。カバレッジが不要であればcoverage: noneを指定してください。Xdebugが有効だとPHPの動作が大きく遅くなります。
READMEのComposerキャッシュの手順では、vendorではなくComposerのキャッシュディレクトリを保存します。vendorをactions/cacheでキャッシュすると副作用が起きる可能性があると注意されています。
- uses: shivammathur/setup-php@v2
with:
php-version: "8.4"
extensions: mbstring, pdo_mysql, bcmath
coverage: none
- name: Get Composer cache directory
id: composer-cache
run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
- uses: actions/cache@v6
with:
path: ${{ steps.composer-cache.outputs.dir }}
key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
restore-keys: ${{ runner.os }}-composer-
- run: composer install --prefer-dist --no-progress --no-interaction
CIで不要なインストール後スクリプトの処理がある場合は--no-scriptsを指定してください。テストに必要な場合のみ、php artisan package:discoverを手動で実行します。テストには開発用パッケージが必要なため、CIでは--devによる除外を行わないでください。
テストを並列実行する
Laravelのphp artisan test --parallelは、brianium/paratestパッケージを使ってテストを複数のプロセスで実行します。開発用の依存関係としてインストールしてください(composer require brianium/paratest --dev)。Laravelはプロセスごとにデータベースを作成し、テスト用データベース名にトークンのサフィックスを付けて名前を決めるため、プロセス同士が衝突しません。
php artisan test --parallel --processes=4
Pestを使う場合は、./vendor/bin/pest --parallelで同じことができます。--processesを指定しない場合、CPUコア数に応じたプロセス数になります。並列実行では状態の分離が必要です。storage内のファイルを共有しない、固定ポートを使わない、実行順序に依存しないようにしてください。データは残さず、RefreshDatabaseかDatabaseTransactionsを使ってください。並列モードでのみ失敗するテストがあれば、まず共有状態を疑ってください。
調整済みのデータベースサービス
本番環境で使っているものと同じデータベースを使ってください。MySQLの場合は、ヘルスチェック付きのサービスコンテナを使います。
services:
mysql:
image: mysql:8.4
env:
MYSQL_ROOT_PASSWORD: password
MYSQL_DATABASE: laravel
ports: ["3306:3306"]
options: >-
--health-cmd "mysqladmin ping -h 127.0.0.1 -ppassword"
--health-interval 5s --health-timeout 5s --health-retries 15
使い捨てのテストデータ向けにMySQLを調整するのは、CI専用の妥当なトレードオフです。コンテナイメージはdocker runでサーバーフラグを引数として受け付けますが、GitHubのservicesブロックではコマンドを渡せません。実用的な方法は2つあります。ステップでdocker runを使ってMySQLを自分で起動し、--innodb-flush-log-at-trx-commit=0 --sync-binlog=0などのフラグを付けるか、optionsに--tmpfs /var/lib/mysqlを追加してデータベースをtmpfsに置きます。tmpfsの方法はシンプルで、ディスクの待ち時間をなくせます。どちらの方法も実データには決して使わないでください。
メモリ上のSQLiteはずっと高速ですが、MySQLとの違い(JSON関数、照合順序、外部キーの動作など)を隠してしまうことがあります。簡易なユニットテストのジョブでは使っても構いませんが、最終的な判定にはMySQLのジョブを使ってください。
フロントエンドのアセット
Viteのアセットが必要なページを描画するテストがある場合は、一度だけビルドしてください。npmはactions/setup-nodeにcache: npmを指定してキャッシュし、npm ciとnpm run buildを実行します。そしてpublic/buildフォルダをアーティファクトとして後続のジョブに渡し、各シャードで再ビルドしないようにしてください。API専用のテストジョブでは、Node関連のステップを丸ごとスキップしてください。
静的解析とスタイルチェックは専用のジョブで
Larastan(PHPStan)、Pint、Rectorはデータベースに依存しません。これらは別のジョブとして実行し、テストジョブと並行させてください。Pintは--testを付けると、ファイルを変更せずにチェックだけ行えます。PHPStanには結果をキャッシュするディレクトリがあり、actions/cacheでキャッシュすると再実行が速くなります。
ワークフロー全体の例
name: tests
on:
pull_request:
push:
branches: [main]
concurrency:
group: tests-${{ github.ref }}
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
jobs:
test:
runs-on: ubuntu-latest
timeout-minutes: 20
services:
mysql:
image: mysql:8.4
env:
MYSQL_ROOT_PASSWORD: password
MYSQL_DATABASE: laravel
ports: ["3306:3306"]
options: >-
--tmpfs /var/lib/mysql
--health-cmd "mysqladmin ping -h 127.0.0.1 -ppassword"
--health-interval 5s --health-timeout 5s --health-retries 15
env:
DB_CONNECTION: mysql
DB_HOST: 127.0.0.1
DB_DATABASE: laravel
DB_USERNAME: root
DB_PASSWORD: password
steps:
- uses: actions/checkout@v7
- uses: shivammathur/setup-php@v2
with:
php-version: "8.4"
extensions: mbstring, pdo_mysql, bcmath
coverage: none
- id: composer-cache
run: echo "dir=$(composer config cache-files-dir)" >> "$GITHUB_OUTPUT"
- uses: actions/cache@v6
with:
path: ${{ steps.composer-cache.outputs.dir }}
key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
restore-keys: ${{ runner.os }}-composer-
- run: composer install --prefer-dist --no-progress --no-interaction
- run: cp .env.example .env && php artisan key:generate
- run: php artisan test --parallel
CPU コア数を増やす効果
--parallelのデフォルトはコア数であるため、2 vCPUのホステッドランナーでは2プロセス、8 vCPUのマシンでは8プロセスになります。MySQLは同じマシン上で動作するため、コアを奪い合います。tmpfsを使用すると、データベースは主にCPUとメモリを消費しますが、これらはよくスケールします。ベンチマークにはPHPやLaravelの行がないため、数値は示しません。Turborepo + Next.js + tRPC + MySQLのスタック(3m29sから1m53s、1.9x、2026年10月8日)は別のフレームワークですが、こちらもMySQLを使用しています。
ご自身のテストスイートで試すには、1行をruns-on: [self-hosted, Linux, compiler-ci]に変更してください。詳しくは料金と比較をご覧ください。関連ページ: Laravelテンプレート、GitHub Actionsのキャッシュ、テストのシャーディング。
よくある質問
Laravelのテストを並列実行するには?
brianium/paratestを開発用の依存関係としてインストールし、php artisan test --parallelを実行してください。Pestを使う場合はpest --parallelを使います。各プロセスは独自のデータベースを持ちます。
GitHub Actionsでvendorをキャッシュすべきですか?
いいえ。Composerのダウンロードキャッシュをキャッシュし、composer installを実行してください。setup-phpのREADMEでは、vendorをキャッシュすると副作用が起こり得ると注意されています。
Xdebugが読み込まれていると、CIは遅くなりますか?
はい、読み込まれている場合は遅くなります。ジョブでカバレッジを出力しない限り、setup-phpでcoverage: noneを設定してください。カバレッジが必要な場合はpcovを使ってください。
並列実行したLaravelのテストがCIでのみ失敗するのはなぜですか?
多くの場合、共有状態が原因です。storage内のファイル、キャッシュされた値、テスト間で消去されないデータなどが考えられます。失敗しているテストを単独で実行し、次に--parallelを付けて実行し、原因を確認してください。
関連記事
- GitHub ActionsでTypeScriptモノレポを高速化するGitHub Actionsで TypeScriptモノレポの型チェックとリンターを高速化する: インクリメンタルtsc、プロジェクト参照、Lintキャッシュ、並列ジョブ
- GitHub ActionsでモノレポのPlaywrightを高速化するGitHub Actions で Node モノレポの Playwright E2E テストを高速化: アプリを一度だけビルドし、Web アプリに変更がないときは E2E をスキップし、シャーディングとレポートのマージを行います。
- READMEにCIの速度バッジを追加するREADME のバッジで CI の速さを表示しましょう。リポジトリの GitHub Actions 実行時間の中央値が自動で更新されます。公開リポジトリは無料です。
- GitHub Actionsで.NETを高速化するGitHub Actions で .NET のビルドを高速化する: setup-dotnet による NuGet キャッシュ、--no-restore、--no-build、並列の dotnet test、SQL Server サービス。