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 ?? 'My Site' ?></title>
<link rel="stylesheet" href="/assets/css/app.css">
</head>
<body>
<header>...</header>
<main>
= $content_for_layout ?? '' ?>
</main>
<footer>...</footer>
</body>
</html>
views/blog/index.tpl<article>
<h1>Latest Posts</h1>
<ul>
<li><a href="/blog/= $post->slug ?>">= $post->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 | 支援返回字串、直接輸出、佈局注入 |
| 模板引擎整合 | 困難 | 策略模式輕鬆切換 |
| 向下相容 | - | ✅ 參數預設值保持一致 |
application/core/MY_Controller.php (CI3) 或 app/Controllers/BaseController.php (CI4)MY_Controller 而非 CI_Controller.php 視圖重命名為 .tpl (或設定 $template_ext = '.php' 保持不變)這個極輕量的擴展(< 50 行核心代碼)即可賦予 CodeIgniter 現代框架級的視圖管理能力,零依賴、零配置、零侵入,強烈推薦所有 CI 專案採用。