萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

CodeIgniter 重寫 View 載入機制:支援自訂模板副檔名與輸出控制

CodeIgniter 預設 $this->load->view() 強制使用 .php 副檔名且輸出行為固定。專案若需支援 .tpl、.html、.blade.php 等多種模板格式,或需統一控制輸出緩衝、佈局嵌套,必須擴展核心載入器。本文提供一個極簡的 MY_Controller 基類實作,實現 View 載入的完全可配置化。

核心實作:application/core/MY_Controller.php

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

/**
 * 通用基底控制器
 * 擴展 View 載入功能:自訂副檔名、輸出模式控制、佈局支援
 */
class MY_Controller extends CI_Controller {

    /** @var string 預設模板副檔名 */
    protected $template_ext = '.tpl';

    /** @var string 佈局模板路徑 (相對 views/),空則不使用佈局 */
    protected $layout = '';

    public function __construct() {
        parent::__construct();
        // 可在此載入共用模型、資料庫、驗證等
    }

    /**
     * 重寫 view() 方法
     * @param string $view 視圖名稱 (不含副檔名)
     * @param array  $data  傳遞給視圖的資料
     * @param bool   $return TRUE=返回字串 FALSE=直接輸出 (預設)
     * @param string $ext    指定副檔名,覆蓋 $this->template_ext
     * @return string|void
     */
    public function view($view, $data = [], $return = false, $ext = null) {
        $ext = $ext ?? $this->template_ext;
        $view_file = $view . $ext;

        // 若啟用佈局模式,將視圖內容注入佈局
        if ($this->layout) {
            $data['content_for_layout'] = $this->load->view($view_file, $data, true);
            return $this->load->view($this->layout . $ext, $data, $return);
        }

        return $this->load->view($view_file, $data, $return);
    }

    /**
     * 設定當前請求的模板副檔名
     */
    public function setTemplateExt(string $ext): self {
        $this->template_ext = $ext;
        return $this;
    }

    /**
     * 設定佈局模板
     */
    public function setLayout(string $layout): self {
        $this->layout = $layout;
        return $this;
    }
}

使用範例

控制器繼承

<?php
class Blog extends MY_Controller {
    public function index() {
        $this->setLayout('layouts/main')  // 使用 views/layouts/main.tpl 作為佈局
             ->setTemplateExt('.twig');   // 臨時切換為 Twig 模板
        
        $this->view('blog/index', [
            'posts' => $this->post_model->get_latest(10)
        ]);
    }
}

佈局模板 views/layouts/main.tpl

<!DOCTYPE html>
<html>
<head>
    <title></title>
    <link rel="stylesheet" href="/assets/css/app.css">
</head>
<body>
    <header>...</header>
    <main>
        
    </main>
    <footer>...</footer>
</body>
</html>

內容視圖 views/blog/index.tpl

<article>
    <h1>Latest Posts</h1>
    <ul>
    
        <li><a href="/blog/slug ?>">title ?></a></li>
    
    </ul>
</article>

進階擴充:整合模板引擎

若需整合 Twig、Blade、Smarty 等編譯型模板引擎,建議改寫 view() 使用服務容器解析渲染器:

public function view($view, $data = [], $return = false, $ext = null) {
    $renderer = $this->getTemplateRenderer($ext ?? $this->template_ext);
    $output = $renderer->render($view . ($ext ?? $this->template_ext), $data);
    
    if ($this->layout) {
        $data['content_for_layout'] = $output;
        $output = $renderer->render($this->layout . ($ext ?? $this->template_ext), $data);
    }
    
    if ($return) return $output;
    echo $output;
}

protected function getTemplateRenderer(string $ext): TemplateRendererInterface {
    return match($ext) {
        '.twig'  => $this->twigRenderer,
        '.blade' => $this->bladeRenderer,
        default  => new NativePhpRenderer($this->load),
    };
}

關鍵優勢總結

特性原生 load->view()MY_Controller::view()
自訂副檔名❌ 僅 .php✅ 任意副檔名
佈局/嵌套❌ 需手動 include✅ 內建 $content_for_layout
輸出控制僅 true/false支援返回字串、直接輸出、佈局注入
模板引擎整合困難策略模式輕鬆切換
向下相容-✅ 參數預設值保持一致

遷移指南

  1. 建立 application/core/MY_Controller.php (CI3) 或 app/Controllers/BaseController.php (CI4)
  2. 所有控制器繼承 MY_Controller 而非 CI_Controller
  3. 將現有 .php 視圖重命名為 .tpl (或設定 $template_ext = '.php' 保持不變)
  4. 逐步引入佈局模板,消除重複的 header/footer include

這個極輕量的擴展(< 50 行核心代碼)即可賦予 CodeIgniter 現代框架級的視圖管理能力,零依賴、零配置、零侵入,強烈推薦所有 CI 專案採用。

copyright © 萬盛學電腦網 all rights reserved