扩展控制器
不应修改 CodeIgniter 的核心控制器,但框架为你提供了一个默认的类扩展,位于 app/Controllers/BaseController.php。你创建的任何新控制器都应继承 BaseController,以利用预加载的组件和你提供的任何附加功能:
<?php namespace App\Controllers; class Home extends BaseController { // ... }
预加载组件
基础控制器是加载项目每次运行所需使用的任何辅助函数、模型、库、服务等内容的理想位置。辅助函数应添加到预定义的 $helpers 数组中。例如,如果你希望 HTML 和文本辅助函数在所有地方都可用:
<?php namespace App\Controllers; use CodeIgniter\Controller; abstract class BaseController extends Controller { // ... protected $helpers = ['html', 'text']; // ... }
任何其他需要加载的组件或需要处理的数据都应添加到构造函数 initController() 中。例如,如果你的项目大量使用 Session 类,你可能希望在这里初始化它:
<?php namespace App\Controllers; use CodeIgniter\Controller; abstract class BaseController extends Controller { // ... /** * @var \CodeIgniter\Session\Session; */ protected $session; public function initController(/* ... */) { // Do Not Edit This Line parent::initController($request, $response, $logger); $this->session = service('session'); } }
附加方法
基础控制器本身不可路由。作为额外的安全措施,你创建的所有新方法都应声明为 protected 或 private,并且只能通过你创建的继承自 BaseController 的控制器来访问。
其他选项
你可能会发现需要不止一个基础控制器。你可以创建新的基础控制器,只要你创建的其他控制器都继承了正确的基类即可。例如,如果你的项目有一个复杂的公共接口和一个简单的管理门户,你可能希望将 BaseController 用于公共控制器,并为管理控制器创建一个 AdminController。
如果你不想使用基础控制器,可以通过让你的控制器继承系统控制器来绕过它:
<?php namespace App\Controllers; use CodeIgniter\Controller; class Home extends Controller { // ... }