| 前 / 次 / てくめも@coop |
他所様のコードを見ていると、
require '../include/conf.php';
などというように(./ や ../ を含む)相対パス指定しているのを見掛けるのですが、これには落とし穴があります。
たとえば上のコードが書いてあるファイルが script/foo.php だとします。
別のディレクトリから foo.php を include したいと思い、
public_html/main.php で
> require '../script/foo.php';
とすると、
Fatal error:main(../include/conf.php)[function.main]: failed to open sream: No such file or directory at ...
のようなエラーが出て正常に動作しない、という結果になります。
これは PHP では�カレントディレクトリが、常に実行したファイル(Webからアクセスしたファイル)のあるフォルダになるため、相対パスの表す場所が include 元によって変わってしまうためです。これを回避するには次のように、常に、現在のファイルのフルパスを表す定数文字列(__FILE__ )と、親ディレクトリのパスを求める関数(dirname())を使い、常に同じ場所を表すように明示的に絶対パスに変換して指定する必要があります。たとえば最初の require は次のようにおきかえられます。
require dirname(__FILE__).'/../include/foo.php';
// dirname() の末尾はディレクトリ区切り文字('/') が付かない事に注意
これで、別ディレクトリからでも問題なくインクルードできるようになります。
特にライブラリや設定ファイルなど、インクルードされるのが目的のクラスでは、おまじないのつもりで相対パスに dirname(__FILE__) を書く習慣をつけると幸せになるかもしれません。
ただし例外として、'./' や '../' を含まない相対パスについては、この問題は発生しません(参考:include())。
読み込むファイルはまずカレントのワーキングディレクトリからの相対パスとしてinclude_path で探され、それから、カレントのスクリプトのディレクトリからの相対パスとしてinclude_path で探されます。 例えば、include_pathが .で、カレントの ワーキングディレクトリが /www/ の 場合、include/a.php を読み込んで、そのファイルの中に include "b.php" と書いてあったとすると、 b.php がまず /www/で探され、その後、 /www/include/で探されます。 ファイル名が ./ あるいは ../ で始まっている場合は、 カレントのワーキングディレクトリからの相対パスとしてinclude_path で探されるのみとなります。(引用元: PHPマニュアル - include())
追記:
- 2006-05-23 - ../, ./ を含まない場合について説明追加。
| 前 / 次 / てくめも@coop |