本番環境とローカル環境の設定を分ける方法

ローカルでは動くのにロリポップ本番で止まる時は、コードそのものよりも、DBホスト名、URL、ファイルパス、エラー表示、メール送信先などの環境差が原因になりがちです。

この記事では、自作PHPサイトを公開する前に、ローカル、本番、GitHubへ置く設定を分ける考え方を整理します。目的は「本番パスワードをGitHubに上げない」「ローカル用設定を本番へ上書きしない」「本番だけのファイルを消さない」ことです。

設定を混ぜないための分け方

共通コードはGitHubで管理し、ローカル専用と本番専用の秘密情報はそれぞれの環境だけに置きます。

分けるべき設定

おすすめのファイル構成

共通処理と秘密情報を分けると、GitHubへ上げるもの、FTPで本番へ置くものを判断しやすくなります。

includes/
  app_config.php
  app_config.local.php
  app_config.production.php
  app_config.example.php

共通設定ファイルの例

環境名を見て、ローカル用か本番用の設定を読み込む形にします。実際のDBパスワードは別ファイルへ置きます。

<?php
$is_local = in_array($_SERVER['HTTP_HOST'] ?? '', ['localhost', '127.0.0.1'], true);

$config_file = $is_local
  ? __DIR__ . '/app_config.local.php'
  : __DIR__ . '/app_config.production.php';

if (!is_file($config_file)) {
  exit('設定ファイルが見つかりません。');
}

require $config_file;

.gitignoreに入れるもの

秘密情報、ログ、バックアップ、ローカルだけのメモはGitHubに上げません。公開フォルダへ置く場合も、外から見えない場所にするかアクセス制限を確認します。

includes/app_config.local.php
includes/app_config.production.php
*.log
backup/
.env

本番へ上書きしないもの

FTPでアップロードする時は、ローカル側の設定ファイルで本番ファイルを上書きしないようにします。

• 本番のDB接続情報が入った設定ファイル
• 本番だけで使う .htaccess
• 本番だけにあるアップロード画像やログ
• 問い合わせフォームの本番送信先
• Search Consoleや認証用のHTMLファイル

公開前チェック

関連記事

• PHPのDB設定を安全に分ける方法
• WordPressではない自作PHPサイトを公開する手順
• サブドメインでテスト環境を分ける方法
• ロリポップでPHP includeが本番だけ読み込めない時の確認順番
• FTPで削除してはいけないファイル一覧