レガシーPHPで動く社内システムをスクラッチで作り直さずにAPI化し、Next.jsなどのモダンフロントエンドと連携させる現実的なアプローチを解説します。
「動いてるから触りたくない」そのシステム、いつまで放置しますか?
こんな悩みはありませんか?
- 10年以上前にベンダーに作ってもらったPHPの社内システムが今も稼働している
- フロントエンドだけリニューアルしたいが、バックエンドに手を入れるのが怖い
- 新しいReact・Next.jsアプリからデータを参照したいが、連携方法がわからない
- スクラッチで作り直す予算も時間もない
「動いてるから触りたくない」という気持ちはよく理解できます。しかし、モダンなフロントエンド資産を活かすためには、どこかでバックエンドとの接続口を整備する必要があります。
Fivenineでは神奈川の中小企業を中心に、こうしたレガシーシステムのAPI化を複数件手がけてきました。本記事では、システム全体を作り直すことなく、既存のPHPコードを活かしながらAPIを追加する現実的な手順を解説します。
なぜ古いPHPシステムはそのままフロントと繋げられないのか
レガシーPHPの典型的な構造
2000年代〜2010年代前半に作られたPHPシステムの多くは、画面描画とビジネスロジックが一つのファイルに混在しています。たとえばこんな構造です。
// order_list.php(典型的なレガシーコード)
<?php
$conn = mysql_connect("localhost", "user", "pass"); // 非推奨関数
$result = mysql_query("SELECT * FROM orders WHERE status = 1");
?>
<html>
<body>
<?php while ($row = mysql_fetch_array($result)) { ?>
<tr><td><?php echo $row['order_id']; ?></td></tr>
<?php } ?>
</body>
</html>
mysql_*関数(PHP 7で削除済み)の使用、HTMLとPHPの混在、認証処理の散在——こうした構造では、外部からJSON形式でデータを取得することができません。
モダンフロントが求めるもの
Next.jsやReactは、バックエンドに対してREST APIまたはGraphQL経由でJSONデータを要求します。つまり「HTMLを返すシステム」と「JSONを返すAPI」という根本的なミスマッチが生じているのです。
このギャップを埋める方法はいくつかありますが、既存システムを壊さずに段階的に進めるアプローチが最も現実的です。
現実的なAPI化の3ステップ
STEP 1:APIゲートウェイとなるLaravelを既存システムの隣に設置する
おすすめのアーキテクチャは、既存のPHPシステムには手を触れず、LaravelをAPIゲートウェイとして並列配置する方法です。
flowchart LR
A[Next.js フロントエンド] -->|HTTPS / JSON| B[Laravel API Gateway]
B -->|直接DB参照 or HTTP| C[既存PHPシステム]
C --- D[(既存DB)]
B --- DLaravelは同じDBに読み取り専用で接続し、既存システムの書き込みロジックには干渉しません。これにより、既存システムの安定稼働を維持しながら、新しいAPIエンドポイントを段階的に追加できます。
あるクライアント(神奈川県内の製造業、従業員50名)では、在庫管理システムをこの方式でAPI化しました。既存のPHPシステムには一行も手を加えず、LaravelをAPIサーバーとして追加設置。フロントをNext.jsでリニューアルした結果、在庫確認にかかる操作ステップが5ステップから2ステップに削減され、現場スタッフの日次作業時間が約40分短縮されました。
STEP 2:既存DBへの接続を.envで安全に管理する
Laravelの.envファイルで既存DBへの接続を設定します。
# .env(Laravelプロジェクト)
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=legacy_system_db
DB_USERNAME=readonly_user # 読み取り専用ユーザーを推奨
DB_PASSWORD=your_password
必ず読み取り専用のDBユーザーを作成することがポイントです。APIゲートウェイからの意図しない更新を防ぐための安全策です。
STEP 3:APIエンドポイントを実装する
LaravelのRouteとControllerでAPIを定義します。
<?php
// routes/api.php
use App\Http\Controllers\OrderController;
use Illuminate\Support\Facades\Route;
Route::middleware('auth:sanctum')->group(function () {
Route::get('/orders', [OrderController::class, 'index']);
Route::get('/orders/{id}', [OrderController::class, 'show']);
});
Laravel Sanctumを使ったトークン認証を挟むことで、外部からの不正アクセスを防ぎます。これだけで既存PHPシステムは一切変更せず、Next.jsからデータを取得できるようになります。
よくある失敗パターンと対処法
失敗①:最初から全機能をAPI化しようとする
「せっかくだから全部まとめてAPI化しよう」という判断が、プロジェクトを頓挫させる最大の原因です。先述の製造業クライアントでも一度この罠にはまりかけました。最初のスコープを「在庫の参照APIだけ」に絞ったことで、2週間でリリースできました。まず最もよく使われる参照系エンドポイント1〜2本だけを作ることを強く推奨します。
失敗②:CORS設定を後回しにする
Next.jsのフロントエンドとLaravel APIが別ドメイン(またはポート)で動く場合、CORS(クロスオリジンリソース共有)の設定が必須です。設定漏れはブラウザのコンソールにエラーが出るだけで、原因特定に時間を取られます。
// config/cors.php
'allowed_origins' => [
'https://your-nextjs-app.vercel.app',
'http://localhost:3000', // 開発環境
],
Laravelはconfig/cors.phpで管理できるので、プロジェクト立ち上げ時に必ず設定しておきましょう。
失敗③:既存システムのDBスキーマをそのままレスポンスに返す
古いシステムのカラム名はord_cust_nmのように省略されていたり、不要な内部管理カラムが含まれていることがあります。これをそのままフロントに返すのは、セキュリティ面でもメンテナンス面でも危険です。ControllerかResourceクラスで必ず必要なフィールドだけを選択・リネームしてから返す習慣をつけてください。
PHP・サーバー無料診断
自分のサイトは大丈夫?と思ったら
URLを送るだけで、SSL証明書・WordPressのバージョン・サーバー情報の漏れなど、外から分かる範囲を無料でお調べします。3営業日以内に結果をメールでお送りします。
まとめと次のステップ
古いPHPシステムを全面的に作り直さなくても、LaravelをAPIゲートウェイとして並置するアプローチで、モダンフロントエンドとの連携は十分に実現できます。重要なのは「スコープを絞って小さく始める」こと。最初の成功体験が次の改善の原動力になります。
「うちのシステムで同じことできる?」「どこから手をつければいい?」という疑問があれば、ぜひFivenine Designにご相談ください。既存システムのコードを拝見した上で、現実的なAPI化のロードマップをご提案します。