|
==============
소 개 (INTRO)
==============
HTML, 은 물론 XML 과 호환사용이 가능한 템플릿 클래스 입니다. 루프, 복잡한 서브
블록루프 등의 요즘의 템플릿 기능을 대부분 지원하는 템플릿 클래스 입니다. 템플릿
클래스는 많지만 정작 사용하기에는 조금 망설여 지는 부분이 있는데 자체적인 템플릿
을 제작하거나 실제 사용해야하는 경우 눈여겨 볼만한 프로그램인듯 합니다.
클래스 자체또한 깔끔하게 잘 짜여저 있어서 공부에도 도움이 될듯 합니다.
==============
라이센스
==============
파일내 라이센스파일 참조
=============
설 치
=============
독립프로그래이 아니라 설치과정은 따로 없으며 업로드 합으로 설치는
완료되며 사용시에 include 하여 사용하시면 되겠습니다.
사용방법에 대해서는 http://216.218.133.71/~brian/bTemplate/
사이트에서 제공하는 문서를 참조하세요
=============
프로그램소스
=============
<?php
/*--------------------------------------------------------------*
Description: HTML template class.
Author: Brian Lozier (brian@massassi.net)
License: Please read the license.txt file.
*--------------------------------------------------------------*/
class bTemplate {
// Path variables
var $base_path = '/home/brian/public_html/bTemplate/';
// Delimeters for regular tags
var $ldelim = '<';
var $rdelim = ' />';
// Delimeters for beginnings of loops
var $BAldelim = '<';
var $BArdelim = '>';
// Delimeters for ends of loops
var $EAldelim = '</';
var $EArdelim = '>';
// Internal variables
var $scalars = array();
var $arrays = array();
var $ifs = array();
var $carrays = array();
/*--------------------------------------------------------------*
Method: bTemplate()
Simply sets the base path (if you don't set the default).
*--------------------------------------------------------------*/
function bTemplate($base_path = NULL) {
if($base_path != NULL) {
$this->base_path = $base_path;
}
}
/*--------------------------------------------------------------*
Method: set()
Sets all types of variables (scalar, loop, hash).
*--------------------------------------------------------------*/
function set($tag, $var, $if = NULL) {
if(is_array($var)) {
$this->arrays[$tag] = $var;
}
else {
$this->scalars[$tag] = $var;
if($if === TRUE) $this->ifs[] = $tag;
}
}
/*--------------------------------------------------------------*
Method: set_cloop()
Sets a cloop (case loop).
*--------------------------------------------------------------*/
function set_cloop($tag, $array, $cases) {
$this->carrays[$tag] = array(
'array' => $array,
'cases' => $cases);
}
/*--------------------------------------------------------------*
Method: get_tags()
Formats the tags & returns a two-element array.
*--------------------------------------------------------------*/
function get_tags($tag, $directive) {
$tags['b'] = $this->BAldelim . $directive . $tag . $this->BArdelim;
$tags['e'] = $this->EAldelim . $directive . $tag . $this->EArdelim;
return $tags;
}
/*--------------------------------------------------------------*
Method: get_tag()
Formats a tag for a scalar.
*--------------------------------------------------------------*/
function get_tag($tag) {
return $this->ldelim . 'tag:' . $tag . $this->rdelim;
}
/*--------------------------------------------------------------*
Method: get_statement()
Extracts a portion of a template.
*--------------------------------------------------------------*/
function get_statement($t, &$contents) {
// Locate the statement
$tag_length = strlen($t['b']);
$fpos = strpos($contents, $t['b']) + $tag_length;
$lpos = strpos($contents, $t['e']);
$length = $lpos - $fpos;
// Extract & return the statement
return substr($contents, $fpos, $length);
}
/*--------------------------------------------------------------*
Method: parse()
Parses all variables into the template.
*--------------------------------------------------------------*/
function parse($contents) {
// Process the ifs
if(!empty($this->ifs)) {
foreach($this->ifs as $value) {
$contents = $this->parse_if($value, $contents);
}
}
// Process the scalars
foreach($this->scalars as $key => $value) {
$contents = str_replace($this->get_tag($key), $value, $contents);
}
// Process the arrays
foreach($this->arrays as $key => $array) {
$contents = $this->parse_loop($key, $array, $contents);
}
// Process the carrays
foreach($this->carrays as $key => $array) {
$contents = $this->parse_cloop($key, $array, $contents);
}
// Reset the arrays
$this->arrays = array();
$this->carrays = array();
// Return the contents
return $contents;
}
/*--------------------------------------------------------------*
Method: parse_if()
Parses a simple if statement.
*--------------------------------------------------------------*/
function parse_if($tag, $contents) {
// Get the tags & if statement
$t = $this->get_tags($tag, 'if:');
$if = $this->get_statement($t, $contents);
// Process the if statement
$this->scalars[$tag] ? $replace = $if : $replace = NULL;
// Parse & return the template
return str_replace($t['b'] . $if . $t['e'], $replace, $contents);
}
/*--------------------------------------------------------------*
Method: parse_loop()
Parses a loop (recursive function).
*--------------------------------------------------------------*/
function parse_loop($tag, $array, $contents) {
// Get the tags & loop
$t = $this->get_tags($tag, 'loop:');
$loop = $this->get_statement($t, $contents);
// Process the loop
$parsed = NULL;
foreach($array as $key => $value) {
if(is_numeric($key) && is_array($value)) {
$i = $loop;
foreach($value as $key2 => $value2) {
if(!is_array($value2)) {
// Replace associative array tags
$i = str_replace($this->get_tag($tag . '[].' . $key2), $value2, $i);
}
else {
// Check to see if it's a nested loop
$i = $this->parse_loop($tag . '[].' . $key2, $value2, $i);
}
}
}
elseif(is_string($key) && !is_array($value)) {
$contents = str_replace($this->get_tag($tag . '.' . $key), $value, $contents);
}
elseif(!is_array($value)) {
$i = str_replace($this->get_tag($tag . '[]'), $value, $loop);
}
// Add the parsed iteration
if(isset($i)) $parsed .= rtrim($i);
}
// Parse & return the final loop
return str_replace($t['b'] . $loop . $t['e'], $parsed, $contents);
}
/*--------------------------------------------------------------*
Method: parse_cloop()
Parses a cloop (case loop) (recursive function).
*--------------------------------------------------------------*/
function parse_cloop($tag, $array, $contents) {
// Get the tags & loop
$t = $this->get_tags($tag, 'cloop:');
$loop = $this->get_statement($t, $contents);
// Set up the cases
$array['cases'][] = 'default';
$case_content = array();
// Get the case strings
foreach($array['cases'] as $case) {
$ctags[$case] = $this->get_tags($case, NULL);
$case_content[$case] = $this->get_statement($ctags[$case], $loop);
}
// Process the loop
$parsed = NULL;
foreach($array['array'] as $key => $value) {
if(is_numeric($key) && is_array($value)) {
// Set up the cases
if(isset($value['case'])) $current_case = $value['case'];
else $current_case = 'default';
unset($value['case']);
$i = $case_content[$current_case];
// Loop through each value
foreach($value as $key2 => $value2) {
$i = str_replace($this->get_tag($tag . '[].' . $key2), $value2, $i);
}
}
// Add the parsed iteration
$parsed .= rtrim($i);
}
// Parse & return the final loop
return str_replace($t['b'] . $loop . $t['e'], $parsed, $contents);
}
/*--------------------------------------------------------------*
Method: fetch()
Returns the parsed contents of the specified template.
*--------------------------------------------------------------*/
function fetch($file_name) {
// Prepare the path
$file = $this->base_path . $file_name;
// Open the file
$fp = fopen($file, 'rb');
if(!$fp) return FALSE;
// Read the file
$contents = fread($fp, filesize($file));
// Close the file
fclose($fp);
// Parse and return the contents
return $this->parse($contents);
}
}
?>
|
