バックエンド 2026.11.20

PHPの古い社内システムをAPI化してモダンフロントと連携する現実的な方法

約4分で読めます

レガシーPHPで動く社内システムをスクラッチで作り直さずにAPI化し、Next.jsなどのモダンフロントエンドと連携させる現実的なアプローチを解説します。

「動いてるから触りたくない」そのシステム、いつまで放置しますか?

こんな悩みはありませんか?

  • 10年以上前にベンダーに作ってもらったPHPの社内システムが今も稼働している
  • フロントエンドだけリニューアルしたいが、バックエンドに手を入れるのが怖い
  • 新しいReact・Next.jsアプリからデータを参照したいが、連携方法がわからない
  • スクラッチで作り直す予算も時間もない

「動いてるから触りたくない」という気持ちはよく理解できます。しかし、モダンなフロントエンド資産を活かすためには、どこかでバックエンドとの接続口を整備する必要があります。

Fivenineでは神奈川の中小企業を中心に、こうしたレガシーシステムのAPI化を複数件手がけてきました。本記事では、システム全体を作り直すことなく、既存のPHPコードを活かしながらAPIを追加する現実的な手順を解説します。


自分のサイトは古いPHPのままになっていませんか?

URLを送るだけで、外から分かる範囲の危ないところを無料でお調べします

無料で診断する

なぜ古い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 --- D
mermaid

Laravelは同じ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化のロードマップをご提案します。

この記事をシェア

システム開発のご相談、受付中です

設計・開発・テスト・運用まで、ビジネスに合ったシステムを構築します。 初回相談は無料です。

※ 1営業日以内にご返信いたします

この技術でお困りなら

無料でプロに相談できます

相談する
AIに無料相談