CodeIgniter log_message调试方法及应用教程

本文深入解析了CodeIgniter 3.x中log_message()调试日志功能的常见失效原因与实战解决方案，涵盖LOG_PATH路径配置、文件权限设置、日志级别匹配、阈值控制、编码与换行处理等关键细节，并指出CI 4已弃用该函数而需改用Logger服务；同时提供多环境配置、系统日志对接及日志轮转维护等进阶技巧，帮助开发者快速定位“日志不写入”的顽疾，让调试真正高效可靠。

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 自己扛。

今天关于《CodeIgniter log_message调试方法及应用教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！