项目全局对象实例化最佳实践及CodeIgniter4集成Plates模板方案

嘿，我来帮你搞定这两个问题～

这里给你列几个业界常用的靠谱方案，按推荐程度排序：

• 依赖注入容器（DI Container）：这是目前最主流、最推荐的方式。你可以把需要复用的对象注册到容器中，容器会统一管理实例的创建和生命周期，需要的时候直接从容器里取就行，不用自己反复new。像CodeIgniter 4本身就自带了服务容器，你可以用Services::get()来获取单例实例，或者自定义服务。这种方式不仅能避免重复实例化，还能降低代码耦合度，测试时也更容易做Mock替换。
• 利用框架自带的服务管理：CI4本身就有一套成熟的服务系统（Services），你可以把常用的工具类、第三方库封装成服务，配置成单例模式，这样每次调用都会返回同一个实例。比如你可以在app/Config/Services.php里添加自定义服务方法，之后在控制器、模型里直接调用就行，非常省心。
• 单例模式（谨慎使用）：单例模式能强制一个类只能生成一个实例，通过静态方法获取。不过要注意，单例会让代码耦合度变高，后续测试和扩展都会比较麻烦，所以只适合那种无状态的工具类（比如日志类、配置类）。举个简单的单例实现：

class MyTool {
    private static $instance;
    // 私有构造方法，禁止外部new
    private function __construct() {}
    public static function getInstance() {
        if (!self::$instance) {
            self::$instance = new self();
        }
        return self::$instance;
    }
}

用的时候直接MyTool::getInstance()就能拿到同一个实例，但还是优先推荐DI容器。

• 别用全局变量：尽量别用全局变量来存对象，容易引发命名冲突，代码可读性和维护性都很差，调试起来也头疼，完全不推荐。

我给你整理了一步步的实操方案，照着来就行：

第一步：安装Plates #

用Composer安装，在项目根目录执行命令：

composer require league/plates

第二步：用CI4服务容器管理Plates实例 #

为了避免每次都手动new Plates，我们把它注册成CI4的服务，这样能全局复用实例：
打开app/Config/Services.php，添加一个静态方法：

public static function plates(bool $getShared = true)
{
    if ($getShared) {
        // 返回单例实例
        return static::getSharedInstance('plates');
    }
    // 设置模板路径，这里用CI4默认的Views目录
    $templateDir = APPPATH . 'Views';
    return new \League\Plates\Engine($templateDir);
}

第三步：修改控制器使用Plates #

现在你的Blog控制器可以改成这样：

class Blog extends \CodeIgniter\Controller {
    public function index() {
        $data = [
            'todo_list' => ['Clean House', 'Call Mom', 'Run Errands'],
            'title' => "My Real Title",
            'heading' => "My Real Heading"
        ];
        // 从服务容器获取Plates实例
        $templates = \Config\Services::plates();
        // 渲染模板，Plates默认不用加.php后缀
        echo $templates->render('blogview', $data);
    }
}

第四步：编写Plates模板 #

你的app/Views/blogview.php可以用Plates的语法，比如：

<h1><?= $this->e($heading) ?></h1>
<h2><?= $this->e($title) ?></h2>
<ul>
    <?php foreach($todo_list as $item): ?>
        <li><?= $this->e($item) ?></li>
    <?php endforeach; ?>
</ul>

这里$this->e()是Plates的安全转义方法，能防止XSS攻击，比直接echo更安全。

进阶：替换CI4默认的view方法（可选） #

如果你想让整个项目无缝切换到Plates，不用改太多现有代码，可以写一个基础控制器重写view方法：

// app/Controllers/BaseController.php
class BaseController extends \CodeIgniter\Controller {
    protected $templates;

    public function initController(\CodeIgniter\HTTP\RequestInterface $request, \CodeIgniter\HTTP\ResponseInterface $response, \Psr\Log\LoggerInterface $logger)
    {
        parent::initController($request, $response, $logger);
        // 初始化Plates实例
        $this->templates = \Config\Services::plates();
    }

    protected function view(string $template, array $data = [])
    {
        echo $this->templates->render($template, $data);
    }
}

之后你的Blog控制器继承这个BaseController：

class Blog extends BaseController {
    public function index() {
        $data = [
            'todo_list' => ['Clean House', 'Call Mom', 'Run Errands'],
            'title' => "My Real Title",
            'heading' => "My Real Heading"
        ];
        // 和原来一样调用view方法，底层自动用Plates渲染
        $this->view('blogview', $data);
    }
}

这样就能平滑过渡，不用改原来的控制器调用逻辑～

内容的提问来源于stack exchange，提问作者NoNice