phpインクルードで取得するドキュメントルートのパスを.htaccessで変更したい

Question

htmlの共通ファイルをphpインクルードで読み込んで運用しています。

<?php include($_SERVER['DOCUMENT_ROOT']."/include/header.html");?> <?php include($_SERVER['DOCUMENT_ROOT']."/include/footer.html");?>

.htaccessでサブディレクトリをルートディレクトリに変更は可能でしょうか。

テストディレクトリは/test/をルートディレクトリにしたく、上記の質問を参考にルートディレクトリのパスを変更しました。
htmlやcssのパスはうまく変更されたのですが、phpインクルードだけは元の/がルートのままになっています。
$_SERVER['DOCUMENT_ROOT']も/test/をルートとしたいです。

.htaccessとphpの読み込み（実行）の順番などは制御できるのでしょうか？
一括で変更できるのであれば.htaccessを使ったやり方でなくても良いです。
詳しい方、ご教示いただけると幸いです。

Comments

[arcxor]

> $_SERVER['DOCUMENT_ROOT']も/test/をルートとしたいです。

これは何故ですか？ setEnv で APPLICATION_ROOT などと独自の変数を定義するのでは駄目なのでしょうか。あるいは、独自のユーティリティクラスなどを用意して getDocumentRoot() などとメソッドを自作するのでは駄目なのでしょうか。

この質問の意図をもう少し教えていただけませんか。

[suzienuzie]

ご質問ありがとうございます。
なぜこうしたいのかというと、先に書いたとおりhtmlの共通部分をphpインクルードで読み込むようにしており、テストアップする際の手間を省きたいが為です。
testディレクトリの中身は本番のルートディレクトリと同じ構造になっており、testディレクトリにアップ→自動的にtestをルートとした内容になればいちいちパスを修正したりする必要がないため効率化できるかと考えました。

[suzienuzie]

arcxor様
ご回答ありがとうございます！
当方phpはWordpressのカスタマイズでhtml内に記述する程度で、あまり詳しくなく、ご回答いただいた内容も良く理解できておりません・・・
今回の質問もhtml内に<?php include($_SERVER['DOCUMENT_ROOT']."/include/header.html");?>のコードを書いています。
本来はこういう方法を採らなくても済むように〜の部分をもう少し掘り下げて教えていただけないでしょうか・・・
・.htaccessから間接的に上書きする方法はよろしくないのでしょうか？それに比べてユーティリティクラスを使うメリットはありますでしょうか？（速度など？）
・例えば Util::$_SERVER の値が設定されていればその値を〜のところをもう少し具体的に教えていただけないでしょうか。（.phpファイルを置いてrequire_onceとかで読み込み？

Answer 1

直接的に .htaccess 側から $_SERVER の既存の値を上書きすることはできないと思いますが、間接的に上書きする方法は考えられます。

$ cat .htaccess 
php_flag display_errors on
php_value auto_prepend_file config.php

$ cat config.php 
<?php
$_SERVER['DOCUMENT_ROOT'] .= '/test';

test ディレクトリ内の .htaccess で php_value auto_prepend_file を記述して、test ディレクトリ内の php にアクセスした際に config.php （ファイル名は任意）を読み込むようにします。

test ディレクトリ内に config.php を設置し、$_SERVER['DOCUMENT_ROOT'] にサブディレクトリにパスを追加して変数の値を上書きします。

---

本来はこういう方法を採らなくても済むように、$_SERVER 値などは直接参照せず、ユーティリティクラスメソッドなどを経由して取得するようにして、デバッグ環境での変数のオーバーライトなどが容易にできるように設計するほうが好ましいかもしれません。例えば Util::$_SERVER の値が設定されていればその値を、設定されていなければ $_SERVER を参照するといった具合です。

追記

今回の質問もhtml内に<?php include($_SERVER['DOCUMENT_ROOT']."/include/header.html");?>のコードを書いています。
本来はこういう方法を採らなくても済むように〜の部分をもう少し掘り下げて教えていただけないでしょうか・・・

今回のように多少ややこしいことをやりたい場合は、予めややこしいことができるような設計に基づいた実装をすべきだということです。

・.htaccessから間接的に上書きする方法はよろしくないのでしょうか？それに比べてユーティリティクラスを使うメリットはありますでしょうか？（速度など？）

自動生成される $_SERVER['DOCUMENT_ROOT'] の値を変更する（捻じ曲げる）というのはバグの温床にもなり本来は推奨されない方法です。

ただし、今回のように test 環境で設定値を変更したいような、一時的でその場しのぎをしたい場合であれば、$_SERVER['DOCUMENT_ROOT'] の値を変更してしまう方法でもまあ良いのではないでしょうか。

・例えば Util::$_SERVER の値が設定されていればその値を〜のところをもう少し具体的に教えていただけないでしょうか。（.phpファイルを置いてrequire_onceとかで読み込み？

クラスやヘルパー関数のファイルやを用意する場合は、使う側で require_once などで読み込みます。実際のサイトのファイル構成などが分かりませんが、ページ数が大量にあってディレクトリ階層も異なるような場合は「Front Controller パターン」で実装することが多いと思います。動的な処理は Front Controller のファイルに任せて、ページごとに異なるHTMLソースコードは View として持っておくというものです。MVCパターンの簡易的な実装です。この説明が何を言っているのか意味がわからなければ MVC パターンについて調べてみてください。

ユーティリティクラスで云々というのも、ページ数が多い場合は Front Controller パターンでの実装を前提としたものになるため（そうでなければ、各ページファイルでそれぞれ Util を読み込む必要が出てしまう）、いきなり Util クラスでの実装例を説明してもしょうがない気がしますが、一応書いておきます。

before

<?php include($_SERVER['DOCUMENT_ROOT']."/include/header.html");?>

<?php include($_SERVER['DOCUMENT_ROOT']."/include/footer.html");?>

after

class Util {
  public static $_SERVER = [];

  public static function getServerParam($key) {
    return array_key_exists($key, self::$_SERVER) ? self::$_SERVER[$key] : $_SERVER[$key];
  }

  public static function includePartial($file) {
    $includeFilePath = sprintf('%s/include/%s', self::getServerParam('DOCUMENT_ROOT'), $file);
    include($includeFilePath);
  }
}

<?php require_once(__DIR__.'/Util.php'); // Util.php への正しいパスを書く ?>
<?php includePartial('header.html'); ?>

<?php includePartial('footer.html'); ?>

test ディレクトリ以下の場合

class Util {
  public static $_SERVER = [
    'DOCUMENT_ROOT' => 'ここに書き換え後のパスを書く',
  ];

  public static function getServerParam($key) {
    return array_key_exists($key, self::$_SERVER) ? self::$_SERVER[$key] : $_SERVER[$key];
  }

  public static function includePartial($file) {
    $includeFilePath = sprintf('%s/include/%s', self::getServerParam('DOCUMENT_ROOT'), $file);
    include($includeFilePath);
  }
}

とするなり、Util::getServerParam() の実装を変えて .htaccess からのカスタムパラメータを受け付けるようにするなりすれば php_value auto_prepend_file を書くようなことをしなくても済むということです。

Comments

[suzienuzie]

再度のご回答本当にありがとうございます！大変勉強になりました。
MVCパターンについても調べてみました。Webアプリの設計思想的な感じですかね？
多分今回私がやりたかったことについてここまでやるのはコストがかかりすぎるかなと思うので、その場凌ぎで教えていただいた方でやってみます。