Smartyでテンプレートの場所を指定する方法

質問

Smartyでテンプレートファイルの場所を指定するいい方法を教えてください。

公式マニュアルには基本的には(1)のようにやるのだと書いてあります。そして拡張セットアップとして(2)の方法が紹介されています。これなら「ディレクトリパスの設定を同じ変数に何度も割り当てる代わりに、一箇所でそれらを行う事が出来ます」とのことですが…。

しかし拡張セットアップの方法でも、プログラムファイル(.php)の中に環境依存の値を記述しています。私はJava開発の経験はあり、PHP開発の経験は無く、現在は趣味の範囲でPHPをやっています。

で、Javaの経験からすると、環境依存の値も設定ファイルのパスもプログラムファイルに書くことはまず無いので、(2)の方法でも気持ち悪く感じます…。また「ページを呼び出すたびに毎回setup.phpを呼ぶの？サーバー起動時に読み込むべき値・ファイルだろうが…」とも思ってしまいます。

…しかし私がどう感じるかは別として、実際の開発の現場ではどうすることが多いのか知りたくて質問をする事にしました。

質問は以下です。
[a]Smartyのテンプレートファイルのパスなどは、どこにどう書くことが多いのか？
[b]Smartyに限らず、PHPという言語では、環境設定の値や設定ファイルのファイル名やパスを、プログラムファイル(.php)に書くのがあたりまえなのか？どうすることが多いのか。
[c]PHPではプログラムで使う値として、サーバー起動時に設定値・設定ファイルを読み込む一般的な仕組みがあるか？(サーバー設定値でもないのにphp.iniに書いてini_getで取得するなんてことが許される？他にもっとスマートな方法がある？)

※具体的な例を挙げて教えていただけると助かります。また、「あまりやらないけど、こうやったこともあるよ」などというイレギュラーなケースも教えていただけるとうれしいです。

よろしくお願いします。

--(1)index.php---------------------------------------------
<?php
require_once(SMARTY_DIR . 'Smarty.class.php');
$smarty = new Smarty();

$smarty->template_dir = '/web/www.example.com/guestbook/templates/';
$smarty->compile_dir = '/web/www.example.com/guestbook/templates_c/';
$smarty->config_dir = '/web/www.example.com/guestbook/configs/';
$smarty->cache_dir = '/web/www.example.com/guestbook/cache/';

$smarty->assign('name','Ned');
$smarty->display('index.tpl');
?>
-----------------------------------------------------------
基本的なインストール | Smarty
http://www.smarty.net/docs/ja/installing.smarty.basic.tpl

--(2)setup.php---------------------------------------------
<?php
require('Smarty.class.php');
class Smarty_GuestBook extends Smarty {
function __construct() {
parent::__construct();
$this->template_dir = '/web/www.example.com/guestbook/templates/';
$this->compile_dir = '/web/www.example.com/guestbook/templates_c/';
$this->config_dir = '/web/www.example.com/guestbook/configs/';
$this->cache_dir = '/web/www.example.com/guestbook/cache/';
$this->caching = Smarty::CACHING_LIFETIME_CURRENT;
$this->assign('app_name', 'Guest Book');
}
}
?>
--(2)index.php---------------------------------------------
<?php
require('guestbook/setup.php');
$smarty = new Smarty_GuestBook();
$smarty->assign('name','Ned');
$smarty->display('index.tpl');
?>
-----------------------------------------------------------
拡張セットアップ | Smarty
http://www.smarty.net/docs/ja/installing.smarty.extended.tpl

回答No.1

JaneDue · ベストアンサー

Javaは分かりませんが、PHPではファイルの置場所も任意ですから、まず冒頭部分では define();とrequire()がずらずらと何行も並ぶ事は普通です。(スクリプト内での使用時にrequireしても動きますが、見通しが悪くなるため先頭にまとめて書くのが慣例)

一応ライブラリなどはパスを通しておけばファイル名だけで済みます。
set_include_path("/path/mylib");
require("aaa.php");
require("bbb.php");
http://jp2.php.net/manual/ja/function.set-include-path.php

または、未定義のクラスが呼ばれた場合に発動する spl_autoload_register()関数があり、
function my_autoload($className) {
include_once($className.'.class.php');
}
spl_autoload_register('my_autoload');
などとしておけば、いちいちrequireせず、いきなり
$obj = new OBJ();
と書くこともできます。
http://jp2.php.net/manual/ja/language.oop5.autoload.php
主要なファイル群はrequireし、それ以外はspl_autoload_register()、と併用してもよいかと。

回答としては
[a]>Smartyのテンプレートファイルのパスなどは、どこにどう書くことが多いのか？
素直なのは設定ファイルにて
define('SMARTY_TEMPLATE_PATH','/path/template');
と表に出しておいて、[拡張セットアップ]のようにViewのコンストラクタやメンバ変数で当てる事になるかと。

[b]>プログラムファイル(.php)に書くのがあたりまえなのか？
分かりやすくするため、設定部分を config.phpとか 更に規模に応じて defines.php, requires.php と切り分けたり、拡張子を .inc /.inc.php等にしたりすることもありますが、基本的にはそうなります。

[c]>サーバー起動時に設定値・設定ファイルを読み込む一般的な仕組みがあるか？
Webサーバなので「要求があった時」になりますが.htaccessにて
php_value auto_prepend_file /path/setup.php
とすれば、当該ディレクトリ以下で自動的に実行されます。
http://www.php.net/manual/ja/ini.core.php#ini.auto-prepend-file

また、任意の値を環境変数として欲しいなら、.htaccessにて
SetEnv SMARTY_DIR /path/Smarty/libs
とすれば、$_SERVER['SMARTY_DIR']で取得できることはできます。

※ただし現在主流のMVCでは、何千ページあろうと全てコントローラを通りrequireを記述する場所は1個所でそこに記述すればよいので、上.htaccessを使う方法はあまり意味がありません。また設定が散らかる・環境変数を汚す等の理由で嫌う人もいます。
ちなみにphp.iniはレンタルサーバでは触る権限がない事も多く、php.iniの編集が必要な仕様にすることはまずありません。

ご参考になれば。

お礼

>PHPではファイルの置場所も任意ですから、まず冒頭部分では
>define();とrequire()がずらずらと何行も並ぶ事は普通です。

>[b]>プログラムファイル(.php)に書くのがあたりまえなのか？
>…基本的にはそうなります。

なるほど…。PHPはそういう文化なのですね…。
Javaではファイル名・ファイルパスなど環境依存の値をプログラムファイルに書くことはまず許されませんし「もしもそのファイル名が変わったら」などと思うと全ファイルを修正するのかと恐ろしくもなりますが、PHPにJavaの文化を持ち込まずにPHPの慣例に従おうと思います。参考になります。

>[a]>Smartyのテンプレートファイルのパスなどは、どこにどう書くことが多いのか？
>素直なのは設定ファイルにて
>define('SMARTY_TEMPLATE_PATH','/path/template');
>と表に出しておいて、[拡張セットアップ]のように
>Viewのコンストラクタやメンバ変数で当てる事になるかと。

なるほど。そのようにします。

>Webサーバなので「要求があった時」になりますが.htaccessにて
>php_value auto_prepend_file /path/setup.php
>とすれば、当該ディレクトリ以下で自動的に実行されます。

一応、近い仕組みがあるのですね。AOPが簡単に実現できるというわけですね。これは便利ですね。でも最近はCakePHPとかのフレームワークを使って、別の仕組みで実現するので使用する機会は少ないという感じですかね。なるほど。

今回は初めてPHPをつかう事とDBすら使わない内容なので、フレームワークは使わないことにしました。なので今回はとりあえず「.htaccess」を使う方法を試してみようと思います。しかし、次に作るものではDBを使用するためフレームワークを使用してみようと思います。

質問の意図を十分に汲み取り、また一つ一つ丁寧に答えていただき大変参考になりました。大変助かりました。ありがとうございました