页面

2010年12月18日

smarty模板目录结构与路径问题的解决与探讨!

#wiki
参考此帖:http://community.csdn.net/Expert/topic/4127/4127267.xml?temp=.1616327 
1.背景 
        最近在开发一套系统,采用了smarty模板。根据不同用户,要用不同模板,为了方便修改和维护,将每一套模板都放在templates目录下作为一个目录存在,如默认模板为templates/default。而且系统规模较大,后期需要不断扩展功能,所以并没有把所有代码和模板都放在根目录下,而是分别为不同的功能建立不同的子目录或孙目录,如user目录存放与用户相关文件,system目录存放与系统相关的文件,templates/default/system/system_info.tpl是系统信息默认模板文件。 

2.系统目录结构 
大致如下 
root 
|--includes     (系统包含文件) 
|--templates (模板文件) 
|--default
|--css 
|--images 
|--user 
|--system 
|--system_info.tpl 
|--blue
|--css 
|--images 
|--user 
|--system 
|--system_info.tpl 
|--templates_c
|--cache 
|--js
|--smarty (smarty所有类文件) 
|--user
|--system (与系统相关的文件) 
|--system_info.php 

3.问题 
1).最初在模板文件中使用了绝对路径(相对于站点根的路径   ).如在system_info.tpl中图片是这样显示的 
<img   src= "/templates/default/images/logo.gif "/> 
这样当系统发布时,必须要把系统目录作为网站的根目录图片才能正确显示。但客户的要求是该系统可能 
只是一个虚拟目录或者子目录。这样网站必布时就必须修改图片路径为真实路径。如果文件很多,这种修改 
就很麻烦(虽然可以用文件替换功能)。但是如果有N个客户,每个客户N个模板... 

2).将模板文件修改如下 
<img   src= "{$URL_ROOT}/templates/default/images/logo.gif "/> 
$URL_ROOT在一个全局配置文件中设置。这样只要改变$URL_ROOT的值就搞定了,:)。 
客户问:如果我改变了根目录的位置,或者换了域名,或者...?我们不希望自己去修改任何配置! 

3).模板文件不变 
  <img   src= "{$URL_ROOT}/templates/default/images/logo.gif "/> 
  在每个目录下新建一个url_root.php文件,存放当前目录到根目录的相对路径。 
  如system/url_root.php如下 
  
  <?php 
  $URL_ROOT   =   ".. ";//根目录在上一层目录 
  ?> 
  每次访问目录下的一个文件时,require当前目录下的url_root.php取得该文件到根目录的路径。然后在smarty中 
  $tpl-> assign( "URL_ROOT ",$URL_ROOT);就可以了 
  但是如果有很多文件,每个都加的话,修改维护起来也麻烦。 
  所以把这个操作封装到smarty的子类中,只修改一个文件就可以了。 
  
  includes/MySmarty.php   文件内容如下: 

<?php 
//定义服务器中的根目录的绝对地址 
define( "WEB_ROOT ",realpath(dirname(__FILE__). "/.. ")); 
//加载smarty类文件 
require_once(WEB_ROOT. "/smarty/Smarty.class.php "); 
//扩展smarty类 
class   MySmarty   extends   Smarty 

function   MySmarty() 

$this-> Smarty(); 
                $this-> template_dir   =   WEB_ROOT. '/templates/default/ ';   
                $this-> compile_dir     =   WEB_ROOT. '/templates_c/ ';   
                $this-> config_dir       =   WEB_ROOT. '/configs/ ';   
                $this-> cache_dir         =   WEB_ROOT. '/cache/ ';   
                $this-> caching   =   false; 
                //加载引用当前类的文件所在的目录到根目录的相对地址 
                require_once( "./url_root.php ");   
                //为模板路径赋值 
                $this-> assign( "URL_ROOT ",$URL_ROOT); 
                $this-> assign( 'app_name ',   'OA   System ');   


?> 
  这样系统中的任何一个使用模板的文件不需要修改,就可以直接给URL_ROOT赋值了. 

4.总结 
用smarty使用多套模板时,绝对路径,相对路径,界面可视化是个令人头疼的问题。 
经过多次修改后,个人感觉这个系统比较具有通用性了,用户可以把整套系统放到网站的根目录下, 
或者作为一个子目录,或者使用虚拟目录,不用修改路径配置,不用担心路径问题。唯一需要注意的是在开发模板时, 
仍然使用相对于根的路径,这样是为了得到可视化效果,开发完成候,在路径的最前面加入{$URL_ROOT}即可。 

5.引申 
虽然每个目录中的url_root.php中只有一行代码,但是每个文件都要加载来检查到根的路径,然后再给模板中的 
路径赋值,如果使用cache,这会是个不错的选择。如果不使用cache,不知道在性能上如何? 
请教各位朋友,是否有其他的解决方法?请大家都来讨论一下,谢谢! 

没有评论: