View Cell 是自动实例化并执行 render() 的组件机制,支持依赖注入、缓存、参数传递与自动转义;include 仅为静态文件包含,无封装、无隔离、无缓存、易污染变量且不安全。

View Cell 会自动实例化类并执行逻辑,include 只是静态加载文件
View Cell 的本质是调用一个 Cell 类(继承自 CI_Cell),框架会自动 new 实例、运行 render() 方法、捕获输出,最后把返回值插入视图。而 include 或 require 只是 PHP 原生的文件包含机制,不做任何封装、不走生命周期、不隔离作用域——变量污染风险高,也无法复用逻辑。
常见错误现象:用 include 'header.php' 时发现 $title 没定义或被上层覆盖;而用 view_cell('Header::display') 时,Header 类内部可安全调用 $this->request、查数据库、设置默认参数,互不影响。
- View Cell 支持传参:
view_cell('User::card', ['id' => 123, 'size' => 'sm']) - include 不支持参数传递(除非手动 extract 或全局变量,不推荐)
- View Cell 默认启用缓存(可关),include 完全无缓存能力
View Cell 的类必须放在 app/Cells/ 目录且命名规范
CodeIgniter 会按约定查找 Cell 类:app/Cells/User/Card.php 对应 User::Card,类名必须首字母大写,且必须继承 CodeIgniter\View\Cell。漏掉命名空间、放错目录、类名大小写不对,都会报 Class 'App\Cells\User\Card' not found。
对比 include:路径写错就直接 Warning: include(): Failed opening,但不会校验类结构或方法签名。
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 正确路径:
app/Cells/Alert/Notice.php→ 调用view_cell('Alert::Notice') - 错误示例:
app/Views/cells/alert/notice.php(目录错)、notice.php(类名应为Notice) - Cell 类里必须有
render()方法,否则运行时报Call to undefined method
View Cell 天然支持依赖注入和测试隔离,include 做不到
View Cell 类构造函数可以声明 Model、Service 等依赖,框架自动注入;你也可以在测试中单独 new 这个 Cell 类并 mock 依赖。而 include 的模板文件通常混着 HTML 和查询语句(比如 $user = $db->table('users')->find(1);),逻辑耦合重,没法单元测试。
- Cell 示例:
public function __construct(private UserModel $model) {} - include 场景下若要查数据,只能靠全局
service('database')或传入变量,易出错 - 性能影响:View Cell 有轻微初始化开销,但换来的是可维护性;高频小部件(如实时通知数)建议开启缓存:
view_cell('Notification::count', [], '60')
include 更适合纯展示片段,View Cell 适合带状态/逻辑的组件
要不要用 View Cell,关键看这个“片段”是否需要独立行为:比如分页导航要读取当前 URI、计算总页数;用户头像要根据登录态决定显示编辑按钮;这些都该用 Cell。而纯静态的页脚版权信息、SVG 图标内联代码,用 include 更轻量、更直观。
容易被忽略的一点:View Cell 的 render() 返回值会被自动 htmlspecialchars() 转义(取决于全局 esc() 配置),而 include 输出的内容不会自动转义——这意味着你得自己记得对变量调用 esc(),否则 XSS 风险更高。










