CodeIgniter框架中如何使用Cookie辅助函数来高效管理用户Cookie数据？

本文共计883个文字，预计阅读时间需要4分钟。

CodeIgniter 中不自动加载 cookie 辅助函数，您需要在控制器中手动加载。在控制器中直接使用 `set_cookie('a', 'b');` 可能会报错。正确的做法是先在控制器中加载 cookie 辅助函数，例如：

• 在控制器方法开头加 $this->load->helper('cookie');
• 或在 application/config/autoload.php 里把 'cookie' 加进 $autoload['helpers'] 数组（推荐长期使用场景）
• 别在视图里 load helper 再调用 —— 虽然语法上可行，但 header 已发送后调用 set_cookie() 会静默失败（浏览器收不到 Set-Cookie 头）

set_cookie() 的两种调用方式参数含义完全不同

传数组和传多个参数，字段顺序和默认值都不一样，混用容易导致 domain/path 失效、cookie 写不进子域名或被 JS 读取。

• 多参数形式：set_cookie($name, $value, $expire, $domain, $path, $prefix, $secure)  – $expire 是「秒数」，不是时间戳；0 表示会话级 Cookie（关浏览器即删）  – $domain 若填 '.example.com'，子域（如 api.example.com）可共享；留空则仅当前主机生效  – $path 必须以 / 开头，path => '' 或 path => '\/' 都无效
• 数组形式（更推荐）：set_cookie(['name'=>'token', 'value'=>'abc123', 'expire'=>3600, 'domain'=>'.example.com', 'path'=>'/', 'secure'=>true, 'httponly'=>true])  – 所有字段显式写出，避免歧义；httponly 参数只在数组形式中支持（多参数形式不接受该参数）  – expire 同样是秒数，不是时间戳

删除 Cookie 必须匹配设置时的 domain/path/prefix

delete_cookie('name') 看似简单，但实际删除失败最常见原因就是路径或域不一致。

• 如果当初用 set_cookie(['name'=>'uid', 'domain'=>'.example.com', 'path'=>'/admin']) 设置，  删除时就得写 delete_cookie('uid', '.example.com', '/admin')
• 前缀（prefix）也参与匹配：若设置时用了 'prefix'=>'ci_'，那真实 cookie 名是 ci_uid，  delete_cookie('uid') 删不掉，得用 delete_cookie('uid', '', '/', 'ci_')
• 安全起见，删之前建议先用 get_cookie('uid') 确认它是否存在且可读

别忽略 httponly 和 secure 对调试的影响

这两个选项一旦开启，会立刻改变你观察 cookie 的方式：

• httponly => true：浏览器开发者工具的 Application → Cookies 里仍可见，但 document.cookie 读不到，JS 无法篡改 —— 这是好事，但如果你正用 JS 检查 cookie 是否写入，会误判失败
• secure => true：只在 HTTPS 下生效；本地开发用 http://localhost 时设了这个，cookie 直接不会写入，且无任何提示
• 开发阶段建议先关掉这两个选项（secure=>false, httponly=>false），确认逻辑跑通后再开启

set_cookie 的行为高度依赖上下文：是否已输出内容、是否 HTTPS、domain 是否带点、path 是否合法、helper 是否加载……漏掉任意一环，cookie 就像被吞掉一样无声无息。真正难的不是写那行代码，而是排查哪一层悄悄拦住了它。