CodeIgniter 4：优化视图层数据处理，避免直接数据库操作

CodeIgniter 4：优化视图层数据处理，避免直接数据库操作

本教程旨在解决CodeIgniter 4应用中视图层直接执行数据库查询的问题，这种做法违反了MVC设计模式的核心原则。我们将探讨为何应避免在视图中进行数据请求，并提供一套专业的解决方案，通过在控制器或服务层预处理数据，确保视图仅负责渲染已准备好的数据，从而提升代码的可维护性、可测试性和整体架构的清晰度。

视图层数据库操作的危害

在codeigniter 4中，视图（view）的主要职责是接收控制器（controller）传递的数据并将其渲染成html输出。然而，常见的一个误区是在视图中直接执行数据库查询，例如为了获取主菜单下的子菜单数据。原始视图代码中存在以下问题：

<?php $db = /Config/Database::connect(); ?> // 避免在视图中执行此操作
<?php $submenu = $this->db->query("SELECT * FROM submenu WHERE id_mainmenu = $idmainmenu"); ?> // 避免在视图中执行此操作
登录后复制

这种做法严重违反了MVC（Model-View-Controller）设计模式的“关注点分离”原则：

  1. 职责混淆： 视图层被赋予了数据获取和业务逻辑处理的职责，而非仅仅是数据展示。
  2. 可维护性差： 数据库查询逻辑分散在视图中，一旦数据库结构或查询方式改变，需要修改多个视图文件，难以维护。
  3. 可测试性低： 视图代码难以独立测试，因为其包含了数据库依赖。
  4. 性能问题： 在循环中执行查询（N+1查询问题）会导致大量的数据库往返，严重影响应用性能。
  5. 安全性风险： 直接在视图中拼接SQL查询可能增加SQL注入的风险（尽管CI4有防护，但仍是潜在隐患）。

为了构建健壮、高效且易于维护的应用程序，所有的数据获取和处理逻辑都应在模型（Model）或服务层（Service Layer）完成，并通过控制器传递给视图。

解决方案：控制器与服务层的数据预处理

最佳实践是在控制器中，利用模型或专门的服务类来获取并组织所有必要的数据，然后将一个结构化的数据数组传递给视图。对于复杂的嵌套数据（如主菜单和子菜单），我们可以一次性获取所有相关数据，并在PHP中进行关联和构建。

1. 定义模型

首先，确保你有对应的模型来处理 mainMenu 和 subMenu 表。

// app/Models/MainMenuModel.php
<?php namespace App/Models;

use CodeIgniter/Model;

class MainMenuModel extends Model
{
    protected $table      = 'mainmenu';
    protected $primaryKey = 'id_mainmenu';
    protected $allowedFields = ['menu_name', 'content'];

    // 可以添加获取所有主菜单的方法
    public function getAllMainMenus()
    {
        return $this->findAll();
    }
}

// app/Models/SubMenuModel.php
<?php namespace App/Models;

use CodeIgniter/Model;

class SubMenuModel extends Model
{
    protected $table      = 'submenu';
    protected $primaryKey = 'id_submenu';
    protected $allowedFields = ['id_mainmenu', 'submenu_name'];

    // 可以添加根据主菜单ID获取子菜单的方法，或者获取所有子菜单
    public function getSubMenusByMainMenuId(int $mainMenuId)
    {
        return $this->where('id_mainmenu', $mainMenuId)->findAll();
    }

    public function getAllSubMenus()
    {
        return $this->findAll();
    }
}
登录后复制

2. 创建一个服务类来组织数据（推荐）

对于更复杂的UI组件，如导航菜单，创建一个专门的服务类来封装数据获取和组织逻辑是一个很好的实践。

// app/Services/MenuService.php
<?php namespace App/Services;

use App/Models/MainMenuModel;
use App/Models/SubMenuModel;

class MenuService
{
    protected $mainMenuModel;
    protected $subMenuModel;

    public function __construct()
    {
        $this->mainMenuModel = new MainMenuModel();
        $this->subMenuModel = new SubMenuModel();
    }

    /**
     * 获取并组织完整的导航菜单数据
     *
     * @return array 结构化的菜单数据
     */
    public function getStructuredMenuData(): array
    {
        $mainMenus = $this->mainMenuModel->getAllMainMenus();
        $subMenus  = $this->subMenuModel->getAllSubMenus(); // 一次性获取所有子菜单

        $structuredMenu = [];
        $subMenusByMainMenu = [];

        // 将子菜单按其所属的主菜单ID进行分组，方便查找
        foreach ($subMenus as $subMenu) {
            $subMenusByMainMenu[$subMenu['id_mainmenu']][] = $subMenu;
        }

        // 将子菜单关联到对应的主菜单
        foreach ($mainMenus as $mainMenu) {
            $mainMenu['sub_menus'] = $subMenusByMainMenu[$mainMenu['id_mainmenu']] ?? [];
            $structuredMenu[] = $mainMenu;
        }

        return $structuredMenu;
    }
}
登录后复制

3. 修改控制器

控制器现在变得非常简洁，它只需要调用服务类来获取预处理好的数据，然后将其传递给视图。

Detect GPT

Detect GPT

一个Chrome插件，检测您浏览的页面是否包含人工智能生成的内容

Detect GPT38


查看详情
Detect GPT 

// app/Controllers/Dashboard.php
<?php namespace App/Controllers;

use App/Controllers/BaseController;
use App/Services/MenuService; // 引入MenuService

class Dashboard extends BaseController
{
    protected $menuService;

    public function __construct()
    {
        $this->menuService = new MenuService();
    }

    public function user()
    {
        $data = [
            'navigationMenu' => $this->menuService->getStructuredMenuData(), // 获取结构化菜单数据
            // 其他可能需要传递给视图的数据
        ];

        return view('dashboard/user', $data);
    }
}
登录后复制

4. 优化视图层

视图现在只负责遍历和渲染数据，不再包含任何数据库查询逻辑。

<!-- app/Views/dashboard/user.php -->
<div class="navigation">
  <div class="container">
    <div class="row">
      <div class="navbar">
        <a href="#" class="nav-brand">My Web Admin</a>
        <nav class="nav">
          <ul>
            <?php foreach($navigationMenu as $mainMenuItem): ?>
              <li>
                <a href="#"><?= esc($mainMenuItem['menu_name']); ?></a>
                <?php if (!empty($mainMenuItem['sub_menus'])): ?>
                  <ul>
                    <?php foreach($mainMenuItem['sub_menus'] as $subMenuItem): ?>
                      <li><a href="#"><?= esc($subMenuItem['submenu_name']); ?></a></li>
                    <?php endForeach; ?>
                  </ul>
                <?php endif; ?>
              </li>
            <?php endForeach; ?>
          </ul>
        </nav>
      </div>
    </div>
  </div>
</div>
登录后复制

注意事项：

  • esc() 函数用于输出HTML内容时进行转义，防止XSS攻击。
  • !empty($mainMenuItem[‘sub_menus’]) 检查确保只有当存在子菜单时才渲染子菜单列表。
  • 这种方法解决了N+1查询问题，因为所有子菜单都是一次性获取并分组的。

总结

通过将数据获取和组织逻辑从视图层迁移到控制器或专门的服务层，我们实现了CodeIgniter 4应用中视图的纯粹化。这种方法不仅遵循了MVC设计模式的最佳实践，还带来了多重益处：

  • 清晰的职责分离： 视图专注于展示，控制器协调数据流，模型处理数据持久化，服务层封装复杂业务逻辑。
  • 更高的可维护性： 数据逻辑集中管理，修改和更新更加方便。
  • 更好的可测试性： 业务逻辑可以独立于视图进行单元测试。
  • 性能优化： 避免了视图中的N+1查询，减少了数据库负载。
  • 增强的安全性： 减少了在视图中直接处理数据库查询带来的潜在风险。

始终记住，视图应该尽可能地“愚笨”，只负责接收并显示数据，而不应承担任何数据获取或业务逻辑处理的任务。

以上就是CodeIgniter 4：优化视图层数据处理，避免直接数据库操作的详细内容，更多请关注php中文网其它相关文章！

相关标签：

php html app ai sql注入 red php mvc sql 架构 html xss 封装 循环 数据库 性能优化 ui

https://www.php.cn/faq/1501088.html

发表回复

Your email address will not be published. Required fields are marked *