CodeIgniter全局函数log_message怎么调试_CodeIgniter日志记录函数应用【教程】

log_message不写日志主因是LOG_PATH配置错误或权限不足；需确保LOG_PATH为绝对路径且以/结尾，Web服务器用户有写权限（如775），日志级别合法且log_threshold足够高。

log_message 函数不写日志？先检查 LOG_PATH 和权限

CodeIgniter 的 log_message() 默认不输出到屏幕，只写文件；如果没看到日志，大概率是路径不可写或配置被覆盖。
常见错误现象：log_message('Error', 'test') 执行后日志目录空空如也，application/logs/ 下无新文件，甚至目录都不存在。

• LOG_PATH 必须以 / 结尾，且需为绝对路径（推荐用 APPPATH . 'logs/'）
• 确保 Web 服务器用户（如 www-data、nginx、apache）对 application/logs/ 有写权限，chmod 755 不够，得 775 或更宽松
• CI 4 中该函数已移除，CI 3.x 才有效；CI 4 应改用 log_message() 的替代方案：服务容器里的 Logger 实例
• 若在 CLI 环境调用，注意 CLI 用户（如 root）和 Web 用户权限分离，日志可能写到不同位置

日志级别写错导致消息被过滤

log_message() 第一个参数是级别字符串，不是任意文本；写错就静默丢弃，不报错也不提示。

• 合法值只有：'error'、'debug'、'info'、'warning'（大小写敏感，'Error' 无效）
• 实际写入取决于 $config['log_threshold'] 配置：设为 1 只记 error，4 才记全部；默认是 1，所以 log_message('debug', ...) 在默认配置下不会落盘
• CI 3.1.11+ 支持 'critical' 和 'alert'，但需确认 CI 版本，低版本会直接忽略

中文乱码或特殊字符截断？注意文件编码和换行符

日志文件用 UTF-8 无 bom 编码写入，但若传入的字符串含 GBK 字节或未转义换行，会导致内容错位或截断。

• 避免直接传 $_POST 或 $_GET 原始数据；先用 html_escape() 或 strip_tags() 清理，再传入 log_message()
• 日志内容里含换行符（n）会被自动替换成空格——这是 CI 3 内部行为，无法关闭；如需保留结构，得自己拼接成单行或改用 file_put_contents() 直写
• 若日志中出现 符号，说明传入了非 UTF-8 字符串；PHP 文件本身、数据库连接、输入源都要统一 UTF-8

想临时禁用日志或切到 syslog？别动函数，改配置

硬编码里删 log_message() 或加 if 判断既难维护又易漏，正确做法是利用 CI 的配置机制。

• 把 $config['log_threshold'] = 0 设为 0 即全局关闭，比注释代码干净得多
• 想发到系统日志？修改 $config['log_path'] = '/var/log/myapp.log'; 并确保 PHP 有权限写该路径；CI 不支持原生 syslog，如需对接 rsyslog，得自己封装写入逻辑
• 多环境差异：开发环境设 log_threshold = 4，生产环境设 1 或 2，通过 ENVIRONMENT 常量加载不同 config

最常被忽略的是：日志文件达到 2MB 后 CI 会自动轮转并压缩（.php 后缀），但压缩失败时可能卡住后续写入——建议定期清理旧日志，或用 logrotate 管理，别全靠 CI 自己扛。