标签：thinkphp

从TP1.5开始，对于其他的模版引擎有了原生支持（不再是以前那种插件机制了）。
本文以使用smarty模版为例作点简单介绍，其他的，可以参考一下View.class.php中的fetch方法可知。

TP的SVN中已经含有smarty模版库，因此当你要使用的时候，只需要在项目的config.php里作一点简单的配置：

'TMPL_ENGINE_TYPE' => 'smarty', //这个是设置引擎为smarty

从2009-01-07下午的SVN版本里，流年为又增加了一个TMPL_ENGINE_CONFIG这个数组，即：

'TMPL_ENGINE_CONFIG' = array(
'template_dir' => TMPL_PATH , //这个就是tpl目录了
'compile_dir' => CACHE_PATH . "tplCompile/", //这是我自己设定的，模版编译缓存放在这个目录里
'cache_dir' => CACHE_PATH . "tplCache/", //如果需要生成页面缓存，这个也是必须的
'left_delimiter' => '{',
'right_delimiter' => '}',
'caching' => false,
'force_compile' => true,
'compile_check' => true,
),

备注：如果按照我这样的写法，请到cache目录里手动创建tplCompile和tplCache两个目录，否则程序会报错。
报错信息大致为：

Catchable fatal error: Object of class Smarty could not be converted to string in D:\local\htdocs\ThinkPHP\Album\Temp\~runtime.php on line 145

如果出现这样的报错信息，请先检查这两个目录是否存在

在项目开发的时候，caching 最好设为false，否则你根本看不到效果。

如此设定完毕后，你就可以直接在项目中使用了，下面以Index模块的index方法进行举例：在IndexAction.class.php的index的方法里

$this->assign("test" , "This is a test string");
$this->display();

然后到模版里：

{$test}

就可以看到输出了。不过，这里需要注意的是，如果你$this->display()没有指定文件名，那么默认的模版文件就是default/Index/index.html，这点和原先使用TP默认的模版引擎没有什么区别。
出现问题最大的应该是在include方法里，include的使用方法是：{include file="Public/header.html"}，就象我前面所说，smarty的模版路径只指到了tpl目录，但实际上，我们是在默认的default目录下操作，因此正确的写法应该是{include file="default/Public/header.html"}
如果我们写的程序要对应多模版，那么，上面那种直接写死default的方法是不行的，还好，TP为我们留了一个常量：TEMPLATE_NAME，于是我们的写法就可以是现在这样：

{include file="`$smarty.const.TEMPLATE_NAME`/Public/header.html"}

现在试一下，是否公用目录里的header.html被加载了？

最后再报一个warning。如果是在WINDOWS下面开发并且开启了DEBUG_MODE，那么你在读取模版的时候，页面的Trace信息里，偶尔会出现一个注意：

[ 09-01-08 14:36:02 ] 注意：[2] unlink(./Cache/tplCompile/\%%70^706^706C3AFE%%index.html.php) [function.unlink]: No such file or directory core.write_file.php 第 44 行.

这些信息，可以被忽略掉。模版文件还是会正常的生成和编译的。它只会在第一次生成模版编译文件的时候出现

YY博鼎力之作哦，大家支持一下。
除此之外，他还写了一个yBlog，同样请大家支持
http://www.yhustc.com，就是yBlog的官方网站。

介绍：

ThinkPHP 2008年离线资料包，将ThinkPHP论坛使用版面与帮助资料版面2008年所有帖子全部采集生成HTML文件，并添加了全文检索功能。可以在不联网的情况下方便查找论坛中相关问题的讨论，并且可以方便的搜索，比CHM的搜索更强大的搜索。点击搜索结果可以直接来到帖子页，也可以直接通过首页进入相关版面列表，就跟操作BBS一样。

注意：需要安装.NET框架2.0及以上版本

图片：

下载地址：http://www.yhustc.com/ThinkPHP2008.rar

本站分流：下载

顶想，流年，这些关键字是不是让你有什么熟悉的地方？topthink，流年的想法终于付诸实施了，虽然他并没有要求我发这个贴子和链接，不过，作为THINKPHP的用户，也希望更多的人走进来，试想fleaphp(QeePHP)也是以公司形式在运作，如果没有大量的人来做这些事，光靠个人，可能很难坚持下去。所以，我支持一下流年。。。

以下是招聘启示（顺便BS一下，居然用FLASH，害得我差点没法复制。。。）：

上海顶想信息科技有限公司致力于ThinkPHP的运作推广、支持和项目以及产品开发。
为了ThinkPHP的长足发展和项目需要，顶想信息科技公开招聘官方技术团队和PHP开发精英。
无论你是PHP菜鸟还是高手，只要你对ThinkPHP充满热情，都欢迎加入我们的团队。
我们追求的是快乐，做你真正喜欢做的事。
我们追求的是效率，做正确的事而不总是加班。
我们追求的是尊重，人是我们最大的财富。
我们追求的是成长，发现，培养，和保留最优秀的人。
如果你想追随自己的梦想，如果你想超越不可能，如果你想达到人生的理想，请考虑一下这个机会！有超过10w的用户在使用ThinkPHP，做为ThinkPHP官方的核心团队成员，你将 会伴随着TP一起成长。我们希望你在这个过程中能成长为一名经验丰富的项目负责人，能够独当一面，开发大型创新性项目。我们也希望你能够同时培养起较强的商业直觉和沟通管理才能。

我们的人才观
1. 以人为本，唯才是用
2. 能者居之，能进能出
3. 德才兼备，共同发展

我们需要什么样的人才？
1、有实际WEB2.0相关项目经验的PHP开发人员；
2、进行TP的文档编写、示例制作、宣传推广和培训支持的技术支持人员；
3、熟悉其他开发框架、对框架开发有强烈兴趣的开发人员

基本要求：
1、热爱ThinkPHP
2、熟悉PHP面向对象和MVC开发
3、良好的编程习惯和思想
4、独立的开发能力
5、有ThinkPHP项目开发经验优先
工资待遇：3k~6k

公司简介：上海顶想信息科技有限公司，主要从事ThinkPHP的运作推广、支持和项目以及产品开发。
工作地点：上海徐汇区钦州路108弄梓树园6号楼203室

有意向请投简历到：hr@topthink.com 或者联系QQ:130770305（请注明应聘）

顺便说一下，离我现在的单位真的不远呀。。。。看来以后有机会跑过去蹭饭了

海龙CMS是基于ThinkPHP框架的一个PHP应用，目前看来是相对简陋了一些，但这也紧紧局限于表面，毕竟没有专业的美工，能做到这样也算是不错了，程序支持模版的切换，所以，如果你的美工够好，你一定能够做出比海龙官方更漂亮的网站。

此次更新了以下内容：

1.1 Beta
取消了产品管理
取消了产品搜索
采用Rbac进行权限控制
采用SinaEditor编辑器，支持图片和附件上传
文章分类支持到三级分类
修改了模板变量的处理方式
整合了yhustc工具箱（可到TP论坛搜索yhustc工具箱以查看详细资料）
可生成HTML（只需要后台配置一下就好了）


1.0 Final
完成了基本的文章管理、页面管理、产品管理
产品支持多字段模糊查询

演示地址：http://www.hailongol.com/hlcms/
官方下载：http://www.hailongol.com/HailongCMS.rar

本站分流：

TP的COOKIE类是被封装好的，里面包含了一些常见的操作，set,get,clear等等，其实TP的cookie类与其他的COOKIE有着明显的不同，那就是TP的COOKIE ID是唯一的（不好意思，在我写完这段的时候，为了防止写错，我又重新打开了cookie.class.php，却突然发现，现在的cookie功能与以前的不一样了。）

以前的set函数是类似于这样：

$_COOKIE[C('COOKIE_ID')][C('COOKIE_PREFIX').$name] = $value ;

$_COOKIE[C('COOKIE_PREFIX').$name] = $value;

既然如此，我还是按最新的稍作讲解吧。。。

Cookie类，固名思意，就是把对COOKIE的操作进行了封装，通过定义一个COOKIE名的前缀，以防与其他COOKIE产生冲突，然后加上COOKIE变量的名称，就可以进行赋值、取值等。

Cookie类所有的操作都采用了静态方法，即在实际应用中，只要加载了Cookie类，就可以随时使用了：

<?
//假设cookie 前缀为 'neatcn_'
Cookie::get('test');
//return $_COOKIE['neatcn_test'];

Cookie::set('test','123456');
//return setcookie('neatcn_test','123456',xxx,xxx,xxx);
//xxx是默认定义的常量，如默认COOKIE的过期时间，作用域等

另外一个需要注意的是，cookie在不同的浏览器下面有着不同的限制，最常见的就是cookie的长度，请尽量不要超过4K的字节。

参考资料：

* 一个 Cookie 档案最多只能包含 300 个 Cookies。（这只适用于 Netscape，因为它把所有的 Cookie 都放在一个档案。）
* 每一个 Cookie 的大小不得超过 4KB。
* 每一个 URL 路径，最多只能设定 20 个 Cookie。

如果你在使用ThinkPHP框架的时候不想采用TP自带的模版系统，而使用第三方的模版系统，你有很多其他的选择，在这里我仅介绍Smarty这种比较官方，而且比较强大的模版系统。

由于Smarty兼容PHP4，因此，它的效率会相对低一点点，这个低只是相对的，估计等Smarty啥时候正式放弃PHP4的时候，效率可能会上很大一个台阶。

官方标准使用方法：

在TP框架的PlugIns目录下面，有一个SmartTemplate目录，里面就是系统自带的Smarty插件。

使用方法如下：

1、在项目的Conf/Config.php文件里加上：

return array(
'THINK_PLUGIN_ON' => true,
'TMPL_ENGINE_TYPE'=>'smarty',
);

2、下载好Smarty，并将smarty的libs目录整个拷至项目的PlugIns目录下（说明一下，PlugIns目录可能会不存在，需要自己建立），同时将libs目录改名为SmartTemplate（希望没有记错，其实也就是与THINKPHP的PlugIns目录里的SmartyTemplate目录同名即可），如果你不愿意把目录改成这个名字，那么，你必须到TP的插件目录里修改插件文件，使之包含路径正确。

3、注意修改每次修改action或模板文件后删除Temp下的html文件

说明一下：上面的内容来自于官方，由lin_chaoqi朋友解答的，网址为：http://bbs.thinkphp.cn/viewthread.php?tid=305&highlight=smarty

在这里我要提的方法是于上面不一样的，黑黑

因为我在使用第三方模版插件的时候，特地看了TP的view.class.php发现了一些很重要的问题，那就是，如果采用第三方模版插件，那么第三方模版插件的效率可能不能保证，因为View类的fetch方法在判断是否为第三方插件之间，作了很多TP模版插件的自有处理，而这些对于使用第三方模版插件来说，几乎是完全无效的，这些处理可能会给第三方插件带来影响，同时也影响了第三方插件的执行效率。问题已经与流年沟通过，但由于改动可能会很大，或许最近几个版本里，流年都不会尝试作改进吧，一是怕影响了那些已经使用第三方插件的程序，二来如果去除掉这些处理，那么View类可能就不需要了。流年对于这样的情况应该是不愿意看到的。毕竟这也影响了原有系统的架构，估计流年得仔细考虑了……［当然从流年个人来说，肯定是希望大家都使用TP自有的模版插件，只是我目前对于smarty则是更加熟悉而己］，但对于我这个使用者来说，我需要的是临时解决方法，所以，就有了下面的内容。

为了解决这个问题，我只有从View.class.php里下手，因为Action.class.php里有一行：

$this->tpl = View::getInstance();

那么，也就是说 tpl 这个变量是 View 的单例模式，检查了一下View.class.php中的这个getInstance方法，发现里面使用了 get_instance_of 这个函数（这个函数是有一点小BUG的，这里不作解释，但我目前也没有更好的解决方法），于是我对getInstance和__construct两个方法进行了改动，删除了__construct方法，加上了init方法，改动代码如下：

static function getInstance() {
return get_instance_of(__CLASS__,'init');
}

public function init ($type=''){
if(!empty($type)) {
$this->type = strToUpper( $type );
}else{
$this->type = strtoupper(C('TMPL_ENGINE_TYPE'));
}
if ( !in_array( $this->type, array('PHP','THINK') ) ){
$type = ucfirst( strToLower( $this->type ) );
vendor( $type );
return new $type();
}
return $this;
}

也就是让View类在实例化的时候，同时调用init方法。在这个方法里，我将我自己的模版插件放到了第三方插件的目录（Vendor）下。

切记切记：千万不可漏掉最后一句return $this;，其实这就是我所说的get_instance_of的BUG，如果不加这句，那么当type变量为PHP或THINK时，getInstance是无法返回实例的。

新的使用方法步骤如下：

1、修改项目的Conf/Config.php文件：

return array(
'THINK_PLUGIN_ON' => true,
'TMPL_ENGINE_TYPE'=>'TpSmarty',
);

2、在TP的Vendor目录下面，创建TpSmarty.php，内容如下：

<?php
include_once(PLUGIN_PATH."smarty/Smarty.class.php");

class TpSmarty extends Smarty {
public function __construct (){
parent::Smarty();
$this->caching = true;
$this->template_dir = TMPL_PATH;
$this->compile_dir = CACHE_PATH ;
$this->cache_dir = TEMP_PATH ;
}
}
?>

上面是最简单的写法，实际使用中，这些变量请改为与你自己的站点相配合。

3、根据上面的文件里的include_once函数，将smarty的libs目录拷贝至项目的PlugIns目录下，改名为：smarty（只需要与include_once中的目录相匹配即可）

4、然后，在项目的方法里就可以直接使用:

class IndexAction extends Action{
public function index(){
$this->assign('test','testss');
$this->display('default/index.html');
}
}

只是，使用了插件后，display方法的参数是模版的全路径，而且不能留空（并非不能解决，只是要改动的代码就会更多，目前这个方法是改动最少的）。

测试一下，是否正常了？呵呵 。

现在，我们把Config里的模版引擎换回Think，同时在Tpl/default/目录下建立Index目录，里面放上index.html，并修改上面的index()方法，将原来的$this->display('default/index.html'); 改为$this->display(); ，试一下，是不是也正常了？

测试一下:

<?php

if( !emptyempty( $test )){
echo 'test fck empty';
}

ThinkPHP的模版引擎强大就强大在于它可以使用XML标签来为TP模版引擎进行扩展，因此TP的标签功能就成了TP模版的亮点所在。要想让TP的模版功能更加强大，你就得学会扩展TP的标签功能，即：自定义标签

开发自定义标签功能的时候，有几个注意的地方，
1、文件名的规范性，这个当然是不用多解释了，TagLibInput.class.php
（TagLib加是你定义的标签名，首字符大写，这样你的文件名中的Input就会自动认为你的XML文件名）
2、目录所在：目前暂时还是存放到THINKPHP的核心类库里，目录为：/THINKPHP/Lib/Think/Template
主程序文件放到：/THINKPHP/Lib/Think/Template/TagLib/ 目录下
自定义的XML文件放到：/THINKPHP/Lib/Think/Template/Tags/ 目录下

（自定义的文件是小写的标签名，即刚才类名中的Input的小写）

注意事顶：
如果你发现你自定义的标签没有被解析，请按如下方法进行检查（以input标签为例）
1、查看文件开始的地方是否加载了<tagLib name="cx,html,input" />,同时，请检查是否符合XML规范，如：标签一定要闭合。例：<br />，否则会出现XML解析错误
2、检查文件是否都为UTF－8编码，因为在解析XML的时候，都是采用UTF8编码，如果不是UTF8编码，会出现一些奇怪的解析错误，很多时候都会出现simpleXml解析器错误，如果出现这种错误，请检查文件编码，如果是UTF8编码的文件，请同时检查文件头是否存在BOM标记。
3、自定义的标签中，是否忘了双引号。由于在写HTML的时候，很容易忽略双引号，比如<input type=text name=name>，如果是这样，在被当成XML解析的时候，肯定会报错的，正确的写法应该是：<input type="text" name="name" value="value" />（标签要闭合），如果是自己自定义的标签，则应该这样写：<input:text name="" value="" />

使用ThinkPHP自带的模版引擎处理模版问题时，一般情况下不会有什么问题。

但是，在处理一些XHTML模版时，可能会遇到以下问题，比如，模版作者在制作模版时，为了规范页面，往往在文件头部加上<?xml version="1.0" encoding="utf-8"?>，表明文件是属于XML规范，所有的标签都必须遵循XML的相关规定。

然而，默认的ThinkPHP模版引擎在处理的时候会出现错误，处理这个错误的情况有以下几种办法。

第一种方法：你尝试关闭PHP的短标签功能
第二种方法：试着用<literal></literal>标签把XML的标签包含起来，即
<literal><?xml version="1.0" encoding="utf-8"?></literal>

第三种方法：修改ThinkPHP/Lib/Think/Template/ThinkTemplate.class.php的compiler函数，在函数的最后一行return $templContent;前加入

// 将<?标签用echo方式输出
$tmplContent = preg_replace('/(<?(?!php|=|$))/i', '<?php echo '\1'; ?>'."n", $tmplContent );

任何一种方法理论上都可以，第一种第二种方法实在不行的时候，再用第三种，毕竟第三种方法是改动核心的，如果以后更新核心库，可能会不当心就覆盖掉了。

不过，流年说过了，他已经更新了模板引擎的解析类，并且专门判断了是否开启了短标签，如果开启的话会自动用第三种方法解析。更新下SVN的ThinkTemplate.class.php 文件就可以了（可能压缩包还没有同步更新[2008-04-22]）。

新版介绍：

[ 1.0.2 ] 2008-2-21

• Model类增加toArray方法
• 修正因Log类的改动导致Trace错误信息无法正常显示的问题
• 数据查询返回的数据集由ArrayObject对象改成数组
• 修正Model类的create方法在定义字段映射的下面的bug
• 修正虚拟模型下面create方法的bug
• Model类的facade方法增加数据表字段的检测
• 优化Image类的showAdvVerify方法
• 修正标签库的compare标签
• Trace配置文件由原来的_trace.php更名为trace.php
• 项目调试配置文件由原来的_debug.php更名为debug.php
• 项目配置文件由原来的_config.php更名为config.php
• 路由定义文件由原来的_routes.php 更名为 routes.php
• 静态定义文件由原来的_htmls.php 更名为 htmls.php
• Model类的create方法无需type参数，自动判断新增和编辑模型数据
• 增加第一次运行目录自动生成功能（只需要定义入口文件）
• 默认项目编译缓存目录为Temp目录