DolrPHP テンプレート エンジン DolrViews 共有

【分享】DolrPHPモジュール板引擎DolrViews分享
核心文件：DolrViews.class.php:

2. /**
3. * DolrPHP テンプレート エンジン
4. * @author Joychao
5. * @version 1.0 beta
6. * @license http: //www.Joychao.cc
7. */
8. define('DOLRVIEWS') または define('DOLRVIEWS',true);
9. define ('DIR_SEP') またはdefine('DIR_SEP',DIRECTORY_SEPARATOR);
10. class DolrViews
11. {
12. /**
13. * シングルトン オブジェクト
14. *
15. * @static var
16. * @var オブジェクト DolrViews
17. */
18. protected static $_instance;
20. /**
21. * テンプレート変数
22. *
23. * @var array
24. */
25. protected $_tpl_vars=array();
27. /**
28. * テンプレートパラメータ情報
29. *
30. * @var array
31. */
32. protected $_options=array(
33. 'template_dir'=>'テンプレート',
34. 'compile_dir'=>' templates_c',
35. 'cache_dir'=>'cache',
36. 'caching'=>false,
37. 'cache_lifetime'=>3600,
38. 'plugins_dir'=>'plugins',
39. 'tpl_suffix'=>'html',
40. 'php_handing'=>false,
41. ) ;
43. /**
44. * 含まれるプラグイン
45. * @var array
46. */
47. protected $includePlugins=array();
49. /**
50. * メインテンプレートを含まないテンプレート
51. * @var string
52. */
53. protected $mainTplFileName;
55. /**
56. * シングルトンモード呼び出しメソッド
57. *
58. * @static
59. * @return object DolrViews
60. */
61. public static function getInstance($options=array) ()) {
62. if (!self :: $_instance instanceof self)
63. self :: $_instance = new self($options);
64. return self :: $_instance;
65. }
67. /**
68. * コンストラクター、すべての構成を初期化します
69. *
70. * @param array $config=array(); 構成配列
71. * @example:
72. * $_options=array(
73. * 'template_dir'=>'テンプレート',
74. * 'compile_dir'=>'templates_c',
75. * 'cache_dir'=>'cache',
76. * 'caching'=>false,
77. * 'cache_lifetime'=>3600,
78. * ' plugins_dir '=>'プラグイン',
79. * 'php_handing'=>false,
80. * );
81. * $tpl=new DolrViews($_options); 🎜>
*/
82. パブリック関数 __construct($options=array())
{
84. if (!empty($options))
85. {
86. $this->setOptions($options);
87. }
88. }
90. /**
91. * 変数をテンプレートに割り当てます
92. *
93. * @param string $varName 変数名
94. * @parammixed $varValue 変数値
95. */
96. public function assign($varName,$varValue)
97. {
98. $this->tpl_vars[$varName]=&$varValue;
99. }
101. /**
102. * ページへの出力を表示
103. *
104. * @param string $tplFileName テンプレート ファイル名
105. */
106. public function display($tplFileName,$cacheId=null)
107. {
108. $cacheId=is_null($cacheId)?$_SERVER['REQUEST_URI']:$cacheId;
109. $this->mainTplFileName=$tplFileName;
110. $tplFilePath=$this->_getTplPath($tplFileName);
111. extract($this->_tpl_vars) ;
112. //内置变量
113. extract($this->gt;_getSystemVars($tplFileName));//系统变量
114. //存在するかどうか
115. if($this->_options['caching']){
116. if($this->isCached($tplFileName,$cacheId)){
117. include $this-> ;_getCacheFile($tplFileName,$cacheId);
118. }else{///否か保存文書
119. include $this->_writeCache($tplFileName,$this->_parseTpl($tplFileName) ,$cacheId),$cacheId);// 写入缓存
120. }
121. }else{//非缓存モード
122. include $this->_parseTpl($ tplFileName,$cacheId);//解析写入编译文件并包含
123. }
124. }
126. /**
127. * 構成テンプレート オプション
128. *
129. * @param array $options 構成配列
130. */
131. public function setOptions($options)
132. {
133. foreach ($options as $optionName => $optionValue) {
134. $this->set($optionName,$optionValue);
135. }
136. }
138. /**
139. * オプションの設定
140. *
141. * @param string $optionName オプション名
142. * @parammixed $optionValue オプション値
143. */
144. パブリック関数 __set($optionName,$optionValue)
145. {
146. $this->set($optionName,$optionValue) ;
147. }
149. /**
150. * 構成を個別に設定します
151. *
152. * @param string $optionName オプション名
153. * @parammixed $optionValue オプション値
154. */
155. public function set($optionName,$optionValue)
156. {
157. switch (strto lower($optionName)) {
158. case 'template_dir':
159. $optionValue=$this->trimPath($optionValue).DIR_SEP;
160. if(! file_exists($optionValue))
161. $this->_throwException('指定されたテンプレート ディレクトリ "'.$optionValue.'" が見つかりませんでした);
162. $this->_options [ 'template_dir']=$optionValue;
163. break;
164. case 'compile_dir':
165. $optionValue=$this->_trimPath($optionValue).DIR_SEP;
166. if(!file_exists($optionValue))
167. $this->_throwException('指定されたコンパイル ディレクトリ "'.$optionValue.'"' が見つかりませんでした);
168. $this->_options['compile_dir']=$optionValue;
169. break;
170. case 'cache_dir':
171. $optionValue=$this-> ;_trimPath ($optionValue).DIR_SEP;
172. if(!file_exists($optionValue))
173. $this->_throwException('指定されたキャッシュ ディレクトリ "'.$optionValue.'"見つかりませんでした ');
174. $this->_options['cache_dir']=$optionValue;
175. break;
176. case 'plugins_dir':
177. $ optionValue=$this->trimPath($optionValue).DIR_SEP;
178. if(!file_exists($optionValue))
179. $this->_throwException('指定されたキャッシュディレクトリが見つかりませんでした "'.$optionValue.'"');
180. $this->_options['plugins_dir']=$optionValue;
181. break;
182. case 'キャッシュ' :
183. $this->_options['caching']=(boolean)$optionValue;
184. break;
185. case 'cache_lifetime':
186. $this->_options['cache_lifetime']=(float)$optionValue;
187. break;
188. case 'php_handing':
189. $this- >_options[ 'php_handing']=(boolean)$optionValue;
190. break;
191. case 'tpl_suffix':
192. $this->_options['tpl_suffix' ]=trim( $optionValue);
193. break;
194. default:
195. $this -> _throwException("不明なテンプレート構成オプション "$optionName"");
197. }
198. }
200. /**
201. * テンプレート キャッシュをクリアします
202. *
203. * @param string $tplFileName='' テンプレート ファイル名。渡されない場合、すべてのキャッシュが削除されます
204. * @return ブール値の成功または失敗
205. */
206. public function clearCache($ tplFileName=' ',$cacheId=null)
207. {
208. $cacheId=is_null($cacheId)?$_SERVER['REQUEST_URI']:$cacheId;
209. if (!empty ($tplFileName)){
210. $cacheFile=$this->getCacheFile($tplFileName,$cacheId);
211. if(file_exists($cacheFile)){
212. chmod($cacheFile, 0777);
213. @unlink($cacheFile);
214. }
215. }else{//すべてのキャッシュ ファイルを削除します
216. foreach (glob($this->_options['cache_dir'].'*') as $cacheFile) {
217. chmod($cacheFile, 0777);
218. @unlink( $cacheFile) ;
219. }
220. }
221. }
223. /**
224. * 指定されたテンプレート ファイルがキャッシュされているかどうかを確認します
225. *
226. * @param string $tplFileName テンプレート ファイル名
227. * @return boolean
228. */
229. パブリック関数 isCached( $tplFileName,$cacheId=null)
230. {
231. $tplFilePath=$this->_getTplPath($tplFileName);
232. $cacheId=is_null ($cacheId )?$_SERVER['REQUEST_URI']:$cacheId;
233. $cacheFile=$this->_getCacheFile($tplFileName,$cacheId);
234. if(file_exists($ cacheFile) / /
235. と filemtime($cacheFile)+$this->_options['cache_lifetime']>time()//期限切れではありません
236. と filemtime($cacheFile) >filemtime ($tplFilePath) //テンプレートは変更されていません
237. ){//存在しており、期限切れになっていません
238. return true;
239. }else{
240. return false;
241. }
242. }
244. /**
245. * 組み込み変数の取得
246. * @return array
247. */
248. 保護された関数_getSystemVars($tplFileName){
249. //組み込み変数
250. $_sysVars=array();
251. $_sysVars['dolr_now']=time();
252. $_sysVars['dolr_get ']=$_GET;
253. $_sysVars['dolr_post']=$_POST;
254. $_sysVars['dolr_request']=$_REQUEST;
255. $_sysVars[' dolr_cookie']=isset($_COOKIE)?$_COOKIE:null;
256. $_sysVars['dolr_session']=isset($_SESSION)?$_SESSION:null;
257. $_sysVars[' dolr_template']=basename($tplFileName);
258. $const=get_dependent_constants(true);
259. $_sysVars['dolr_const']=$const ['user'];
260. $_sysVars['dolr_url']="http://".$_SERVER ['HTTP_HOST'].$_SERVER['PHP_SELF'];
261. if (!empty($_SERVER['QUERY_STRING' ])){
262. $_sysVars['dolr_url'].='?'.$_SERVER['QUERY_STRING'];
263. }
264. return $_sysVars;
265. }
267. /**
268. * テンプレート ファイルのパスを取得します
269. *
270. * @param string $tplFileName template file
271. * @return string ファイル名
272. */
273. 保護された関数 _getTplPath($tplFileName)
274. {
275. return $this->_options['template_dir'].$this->_trimPath($tplFileName);
276. }
278. /**
279. * キャッシュされたファイルを取得します
280. * @param string $tplFileName template file
281. * @return string ファイル名
282. */
283. 保護された関数 _getCacheFile($tplFileName, $cacheId)
284. {
285. return $this->_options['cache_dir'].$tplFileName.'.cache.'.md5($cacheId).'.php';
286. }
288. /**
289. * コンパイル済みファイル名を取得します
290. *
291. * @param string $tplFileName template file
292. * @return string ファイル名
293. */
294. 保護された関数 _getCompileFile( $tplFileName, $cacheId)
295. {
296. return $this->_options['compile_dir'] .$tplFileName.'.compile.php';
297. }
299. /**
300. * 解析されたテンプレート
301. *
302. * @param string $tplFileName テンプレート ファイル
303. * @return string 解析されたコンテンツ
304. */
305. 保護された関数 _parseTpl($tplFileName ,$cacheId)
306. {
307. $tplFilePath=$this->gt;_getTplPath($tplFileName);
308. if (!file_exists($tplFilePath) または !is_readable($ tplFilePath)) {
309. $this->_throwException(' 指定されたモール板文件を打てません'.$tplFileName.'"');
310. }
311. $content =file_get_contents($tplFilePath);
313. //检测包含、检测所有的 include 'xxx.html'
314. preg_match_all('/[nrt]*[nrt]*/s', $content, $matches);
316. if(!empty($matches[1])){
317. foreach ($matches[1] as $key=>$fileName) {
318. $includeFilePath=$this-> _getTplPath($fileName);
319. if (!file_exists($includeFilePath) または !is_readable($includeFilePath)) {
320. $this->_throwException(' 指定されたモジュールファイルを打てません" '.$includeFilePath.'"');
321. }
322. $includeCompilePath=$this->_getCompileFile($fileName,$cacheId);// 编译文件名
$this->_parseTpl($fileName,$cacheId);
323. $content=str_replace($matches[0][$key], '', $content);
324. }
325. }
326. //规则
327. $pattern=array(
328. '/ ?>[nr]* /s',//删除 PHP 代打断间多余空格及换行
329. '/(]+)s*>)/es',// 直接出变量内容
330. '//s',//包含模板
331. '/(.+?)/ies',//if /if
332. '//ies',//elseif
333. '//is',//else
334. '/(.+?)(.+?)/ies',//loop $array $v
335. '/(.+?)/ies',//loop $array $v
336. '/(.+?)(.+?)/ies',//loop $array $k $v loopelse
337. '/(.+?)/ies',//loop $array $k $v
338. '//',//<サイクル 'a','b'>
339. );
340. // PHP 格式
341. $php=array(
342. ' ',
343. "$this->_parseVar('\1')",
344. ' _options['template_dir']."\1';?>",
345. "$this->_stripvtags('','\2');",
346. "$this->_stripvtags('','');",
347. '',
348. "$this->_stripvtags('','\3\4');",
349. "$this->_stripvtags('','\ 3n');",
351. "$this->_stripvtags(' \3) { ?>','\4\ 5');",
352. "$this->_stripvtags(' \3) { ?>','\4');",
354. "",
355. );
357. $content=preg_replace($pattern, $php, $content);
359. //プラグインを含める
360. $pluginsString='';
361. if($tplFileName==$this->mainTplFileName){// メイン テンプレートの場合は、インクルード ファイル
362. foreach ($this->includePlugins as $plugin) {
363. $pluginsString.="include $this->options['plugins_dir'].'{$plugin }';n ";
364. }
365. }
366. $header=<<
368. /* *
369. * {$tplFileName}
370. * DolrViews テンプレート コンパイル ファイル
371. * @package {$this->mainTplFileName}
372. */
373. define('DOLRVIEWS') または exit('アクセス拒否');
374. $pluginsString
375. ?>n
376. DOLRVIEWS;
377. $content=$header.$content;
378. $compileFilePath=$this->_writeCompile($tplFileName,$content,$cacheId);//コンパイルされたファイルを書き込みます
379. return $compileFilePath;
380. }
382. /**
383. * キャッシュテンプレートファイル
384. *
385. * @param string $tplFileName テンプレートファイル
386. * @param string $cacheId キャッシュ ID
387. */
388. 保護関数 _writeCache ($tplFileName, $cacheId)
389. {
390. $tplFilePath=$this->_getTplPath($tplFileName);
391. $cacheFilePath=$this->_getCacheFile( $tplFileName,$cacheId);//ファイル名を保存
392. $compileFilePath=$this->_getCompileFile($tplFileName,$cacheId);
393. ini_set('error_reporting','off' );// エラー プロンプトをキャッシュしません
394. extract($this->_tpl_vars);//テンプレート変数
395. extract($this->_getSystemVars($tplFileName));/ /システム変数
396. ob_start();
397. if(file_exists($compileFilePath) and filemtime($compileFilePath)>filemtime($tplFilePath))//テンプレートは変更されていません
398. {
399. include $compileFilePath;
400. }else{
401. include $this->parseTpl($tplFileName,$cacheId);//解析して書き込みますコンパイルされたファイル
402. }
403. $html=ob_get_contents();
404. ob_clean();
405. file_put_contents($cacheFilePath, $html);
406. return $cacheFilePath;
407. }
409. /**
410. * コンパイル済みファイルの書き込み
411. *
412. * @param string $tplFileName テンプレート ファイル
413. * @param string $cacheId キャッシュ ID
414. * @param string $content ウェブページ
415. */
416. 保護された関数 _writeCompile($tplFileName,$content) ,$cacheId)
417. {
418. $compileFilePath=$this->gt;_getCompileFile($tplFileName,$cacheId);//ファイル名を保存
419. if(!file_exists( dirname($compileFilePath))){
420. $this->makeDir(dirname($compileFilePath));
421. }
422. file_put_contents($compileFilePath,$content);
423. return $compileFilePath;
424. }
426. /**
427. * オペレーティング システムに適した形式にパスを修正します
428. *
429. * @param string $path path name
430. * @return string
431. */
432. 保護された関数 _trimPath( $path)
433. {
434. return rtrim(str_replace(array('/', '\', '//', '\\'),DIR_SEP, $path),DIR_SEP);
435. }
437. /**
438. * 指定されたパスに基づいて存在しないフォルダーを作成します
439. *
440. * @param string $path パス/フォルダー名
441. * @return文字列
442. */
443. 保護関数 _makeDir( $path)
444. {
445. $dirs =explode(DIR_SEP, $this ->_trimPath($path));
446. $tmp = '';
447. foreach ($dirs as $dir)
448. {
449. $tmp .= $dir . DIR_SEP;
450. if (!file_exists($tmp) && !@mkdir($tmp, 0777))
451. return $tmp;
452. }
453. return true;
454. }
456. /**
457. * 変数処理
458. *
459. * @param string $string target string
460. * @return string
461. */
462. 保護された関数 _parseVar($string ){
463. $pattern=array(
464. '/^
465. '/>$/',
466. '/( $w+|[^>s]+)/e',//$title|striptags|html2text
467. '/($[w]+.[w]+ )/e',
468. );
469. $replacement=array(
470. "
471. ' ?>',
472. "$ this->_parseModifier('\1');",
473. "$this->_parsePoint('\1');",
474. );
475. returntripslashes(preg_replace($pattern, $replacement, $string));
476. }
478. /**
479. * 变量调节器的处理
480. *
481. * @param string $string 模板中匹配到的变量
482. * @return string 处理后的字符串
483. */
484. protected function _parseModifier($string)
485. {
486. $arr=explode('|', trim($string,';'));
487. $tmp=array_shift($arr);
488. foreach($arr as $value)
489. {
490. $tmpArr=explode(':',$value);//html2text
491. $funcName=array_shift($tmpArr);//html2text
492. $args=count($tmpArr)>0?','.join(',',$tmpArr):'';//参数用,号链接 arg1,arg2,arg3
493. if(!function_exists($funcName)){//如果不是PHP内置函数则包含插件
494. if(!file_exists($this->_options['plugins_dir'].'modifier_'.$funcName.'.php')){
495. $this->_throwException('插件"'.$funcName.'"不存在');
496. }
497. $pluginFileName='modifier_'.$funcName.'.php';
498. if(!in_array($pluginFileName, $this->includePlugins)){
499. $this->includePlugins[]=$pluginFileName;//添加include插件
500. }
501. $tmp="dolr_modifier_{$funcName}($tmp{$args})";
502. }else{
503. $tmp="{$funcName}($tmp{$args})";
504. }
505. }
506. return stripslashes($tmp.';');
507. }
509. /**
510. * 数组操作的点支持
511. *
512. * @param string $string 目标字符串
513. * @return string
514. */
515. protected function _parsePoint($string)
516. {
517. $arr=explode('.',$string);//$a.b.c.f
518. $varName=array_shift($arr);//$a
519. return $varName.'[\''.join('\'][\'',$arr).'\']';//$a['b']['c']['f']
520. }
522. /**
523. * 去掉自定义标签
524. *
525. * @param string $expr 源文
526. * @param string $statement 替换目标
527. * @return string
528. */
529. protected function _stripvtags($expr, $statement)
530. {
531. $expr = str_replace("\\\"", "\"", preg_replace("/\<\?php echo \\\$.+? \?\>/s", "\\1", $expr));
532. $statement = str_replace("\\\"", "\"", $statement);
533. return $expr . $statement;
534. }
536. /**
537. * 抛出一个错误信息
538. *
539. * @param string $message
540. * @return void
541. */
542. protected function _throwException($message)
543. {
544. trigger_error('DolrViews错误：'.$message);
545. exit;
546. }
548. }
549. /* vim: set expandtab: */

使用范例：
PHP:

2. include 'DolrViews.class.php';
3. $tpl=DolrViews::getInstance();//单例
4. $_options=array(
5. 'template_dir'=>'templates',//模板目录
6. 'compile_dir'=>'templates_c',//编译目录
7. 'cache_dir'=>'cache',//缓存目录
8. 'caching'=>false,//是否缓存
9. 'cache_lifetime'=>3600,//缓存有效期
10. 'plugins_dir'=>'plugins',//插件目录
11. 'tpl_suffix'=>'html',//模板后缀
12. );
14. $tpl->setOptions($_options);//保存如上设置
16. $title="标题测试啊";
17. $val=3;
18. $array=array(
19. array('username'=>'Joychao','password'=>'nowpass'),
20. array('username'=>'DolrPHP','password'=>'password'),
21. );
22. $var='这里是带标签的HTML';
24. //分配变量
25. $tpl->assign('val',$val);
26. $tpl->assign('title',$title);
27. $tpl->assign('array',$array);
29. //显示
30. $tpl->display('index.html');

模板index.html：

6. --包含文件----------------------------
   
8. ------if else------------------------
   
10. do anything
12. do another
14. Do not
16. ---------------------------------
    
18. ------loop------------------------
    

20. 循环内容<$dolr_index>

21. 交互式显示：
22. 循环中的变量：<$v.username>

23. ループ内のインデックス $dolr_index:ccc

25. コンテンツなし
27. ---------------- --- -------------
    
28. --含まれるファイル--------------- --- -------
    
30. ------------ --- ---------------
    

目次の例:
ドルビュー数/
|--cache //キャッシュディレクトリ
|--plugins //プラグインディレクトリ
|--templates //テンプレート ディレクトリ
|--templates_c //コンパイルファイルディレクトリ
|--DolrViews.classs.php //エンジンメインファイル
|--index.php //テストファイル


現在、プラグインは 1 つのテストのみを作成しています。プラグインの仕様は modifier_function name.php です。コンテンツ関数名: dolr_modifier_function 名 ($最初のパラメータは [, その他のパラメータ] である必要があります)。例：

1. 関数 dolr_modifier_html2text($string)
2. {
3. returnstrip_tags($string);
4. }

今日これを書きました。皆さんもぜひ投稿してください。 こちらも大歓迎です @安正超！