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。
