萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

ThinkPHP 核心系統常量、模板變數與配置參數完整速查表

一、模板中常用系統變數 (輸出 $_SERVER、$_SESSION 等超全域變數)

{$Think.server.script_name}        // $_SERVER['SCRIPT_NAME']
{$Think.server.request_uri}        // $_SERVER['REQUEST_URI']
{$Think.session.user_id}           // $_SESSION['user_id']
{$Think.session.user.name}         // 二維陣列支援
{$Think.get.page}                  // $_GET['page']
{$Think.post.username}             // $_POST['username']
{$Think.request.id}                // $_REQUEST['id'] (GET/POST/COOKIE 合併)
{$Think.cookie.remember_token}     // $_COOKIE['remember_token']

// 簡寫別名 (不區分大小寫)
{$_SERVER.script_name}
{$_SESSION.user_id}
{$_GET.page}
{$_COOKIE.remember_token}

二、模板中輸出系統常量

{$Think.const.APP_PATH}            // 專案目錄路徑
{$Think.const.MODULE_NAME}         // 當前模組名
{$Think.const.ACTION_NAME}         // 當前操作名
{$Think.const.THINK_VERSION}       // ThinkPHP 版本
{$Think.const.IS_MOBILE}           // 是否行動裝置 (需自行定義)

// 簡寫 (Think. 可省略)
{$Think.MODULE_NAME}
{$Think.ACTION_NAME}

三、模板特殊內建變數

{$Think.version}       // 框架版本號
{$Think.now}           // 當前時間戳 (time())
{$Think.template}      // 當前模板檔案名
{$Think.LDELIM}        // 模板左定界符 (預設 {)
{$Think.RDELIM}        // 模板右定界符 (預設 })

四、模板輸出配置參數 (等同 C('key'))

{$Think.config.db_charset}       // 資料庫編碼
{$Think.config.url_model}        // URL 模式
{$Think.config.default_module}   // 預設模組
{$Think.config.TMPL_CACHE_ON}    // 模板快取開關

五、模板常用路徑常量 (輸出至 HTML 的 URL/路徑)

{__ROOT__}       // 網站根目錄 (含域名)  如: https://example.com
{__APP__}        // 當前入口檔目錄       如: https://example.com/index.php
{__MODULE__}     // 當前模組地址         如: https://example.com/index.php/Home
{__CONTROLLER__} // 當前控制器地址       如: https://example.com/index.php/Home/User
{__ACTION__}     // 當前操作地址         如: https://example.com/index.php/User/login
{__SELF__}       // 當前完整 URL
{__PUBLIC__}     // 網站公共資源目錄     如: https://example.com/Public
{__STATIC__}     // 靜態資源目錄 (需自行定義)

⚠️ 模板中常量 不需 {$Think.const.} 前綴,直接用 {__ROOT__} 輸出。

六、控制器/模型中常用系統常量 (PHP 端)

常量說明範例值
THINK_PATH框架核心目錄/var/www/thinkphp/
APP_PATH應用程式目錄/var/www/app/
APP_NAME應用名稱Home
MODULE_NAME當前模組名User
ACTION_NAME當前方法名login
TMPL_PATH模板目錄/var/www/app/Home/View/
LIB_PATH類庫目錄/var/www/app/Lib/
CONFIG_PATH配置目錄/var/www/app/Conf/
CACHE_PATH快取目錄/var/www/app/Runtime/Cache/
LOG_PATH日誌目錄/var/www/app/Runtime/Logs/
DATA_PATH資料目錄/var/www/app/Data/
VENDOR_PATH第三方庫目錄/var/www/thinkphp/Vendor/
IS_CLI是否 CLI 模式true/false
IS_AJAX是否 AJAX 請求true/false
NOW_TIME當前時間戳1705315200
THINK_VERSION框架版本3.2.3
MEMORY_LIMIT_ON記憶體限制啟用1/0

七、環境判斷常量

IS_APACHE   // Apache 伺服器
IS_IIS      // IIS 伺服器
IS_WIN      // Windows 環境
IS_LINUX    // Linux 環境

八、自訂常量最佳實踐


// 檔案: Application/Common/Common.php (或 Common/function.php)
define('USER_STATUS_NORMAL', 1);
define('USER_STATUS_BANNED', 2);
define('ORDER_STATUS_PENDING', 10);
define('ORDER_STATUS_PAID', 20);
define('ORDER_STATUS_SHIPPED', 30);
define('ORDER_STATUS_COMPLETED', 40);
define('ORDER_STATUS_CANCELLED', 99);

// 分組常用: 使用陣列常量 (PHP 5.6+)
define('PAY_CHANNELS', [
    'alipay' => '支付寶',
    'wechat' => '微信支付',
    'unionpay' => '銀聯'
]);

九、常見誤區與避坑

  • 模板常量 vs PHP 常量:{__ROOT__} 是模板引擎編譯時替換,PHP 程式碼中用 __ROOT__ (常量) 或 C('WEB_ROOT')。
  • 大小寫敏感:變數區分大小寫 ({$Think.get.page} ≠ {$Think.get.Page}),常量不區分。
  • 三維陣列不支援:{$Think.session.user.profile.avatar} 不會輸出,需在控制器預處理扁平化。
  • URL 生成建議用 U() 函式:{:U('User/profile')} 自動處理 URL 模式、偽靜態、域名部署,比硬編碼常量健壯。
copyright © 萬盛學電腦網 all rights reserved