解析ThinkPHP5.1自定義標(biāo)簽怎么用

這篇文章主要介紹解析ThinkPHP5.1自定義標(biāo)簽怎么用，文中介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們一定要看完！

近來(lái)有項(xiàng)目需要用的自定義的標(biāo)簽，TP使用的是5.1，各位要注意，5.1較5.0在目錄結(jié)構(gòu)和程序上有較大的改動(dòng)。注意自己的版本。下面進(jìn)入正題。

一、創(chuàng)建標(biāo)簽函數(shù)文件

在模型目錄下創(chuàng)建目錄 tabLib，在目錄里創(chuàng)建一個(gè)Cms.php

namespace app\cms\tagLib;
use think\Db;
use think\template\TagLib;

class Cms extends TagLib{

    protected $tags = [
        //標(biāo)簽定義： attr 屬性列表，close 是否閉合（0或1，默認(rèn)1），alias標(biāo)簽別名 level嵌套層次
        'lists' => ['attr' => 'num,order,sort'],
    ];

    // 當(dāng)不使用content的時(shí)候，閉合標(biāo)簽沒(méi)有效果
    // 修改過(guò)此文件后，需要改動(dòng)下模板的內(nèi)容，否則模板有緩存不會(huì)執(zhí)行新的內(nèi)容。
    public function tagLists($tag,$content){
        $cateID = $tag['cate_id']; //欄目ID
        $num    = $tag['num']; //數(shù)量
        $order  = input($tag['order']); //排序方式
        $type = $cateID;
        $name = $tag['name'];
        $tableName = 'table_name';
        $parse = '<?php $map=[];';
        $parse .= '$__LIST__ = Db::name('.$tableName.')->where(["cate_id"=>'. $cateID .'])
            ->limit('.$num.')
            ->select(); ?>';
        $parse .= '{volist name="__LIST__" id="'. $name .'"}';
        $parse .= $content;
        $parse .= "{/volist}";
        return $parse;
    }

在開(kāi)發(fā)中遇到疑惑：

1. 上面的tagLists 函數(shù)對(duì)應(yīng) protected $tags中的標(biāo)簽定義，大小寫(xiě)要注意，否則是找不到函數(shù)的。

2. $parse 字符中全部為組裝的字符串，該字符串會(huì)被TP的模板標(biāo)簽再解析一次，所以在里面可以使用TP原有的標(biāo)簽或原生的PHP語(yǔ)句。但是不可以把外面的Array或?qū)ο笞鰹閰?shù)傳入$param中，要知道他只是一個(gè)用來(lái)組裝的字符串。請(qǐng)注意 $__LIST__這個(gè)變量的使用，要想從數(shù)據(jù)庫(kù)中讀取數(shù)據(jù)，必須寫(xiě)完整的PHP代碼，不可以在外面執(zhí)行完查詢，然后把查詢后的list做為變量傳入。

二、在模板配置信息中加載此標(biāo)簽函數(shù)

在模塊 cms/config/template.php 中加入一句： 'taglib_pre_load' => 'app\cms\tagLib\Cms',

如果你沒(méi)有此文件，可以在根目錄里的config目錄下，復(fù)制一份template放到cms/config目錄下。

三、在模板中使用標(biāo)簽。

  {cms:lists name="row" num="10" cate_id="5" order="1"}
        <li>{$row.title}</li>
    {/cms:lists}

name, num ,cate_id 等屬性會(huì)作為tagLists的第一個(gè)參數(shù) $tags傳入。而{cms:lists} 和 {$/cms:lists}之間的內(nèi)容，會(huì)作為一個(gè)完整的字符串$content 傳入 tagLists 的第二個(gè)參數(shù)。

注意：這里分閉合標(biāo)簽和非閉合標(biāo)簽，如果是閉合標(biāo)簽，則必須在（一）中使用content,如果是非閉合標(biāo)簽則可以不用。如果你不使用content變量，則閉合的標(biāo)簽 {/cms:lists}會(huì)被原樣輸出，不會(huì)進(jìn)行解析。

暫時(shí)有這么多的困惑，關(guān)于分頁(yè)列表的問(wèn)題還在研究，研究完了再補(bǔ)充上來(lái)。

補(bǔ)充：在tagList中不要對(duì)$tag[]數(shù)組中獲取到的數(shù)據(jù)進(jìn)行數(shù)據(jù)類(lèi)型轉(zhuǎn)換，因?yàn)楫?dāng)傳過(guò)來(lái)的是一個(gè)變量時(shí)，這個(gè)變量不會(huì)生效！！所以在這里使用intval($tag[num])是不對(duì)的。

以上是“解析ThinkPHP5.1自定義標(biāo)簽怎么用”這篇文章的所有內(nèi)容，感謝各位的閱讀！希望分享的內(nèi)容對(duì)大家有幫助，更多相關(guān)知識(shí)，歡迎關(guān)注億速云行業(yè)資訊頻道！