کلاس قالب

[AbiriAmir]

:عصبانی++::عصبانی++::عصبانی++::� �صبانی::عصبانی::عصبانی::عصبا� �ی::عصبانی::عصبانی:
ببخشید که با این علامت تاپیک رو شروع میکنم ولی یه بار نشستم این همه تایپ کردم...
بعدش اینترنتم قطع شد و وقتی دکمه ارسال مطلب رو زدم همش پرید :گریه::گریه::گریه:
بگذریم...
امروز میخوام آموزش استفاده از یک template-engine رو براتون بزارم هرچند میدونم بارها راجع بهش بحث شده...
این کلاس توسط دوست خوبم آقای شاهرخیان نوشته شده که منم از cms ایشون یعنی راش (RashCMS (http://www.rashcms.com)) کپی زدم
کلا همونطور که میدونید کلاس تمپلت کارش جدا کردن کد php از html هست و در کل کارتون تمیز در میاد و هیچوقت هم با header('location:...'); مشکلی نخواهید داشت

خب شروع میکنیم:

اول کلاس قالب:

<?php
/************************************************** *************************
* Rash CMS
* -------------------
* copyright : (C) 2009 The RashCMS $Team = "www.rashcms.com";
* email : info@rashcms.com
* email : rashcms@gmail.com
* programmer : Reza Shahrokhian
************************************************** *************************/
// Security
if ( !defined('news_security'))
{
die("You are not allowed to access this page directly!");
}
class RashCMS
{
var $tags = array();
var $required_tags = array();
var $blocks = array();
var $tpl = '';
var $parsed_tpl = '';
function load($tpl=''){
if( !empty($tpl) )
{
if(!file_exists($tpl))
{
$this->tplerror('Could not find the template file <b>'. $tpl ."</b>");
return FALSE;
}
$tpl = @implode( '',@file($tpl));
$tpl = $tpl ? $tpl : $this->tplerror('Could not read the template file!');
$this->tpl = $tpl;
}
}
function tplerror($error)
{
echo $error;
return FALSE;
}
function assign( $input, $value = '', $required = FALSE )
{
if( is_array( $input ) )
{
foreach( $input as $tag => $value )
{
if(empty( $tag ) )
$this->tplerror('R a s h C M S::The tag name shouldnt be empty.');
if( $required == TRUE )
{
$this->required_tags[$tag] = $value;
}
else
{
$this->tags[$tag] = $value;
}
}
}
elseif( is_string( $input ) )
{
if( empty( $input ) )
$this->tplerror('R a s h C M S::The tag name shouldnt be empty.');
else
{
if( $required == TRUE )
{
$this->required_tags[$input] = $value;
}
else
{
$this->tags[$input] = $value;
}
}
}
else
{
return FALSE;
}
return TRUE;
}
/*-----------------------------------------------------------------*/
function block($block_name, $block_array)
{
if( !is_string($block_name) || empty($block_name))
$this->tplerror('R a s h C M S::Block name is not a string or is empty!');
if( !is_array($block_array))
$this->tplerror('R a s h C M S::Block array is not an array!');
$this->blocks[$block_name][] = $block_array;
}
/*-----------------------------------------------------------------*/
function parse()
{
if( empty( $this->tpl ) )
{
return;
}
# blocks
$tmp_blocknames = array();
foreach( $this->blocks as $block_name => $block_arrays )
{
if( $anzahl = preg_match_all( '/<tag:'. preg_quote( $block_name, '/' ) .'>(.*)<\/tag:'. preg_quote( $block_name, '/' ) .'>/sU', $this->tpl, $matches ) )
{
for( $i = 0; $i < $anzahl; $i++ )
{
$block_plus_definition = $matches[0][$i];
$block = $matches[1][$i];
if( is_int( strpos( $block, '<!-- IF' ) ) )
{
$parse_control_structures = TRUE;
}
$parsed_block = '';
foreach( $block_arrays as $block_array )
{
$tmp = $block;
if( isset( $parse_control_structures ) )
{
$tmp = $this->_parse_control_structures( $tmp, array_merge( $block_array, $this->tags, $this->required_tags ) );
}
foreach( $block_array as $tag_name => $tag_value )
{
$tmp = str_replace( '['.$tag_name.']', $tag_value, $tmp );
}
$parsed_block .= $tmp;
}
$this->tpl = str_replace( $block_plus_definition, $parsed_block, $this->tpl );
$tmp_blocknames[] = $block_name;
unset( $parse_control_structures );
}
}
}
if( count( $this->blocks ) > 0 )
{
$this->tpl = preg_replace( "/<(tag|\/tag):(". implode( '|', $tmp_blocknames ) .")>/", '', $this->tpl );
}
# unbenutze blcke entfernen
$this->tpl = preg_replace( "/<tag:([a-zA-Z0-9_-]+)>.*<\/tag:\\1>( |\r|\n)?/msU", '', $this->tpl );
# single tags
foreach( $this->required_tags as $tag_name => $tag_value )
{
if( !is_int( strpos( $this->tpl, $tag_name ) ) )
$this->tplerror('R a s h C M S::Could not find tag <i>'.$tag_name.'</i> in the template file!');
else
{
$this->tpl = str_replace( '['.$tag_name.']', $tag_value, $this->tpl );
}
}
foreach( $this->tags as $tag_name => $tag_value )
{
$this->tpl = str_replace( '['.$tag_name.']', $tag_value, $this->tpl );
}
# if & else
$this->tpl = $this->_parse_control_structures(
$this->tpl,
array_merge( $this->tags, $this->required_tags ),
$this->blocks
);

$this->parsed_tpl = $this->tpl;
$this->tpl = '';
}
/*-----------------------------------------------------------------*/
function showit()
{
if( !empty( $this->tpl ) )
{
$this->parse();
}
print $this->parsed_tpl;
}
/*-----------------------------------------------------------------*/
function dontshowit()
{
if( !empty( $this->tpl ) )
{
$this->parse();
}
return $this->parsed_tpl;
}
/*-----------------------------------------------------------------*/
function reset()
{
$this->tpl = '';
$this->parsed_tpl = '';
$this->tags = array();
$this->required_tags = array();
$this->blocks = array();
}
/*-----------------------------------------------------------------*/
function _parse_control_structures( $tpl, $vars, $blocks = array() )
{
if( $matchnumber = preg_match_all( '/<!-- IF (!?)((BLOCK )?)([_a-zA-Z0-9\-]+) -->(.*)((<!-- ELSEIF !\(\\1\\2\\4\) -->)(.*))?<!-- ENDIF \\1\\2\\4 -->/msU', $tpl, $matches ) )
{
for( $i = 0; $i < $matchnumber; $i++ )
{
//print( $matches[8 ][$i] . '<br />');
if( !empty( $matches[2][$i] ) )
{
$code = 'if( '.$matches[1][$i].'isset($blocks[\''.$matches[4][$i].'\']) )'."\n";
}
else
{
$code = 'if( '.$matches[1][$i].'( isset($vars[\''.$matches[4][$i].'\']) ) )'."\n";
}
$code .= '{ $tpl = str_replace( $matches[0][$i], $this->_parse_control_structures( $matches[5][$i], $vars, $blocks ), $tpl ); }'."\n";
$code .= ' else '."\n";
$code .= '{ $tpl = str_replace( $matches[0][$i], !empty($matches[7][$i]) ? $this->_parse_control_structures( $matches[8][$i], $vars, $blocks ) : \'\', $tpl ); }';
eval( $code );
}
}
return $tpl;
}
}
?>

کدهای بالا رو تو یه فایل به اسم template.php ذخیره کنید و شروع کنید

خب اول فایل قالب (مثلا main.htm) رو مینویسیم:



<html>
<head>
<title>[title]</title>
</head>
<body>
[a]
<br />

[b]

<tag:block1>
[aa]
<br />
[bb]
</tag:block1>
</body>
</html>



خب حالا فایل php:


<?php
define('news_security', 1);
include('template.php');
$tpl = new RashCMS();
$tpl->load('template/theme1/main.htm') //آدرس فايل قالب شما

$tpl -> assign('title', 'عنوان سايت');

$tpl -> assign(array(
'a'=>'ddd',
'b'=>'sss',
));

for($a=0;$a<=10;$a++)
{
$tpl -> block('block1', array(
'aa'=>'s',
'bb'=>'g',
));
}
$tpl -> showit();
?>

فکر کنم واضح باشه...
اگه توضیح خواستین بگین تا توضیح بدم
موفق باشید

در ضمن template-engine های مختلفی هستند که بارها و بارها راجع بهشون بحث شده (مثل اسمارتی (http://www.smarty.net)) که میتونید از اونها هم استفاده کنید

[Mr.Moghadam]

$tpl -> assign(array(
'a'=>'ddd',
'b'=>'sss',
));

for($a=0;$a<=10;$a++)
{
$tpl -> block('block1', array(
'aa'=>'s',
'bb'=>'g',
));

اینجا رو یه توضیح میدی ؟

[AbiriAmir]

$tpl -> assign(array(
'a'=>'ddd',
'b'=>'sss',
));

for($a=0;$a<=10;$a++)
{
$tpl -> block('block1', array(
'aa'=>'s',
'bb'=>'g',
));

اینجا رو یه توضیح میدی ؟

بخش اول (assign) ورودی اش یک آرایه هست به طوری که در مثال بالا [aa] و [bb] در قالب را به ترتیب با s و g جایگزین میکنه (همون str_replace)

بخش دوم مربوط به block هست یعنی وقتی که میخواین یک چیزی رو تکرار کنید که بخشی که میخواین تکرار بشه رو مانند مثال بالا استفاده میکنید.

یه نمونه براتون میگم:

فرض کنید شما میخواین مطالب سایتتون رو از دیتابیس بگیرید و نشون بدید

مطمئنا یک مطلب ندارید (چند مطلب وجود دارد) و حالا میخواین با این سیستم قالب اون رو نشون بدید که به صورت زیر عمل میکنید:

قالب:


<tag:articles>
<div id="article-title"> [title]</div>
<div id="article-text"> [text] </div>
</tag:articles>


بخش php:


$Q = "SELECT * FROM `articles`";
$Q = mysql_query($Q);

while($q=mysql_fetch_array($Q))
{
$tpl -> block('articles', array(
'title' => $q['title'],
'text' => $q['text'],
));
}

کارش هم اینه که هرچی تو table مربوطه هست رو نشون میده
امیدوارم خوب توضیح داده باشم
موفق باشید

[Mr.Moghadam]

سلام ممنون خیلی عالی بود

فقط یه سوال دیگه

اگه خواسته باشیم header & Footer رو جدا وارد کنیم چجوری میشه؟

مثلا من توی header یه سری اطلاعات رو که مربوط به منو هست از دیتابیس میگیرم و میخوام توی همه صفحات نشون داده بشه اینجا چه کار باید بکنیم؟

یه چیز دیگه من از فریم ورک Codegniter استفاده میکنم میتونین یه توضیح مختصر بدین چجوری میشه اینو با یه فریم ورک (که layout نداره ) ترکیب کرد؟

بازم ممنون موفق باشید