導入
Webアプリケーション開発において、データベースの接続情報やAPIキーなどの設定情報は、コードから切り離して管理するのが鉄則です。しかし、毎回ファイルを読み込んで配列を操作するのは冗長になりがちです。本記事では、ディレクトリを指定するだけで、ドット記法で直感的に設定値を取得できるConfigクラスの実装方法を解説します。この仕組みを導入することで、設定読み込みのコードがスッキリし、保守性が大幅に向上します。
基礎知識
PHPにおける設定管理で最も手軽かつ強力な方法は、連想配列をreturnするPHPファイルを利用することです。JSONやYAMLと異なり、PHPファイルとして実行されるため、パース処理が不要で非常に高速です。また、Configクラスを「スタティッククラス」として設計することで、アプリケーションのどこからでもインスタンス化せずに設定へアクセスできるようになります。
実装/解決策
今回紹介する実装のポイントは、`preg_split`を用いた文字列の分解です。`app.db.host`のような文字列が渡された際、これをドットで分割し、末尾の要素をキー、残りをファイルパスとして解釈させることで、ネストされたディレクトリ構造にも柔軟に対応できる設計にします。
サンプルプログラム
以下は、汎用性を高めたConfigクラスの実装例です。
/
public static function get($route) {
$parts = preg_split(‘/\./’, $route, -1, PREG_SPLIT_NO_EMPTY);
$targetKey = array_pop($parts); // 最後の要素が配列のキー
// 残りの要素をパスとして組み立てる
$filePath = self::$directory . DIRECTORY_SEPARATOR . implode(DIRECTORY_SEPARATOR, $parts) . ‘.php’;
if (!file_exists($filePath)) {
throw new Exception(“設定ファイルが見つかりません: {$filePath}”);
}
// ファイルを読み込み配列を取得
$config = include($filePath);
return $config[$targetKey] ?? null; // キーが存在しない場合はnullを返す
}
}
// — 使用方法 —
// 1. ディレクトリ指定
Config::set_config_directory(__DIR__ . ‘/config’);
// 2. 値の取得
$url = Config::get(‘app.url’);
?>
応用・注意点
実務レベルでの運用にはいくつか注意が必要です。
1. キャッシュの検討: 大規模なアプリケーションでは、毎回`include`を行うとファイルシステムへの負荷がかかります。本番環境では、読み込んだ設定をスタティック変数に保持（メモ化）して、2回目以降のアクセスを高速化する実装を追加することを推奨します。
2. セキュリティ: 設定ファイル内にはパスワードやシークレットキーが含まれます。これらのファイルは、Webサーバーの公開ディレクトリ（public_html等）の外側に配置するようにしてください。
3. バリデーション: `include`した結果が必ずしも配列であるとは限りません。ファイルが破損している場合に備えて、`is_array()`で型チェックを行う処理を`get`メソッド内に加えると、より堅牢なプログラムになります。