開源輕便的PHP模板引擎phptpl，簡潔就是美。

時間  2019-11-12
標籤 開源 輕便 php 模板 引擎 phptpl 簡潔 就是 欄目 PHP 简体版
原文   原文鏈接

phptpl是一個輕便的PHP模板引擎。不須要什麼學習成本就能輕鬆掌握，簡潔就是美。

最近想寫一個項目管理平臺，原來想用本身 搭建的LAPC/F平臺來開發，考慮到推廣使用的便捷性，最後決定重拾多年未用的PHP（不用編譯就是便捷）。搜了下發現如今的PHP開發已經不是我讀大 學時的原始了，模板、MVC啥啥的滿天飛，PHP級別的語言用MVC仍是算了吧，模板卻是個好東西，神馬規模的工程都能用，最主要是分離PHP和HTML 代碼，我大學時都是把PHP和HTML混雜的寫，雖然直觀但看的眼睛疼。其實模板實現的原理並不複雜，但網上搜到的要不都是大象級別的夠我學一學期了，要 不就是太簡單不少功能都沒有，最後就順手本身寫了個，實際使用中效果不錯，放出來給你們也玩玩 ^_^

phptpl設計目標：
·PHP模板說穿了其實就是加載一個HTML，把其中一些字符串替換後按HTML輸出，好比把"$TITLE$"替換成"test phptpl"。
·網頁裏面不免會有大量表格，PHP模板還要處理可重複出現的明細。
·剛纔看了誰實現的PHP模板引擎，擁有判斷條件影響某HTML區域出現的功能，好吧，我也要支持它！

未寫實現先寫測試案例

PHP模板文件 test_phptpl.html php

$TITLE$$TABLE_HEADER$$USER_ID$$USER_NAME$somebody loginno user login

測試phptpl文件 test_phptpl.php html

<?php
/**
 * test phptpl
 */

require "phptpl.php" ;

// 字符串替換配置
$str_replace_array['$TITLE$'] = "test_phptpl" ;
$str_replace_array['$TABLE_HEADER$'] = "MY_TABLE_HEADER" ;
// 明細替換配置
function detail_function( $in_str = null , $print_flag = false )
{
    if( $in_str == null )
        return null;
    
    $out_str = "" ;
    for( $i = 1 ; $i <= 3 ; $i++ )
    {
        $str_replace_array = array() ;
        $str_replace_array['$USER_ID$'] = "MY_TITLE_" . (string)$i ;
        $str_replace_array['$USER_NAME$'] = "MY_USER_NAME_" . (string)$i ;
        
        $out_str .= phptpl_str( $in_str , $str_replace_array , null , null , null , false ) ;    
    }
    
    if( $print_flag == true )
        print $out_str ;
    
    return $out_str;
}
$section_replace_array['$DETAIL$'] = "detail_function" ;
// 區域存在配置
$if_exist_array['$LOGIN$'] = true ;
// 執行模板處理並當即輸出
phptpl_file( "test_phptpl.html" , $str_replace_array , null , null , $if_exist_array , $section_replace_array , true );
?>

天馬行空一番後開始認真寫phptpl實現 phptpl.php git

<?php
/**
 * phptpl - PHP Cute Template Engine
 * AUTHOR    : calvin(calvinwilliams.c@gmail.com)
 * COPYRIGHT : by calvin
 * LICENSE   : LGPL (http://www.gnu.org/licenses/lgpl.html)
 * VERSION   : v1.0.0 2014-02-16 create
 */

// PHP模板引擎，輸入源爲字符串
function phptpl_str( $in_str = null , $str_replace_array = null , $ereg_replace_array = null , $preg_replace_array = null , $if_exist_array = null , $section_replace_array = null , $print_flag = false )
{
    if( $in_str == null )
        return null;
    
    $out_str = $in_str ;
    
    // 處理字符串替換
    if( $str_replace_array != null )
    {
        $replace_from_array = array() ;
        $replace_to_array = array() ;
        
        foreach( $str_replace_array as $key => $value )
        {
            $value = $str_replace_array[$key] ;
            
            $replace_from_array[] = $key ;
            $replace_to_array[] = $value ;
        }
        
        $out_str = str_replace( $replace_from_array , $replace_to_array , $out_str ) ;
    }
    
    // 處理字符串PCRE正則替換
    if( $ereg_replace_array != null )
    {
        $replace_from_array = array() ;
        $replace_to_array = array() ;
        
        foreach( $ereg_replace_array as $key => $value )
        {
            $value = $ereg_replace_array[$key] ;
            
            $replace_from_array[] = $key ;
            $replace_to_array[] = $value ;
        }
        
        $out_str = ereg_replace( $replace_from_array , $replace_to_array , $out_str ) ;
    }
    
    // 處理字符串POSIX正則替換
    if( $preg_replace_array != null )
    {
        $replace_from_array = array() ;
        $replace_to_array = array() ;
        
        foreach( $preg_replace_array as $key => $value )
        {
            $value = $preg_replace_array[$key] ;
            
            $replace_from_array[] = $key ;
            $replace_to_array[] = $value ;
        }
        
        $out_str = preg_replace( $replace_from_array , $replace_to_array , $out_str ) ;
    }
    
    // 處理區域存在
    if( $if_exist_array != null )
    {
        foreach( $if_exist_array as $key => $value )
        {
            $begin_str = "" ;
            $middle_str = "" ;
            $end_str = "" ;
            $begin_pos = strpos( $out_str , $begin_str ) ;
            $middle_pos = strpos( $out_str , $middle_str ) ;
            $end_pos = strpos( $out_str , $end_str ) ;
            if( $begin_pos == true && $end_pos == true )
            {
                if( $middle_pos == false )
                {
                    if( $value == false )
                    {
                        $segment_str1 = substr( $out_str , 0 , $begin_pos ) ;
                        $segment_str3 = substr( $out_str , $end_pos + strlen($end_str) ) ;
                        $out_str = $segment_str1 . $segment_str3 ;
                    }
                }
                else
                {
                    if( $value == true )
                    {
                        $segment_str1 = substr( $out_str , 0 , $middle_pos ) ;
                        $segment_str3 = substr( $out_str , $end_pos + strlen($end_str) ) ;
                        $out_str = $segment_str1 . $segment_str3 ;
                    }
                    else
                    {
                        $segment_str1 = substr( $out_str , 0 , $begin_pos ) ;
                        $segment_str3 = substr( $out_str , $middle_pos + strlen($middle_str) ) ;
                        $out_str = $segment_str1 . $segment_str3 ;
                    }
                }
            }
        }
    }
    
    // 處理明細
    if( $section_replace_array != null )
    {
        foreach( $section_replace_array as $key => $value )
        {
            $begin_str = "" ;
            $end_str = "" ;
            $begin_pos = strpos( $out_str , $begin_str ) ;
            $end_pos = strpos( $out_str , $end_str ) ;
            if( $begin_pos == true && $end_pos == true )
            {
                $segment_str1 = substr( $out_str , 0 , $begin_pos ) ;
                $segment_str2 = substr( $out_str , $begin_pos + strlen($begin_str) , $end_pos - $begin_pos - strlen($begin_str) ) ;
                $segment_str3 = substr( $out_str , $end_pos + strlen($end_str) ) ;
                
                $segment_str2 = $section_replace_array[$key]( $segment_str2 , false ) ;
                $out_str = $segment_str1 . $segment_str2 . $segment_str3 ;
            }
        }
    }
    
    /* 處理當即輸出標誌 */
    if( $print_flag == true )
        print $out_str;
    
    return $out_str;
}

// PHP模板引擎，輸入源爲模板文件名
function phptpl_file( $in_pathfilename = null , $str_replace_array = null , $ereg_replace_array = null , $preg_replace_array = null , $if_exist_array = null , $section_replace_array = null , $print_flag = false )
{
    if( $in_pathfilename == null )
        return null;
    
    $fp = fopen( $in_pathfilename , "r" ) ;
    $out_str = fread( $fp , filesize($in_pathfilename) );
    fclose($fp);
    
    return phptpl_str( $out_str , $str_replace_array , $ereg_replace_array , $preg_replace_array , $if_exist_array , $section_replace_array , $print_flag );
}
?>

在apache裏建了個虛擬主機跑test_phptpl.php，運行一次經過，看來十年前學的PHP功底仍是那麼紮實，吼吼

爲了展現模板處理先後對比，我再把模板HTML貼一遍 apache

$TITLE$$TABLE_HEADER$$USER_ID$$USER_NAME$somebody loginno user login

用phptpl模板引擎處理後輸出 數組

test_phptplMY_TABLE_HEADERMY_TITLE_1MY_USER_NAME_1MY_TITLE_2MY_USER_NAME_2MY_TITLE_3MY_USER_NAME_3somebody login

輸出太多，整理以下 瀏覽器

$TITLE$

替換成了 函數

test_phptpl

了 學習

$TABLE_HEADER$

替換成了 測試

MY_TABLE_HEADER

了 ui

    $USER_ID$$USER_NAME$

替換成了 

    MY_TITLE_1MY_USER_NAME_1MY_TITLE_2MY_USER_NAME_2MY_TITLE_3MY_USER_NAME_3

了 

somebody loginno user login

過濾成了 

somebody login

了

大功告成
最後來解釋下測試代碼 

<?php
/**
 * test phptpl
 */

require "phptpl.php" ;

// 字符串替換配置
$str_replace_array['$TITLE$'] = "test_phptpl" ;
$str_replace_array['$TABLE_HEADER$'] = "MY_TABLE_HEADER" ;
// 明細替換配置
function detail_function( $in_str = null , $print_flag = false )
{
    if( $in_str == null )
        return null;
    
    $out_str = "" ;
    for( $i = 1 ; $i <= 3 ; $i++ )
    {
        $str_replace_array = array() ;
        $str_replace_array['$USER_ID$'] = "MY_TITLE_" . (string)$i ;
        $str_replace_array['$USER_NAME$'] = "MY_USER_NAME_" . (string)$i ;
        
        $out_str .= phptpl_str( $in_str , $str_replace_array , null , null , null , false ) ;    
    }
    
    if( $print_flag == true )
        print $out_str ;
    
    return $out_str;
}
$section_replace_array['$DETAIL$'] = "detail_function" ;
// 區域存在配置
$if_exist_array['$LOGIN$'] = true ;
// 執行模板處理並當即輸出
phptpl_file( "test_phptpl.html" , $str_replace_array , null , null , $if_exist_array , $section_replace_array , true );
?>

函數phptpl_file第一個參數是要裝載的外部HTML模板文件，第二個參數是字符串替換數組配置，賦值格式爲 

$str_replace_array['(源字符串)'] = "(目標字符串)" ;

對應HTML模板裏出現"(源字符串)"
這樣的格式在代碼中指明，也能夠從配置文件讀入，第三個參數和第四個參數也是用於字符串替換配置，只不過是用做兩種正則表達，第五個參數是判斷布爾型變量決定模板中一個區域是否出現，賦值格式爲 

$if_exist_array['(區域名)'] = true ;

對應HTML模板裏 

<!-- IF (區域名) -->
區域1
<!-- ELSE (區域名) -->
區域2
<!-- ENDIF (區域名) -->

第六個參數是可重複明細區域的回調函數指針，賦值格式爲 

$section_replace_array['$DETAIL$'] = "detail_function" ;

對應HTML模板裏 

    $USER_ID$$USER_NAME$

最後一個參數表示最後實例化的模板是否當即輸出到標準輸出，即瀏覽器，當設置爲false時做爲函數返回值返回到上層。

整個phptpl模板引擎只有兩個函數 

// PHP模板引擎，輸入源爲字符串
function phptpl_str( $in_str = null , $str_replace_array = null , $ereg_replace_array = null , $preg_replace_array = null , $if_exist_array = null , $section_replace_array = null , $print_flag = false )
// PHP模板引擎，輸入源爲模板文件名
function phptpl_file( $in_pathfilename = null , $str_replace_array = null , $ereg_replace_array = null , $preg_replace_array = null , $if_exist_array = null , $section_replace_array = null , $print_flag = false )

很簡潔吧 是否是越看越心動了？，那就趕忙下載來玩玩吧 首頁傳送門 : [url]http://git.oschina.net/calvinwilliams/phptpl[/url]

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程