CodeIgniter 可作纯后端 API 服务:需禁用视图自动加载(构造函数调用 unset_template())、统一 JSON 响应结构(封装 response() 方法并启用 JSON_UNESCAPED_UNICODE)、正则配置路由(如 $route['api/v1/(:any)'] = 'api/$1')、设置 uri_protocol 为 REQUEST_URI,并适配 CSRF(改用 Header 传 Token)与 Session(切至 database/redis)。

CodeIgniter 本身不是为前后端分离设计的,但完全可以用它做后端 API 服务——关键在于剥离视图渲染、禁用模板逻辑、统一响应格式,并绕过默认的 URI 路由限制。
如何关闭 CodeIgniter 的视图自动加载
默认情况下,CI_Controller 的子类会尝试加载对应方法名的视图(如 index() 自动找 index.php 视图),这在纯 API 场景下不仅多余,还会导致 404 或空白响应。
- 在控制器构造函数里加
$this->output->unset_template();(CI 3.1.11+)或直接不调用$this->load->view() - 确保所有响应都显式调用
$this->output->set_content_type('application/json')->set_output(...) - 避免使用
redirect()或show_404()这类面向浏览器跳转/页面渲染的函数
怎么让 CodeIgniter 返回标准 JSON 响应结构
前端需要稳定字段(如 code、data、message),而不是裸 json_encode()。手动封装容易遗漏状态码或 Content-Type。
- 在基础控制器(如
API_Controller)中定义response($data = [], $code = 200, $msg = 'success')方法 - 内部统一调用
$this->output->set_status_header($code)->set_content_type('application/json', 'utf-8')->set_output(json_encode([...], JSON_UNESCAPED_UNICODE)) - 特别注意:
JSON_UNESCAPED_UNICODE必须启用,否则中文变 \uXXXX
为什么路由匹配不到 /api/v1/users 这类路径
CodeIgniter 默认路由规则把 / 当作分隔符,而 RESTful 路径中的斜杠会被截断或误判,尤其当启用 enable_query_strings = FALSE(默认)时更明显。
- 在
config/routes.php中用正则显式声明:$route['api/v1/(:any)'] = 'api/$1'; - 确保
$config['uri_protocol']设为REQUEST_URI(而非AUTO或PATH_INFO),避免 Apache mod_rewrite 干扰 - 若用 Nginx,确认已配置
try_files $uri $uri/ /index.php?$query_string;,否则/api/v1/xxx会 404
CSRF 和 Session 怎么适配 AJAX 请求
前后端分离后,Cookie 不再自动携带(尤其跨域),csrf_protection = TRUE 会导致所有 POST/PUT/DELETE 请求被拦截。
- 要么关闭 CSRF(
$config['csrf_protection'] = FALSE;),仅靠 Token + HTTPS 防重放 - 要么保留 CSRF,但改用 header 传递:
$this->security->get_csrf_hash()在登录成功后返回给前端,后续请求带X-CSRF-TOKENheader - Session 存储建议切到
database或redis,避免文件锁在并发 API 下阻塞
真正难的不是写几个 API 接口,而是让 CodeIgniter “忘记自己是个 MVC 框架”——删掉所有 view 加载、绕过自动重定向、接管输出流、把路由当成字符串匹配器用。这些地方一旦漏掉,前端就收不到数据,只看到空响应或 500。


















