扩展控制器
不应修改 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
{
// ...
}