レガシーPHPからの脱却：Laravel 12 × Filamentで作る爆速・管理画面構築チュートリアル

はじめに（結論）
1. なぜ「Filament」がレガシー移行の最適解なのか？
2. 実践：Laravel × Filamentの基礎構築ステップ
3. 次のステップ：既存コードの移行と「資産化」

はじめに（結論）

終わりの見えないレガシーシステム（古いバージョンのPHPやCakePHPなど）の保守作業に、時間を奪われ続けていませんか。

システムをモダン化（リプレイス）したくても、「一から管理画面やCRUD機能を作り直す工数が捻出できない」という理由で、手作業でのツギハギ保守を続けている現場は少なくありません。

結論から言えば、現在のPHP開発において、管理画面や社内システムをゼロから手書きするのは時間とコストの浪費です。レガシーからの移行先として現在最も機能的で、圧倒的な開発スピードを誇るのが「Laravel 12 × Filament」の組み合わせです。

本記事では、レガシー脱却の第一歩となる、LaravelとFilamentを用いたモダンな管理画面の基礎構築手順を解説します。過去のサンクコストを捨て、効率と利益を最優先する開発環境を手に入れましょう。

1. なぜ「Filament」がレガシー移行の最適解なのか？

Filamentは、Laravel向けに作られたTALLスタック（Tailwind CSS, Alpine.js, Laravel, Livewire）ベースの強力な管理画面構築フレームワークです。

圧倒的な開発スピード: 数行のコマンドとクラス定義だけで、検索・ソート・ページネーション付きの高機能なデータ一覧表（テーブル）や入力フォームが完成します。
モダンなUI/UX: レガシーシステムにありがちな「使いにくい古い画面」から、最新の洗練されたUIへ一気に引き上げることができます。
保守性の向上: 独自の複雑なビュー（HTML/CSS）を書く必要が減るため、属人化を防ぎ、将来的なメンテナンスコストを劇的に下げます。

移行先の「受け皿」としてFilamentを用意することで、リプレイスプロジェクトの要件定義から実装までのリードタイムを大幅に短縮できます。

2. 実践：Laravel × Filamentの基礎構築ステップ

それでは、実際にまっさらな状態から管理画面のベースを構築する手順を見ていきましょう。

Step 1: Laravelプロジェクトの作成

まずは最新のLaravelプロジェクトを作成し、データベースの接続設定（.env）を済ませます。

composer create-project laravel/laravel legacy-migration-app
cd legacy-migration-app
php artisan migrate

Step 2: Filamentのインストール

次に、Filamentのコアパッケージをインストールします。

composer require filament/filament:"^3.2" -W
php artisan filament:install --panels

この時点で、/admin というURLにアクセスすれば、すでに美しいログイン画面とダッシュボードが生成されています。管理画面のベース構築はこれだけで完了です。

Step 3: リソース（CRUD画面）の生成

例として、古いシステムから移行する「顧客データ（Customer）」の管理画面を作ってみましょう。モデルとマイグレーションを作成後、以下のFilamentコマンドを実行します。

php artisan make:filament-resource Customer

この1行のコマンドにより、app/Filament/Resources ディレクトリにファイルが生成され、サイドバーに「Customers」メニューが自動追加されます。あとは生成されたクラス内に、表示したいカラムやフォームのフィールドを定義するだけで、フル機能のCRUD画面が完成します。

3. 次のステップ：既存コードの移行と「資産化」

LaravelとFilamentを使えば、驚くほど簡単にモダンな「受け皿」を作れることがお分かりいただけたと思います。しかし、本当の課題は「既存の膨大なレガシーコードやビジネスロジックを、どうやってこの新しい環境に移行するか」です。

■ 既存コードの自動一括置換（Zenn）
手作業で古いコードをLaravel用に書き換えるのは非現実的です。私は「Antigravity CLI」と「Conductor」を使い、AIによる全域ファイル一括置換を自動化しています。具体的なコマンドや設定ファイル（YAML）の書き方については、技術ログとして「Zennの記事」で公開しています。手作業をゼロにしたい方は参考にしてください。

■ 移行ノウハウを高単価案件に変える戦略（note）
最新環境の構築スキルと自動化ラインを手に入れたら、それを「労働の切り売り（単なる保守）」ではなく、「高単価なリプレイス案件」としてクライアントに提案しましょう。システム移行をあなた独自の「資産」に変え、利益を最大化するための具体的なビジネス戦略については、「noteの有料記事」にて詳細に解説しています。

最新のツールを駆使し、レガシーシステムという負債を、あなた自身の強力な武器へと変えていきましょう。