codeigniter 3/4 均不原生支持 raygun，需手动集成：ci3 用钩子注册异常处理器并加载 sdk，ci4 需重写 exceptionhandler 类；均须补充请求上下文、过滤敏感数据、加 try/catch 防阻塞。

CodeIgniter 本身不内置 Raygun 集成，Raygun_CodeIgniter 是一个第三方扩展包，但该包早已停止维护（最后更新在 CodeIgniter 2.x 时代），在 CI3 或 CI4 中直接使用会失败。

Raygun_CodeIgniter 在 CI3/CI4 中无法直接工作

这个包依赖 Raygun4PHP v1.x，而后者早在 2017 年就已归档，不再兼容 PHP 7.2+ 和现代 autoloader（如 Composer PSR-4）。尝试 require 它会导致：

• Class 'Raygun\RaygunClient' not found（类未加载）
• Call to undefined method CI_Exceptions::get_error() （CI3 的异常处理接口已变更）
• CI4 中根本找不到 CI_Exceptions 类，整个错误捕获机制重构为 CodeIgniter\Exceptions 命名空间

CI3 正确接入 Raygun 的方式是用官方 SDK + 自定义异常钩子

Raygun 官方维护的 raygun4php 虽已归档，但其源码仍可运行；更稳妥的是改用当前活跃的 raygun4php 替代实现（如社区维护的 spatie/raygun-php），或直接调用 Raygun API。实操建议如下：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

• 在 application/config/hooks.php 中启用钩子：$config['enable_hooks'] = TRUE;
• 创建 application/hooks/RaygunHook.php，在 post_system 钩子中注册全局异常处理器：set_exception_handler() 和 set_error_handler()
• 在 handler 内实例化 RaygunClient（需先 require_once SDK 文件或通过 Composer 加载）
• 注意：不要在 show_error() 或 show_404() 中手动调用 Raygun——这些函数只用于渲染页面，不捕获未处理异常

CI4 接入 Raygun 必须重写 Exceptions 类

CI4 的异常流程完全由 Config\Exceptions 和 CodeIgniter\Exceptions\ExceptionHandler 控制，无法靠钩子干预。正确做法是：

• 复制 vendor/codeigniter4/framework/system/Exceptions/ExceptionHandler.php 到 app/Exceptions/ExceptionHandler.php
• 重写 handleException() 和 handleError() 方法，在调用父逻辑前，用 new \Raygun\RaygunClient('YOUR_API_KEY') 发送数据
• 确保 app/Config/Exceptions.php 中的 $handles 数组包含你自定义的类路径
• 避免在 CLI 模式下重复上报：检查 is_cli() 并跳过 RaygunClient->Send()

Raygun 上报内容容易漏掉关键上下文

默认只发异常消息和堆栈，但 CI 应用真正需要的是请求上下文（如当前 URI、POST 数据、Session ID）。Raygun SDK 支持 withCustomData()，但必须手动注入：

• CI3：从 get_instance() 获取 $this->input、$this->session 等对象拼装数组
• CI4：用 service('request')、service('session') 提取数据，注意过滤敏感字段（如密码、token）
• 不要传整个 $_SERVER——Raygun 有 payload 大小限制（默认 128KB），超限会静默丢弃

最常被忽略的一点：Raygun 的 Send() 是同步阻塞调用，若网络延迟高或服务不可用，会拖慢整个错误响应。生产环境务必加 try/catch 包裹，并设超时（SDK 不自带，需自己用 stream_context_set_option() 控制 HTTP 请求）。