Yii2通过ErrorHandler组件统一处理错误与异常，配置errorAction指向site/error动作以显示友好页面，结合YII_DEBUG与YII_ENV区分环境，生产环境关闭调试信息并记录日志，可自定义ErrorHandler类处理特定异常，提升安全性与可维护性。
Yii2 的错误与异常处理机制非常完善，通过内置的 ErrorHandler 组件统一管理 PHP 错误、异常以及 HTTP 状态码响应。合理配置错误处理不仅能提升开发效率，还能增强线上环境的安全性与用户体验。
启用和配置 ErrorHandler 组件
在 Yii2 应用中，ErrorHandler 是核心组件之一，默认已注册。你可以在应用配置文件（如 web.php 或 main.php）中进行自定义配置：
'components' => [ 'errorHandler' => [ 'errorAction' => 'site/error', // 指定错误页面对应的控制器动作 'maxSourceLines' => 20, // 显示代码上下文的最大行数 'maxTraceString' => 1024, // 调用栈信息最大长度 ],],
其中 errorAction 是关键配置项，表示当发生未捕获异常或 PHP 错误时，跳转到指定控制器的动作来显示友好错误页。
定义错误显示页面
通常将错误页面交给 SiteController 的 error 动作处理。确保该动作存在并正确渲染视图：
public function actions(){ return [ 'error' => [ 'class' => 'yiiwebErrorAction', ], ];}
然后创建对应视图文件 views/site/error.php，根据环境判断是否显示详细错误信息：
errorHandler->exception) : ?>发生错误
getMessage()) ?>
区分开发与生产环境的错误显示
为避免泄露敏感信息，应关闭生产环境的错误详情输出。可通过设置 YII_DEBUG 和 YII_ENV 控制行为：
defined('YII_DEBUG') or define('YII_DEBUG', false);defined('YII_ENV') or define('YII_ENV', 'prod');
在生产环境中建议：
关闭 YII_DEBUG 不显示错误堆栈和文件路径 记录日志而非直接输出
自定义异常处理逻辑
若需对特定异常类型做特殊处理，可继承 ErrorHandler 并重写 handleException 方法：
class CustomErrorHandler extends yiibaseErrorHandler{ public function handleException($exception) { if ($exception instanceof CustomException) { Yii::warning('捕获自定义异常：' . $exception->getMessage()); // 可跳转到特定页面或返回 JSON 响应 } parent::handleException($exception); }}
然后在配置中替换默认处理器：
'components' => [ 'errorHandler' => [ 'class' => 'appcomponentsCustomErrorHandler', 'errorAction' => 'site/error', ],],
基本上就这些。合理利用 Yii2 的错误处理机制，既能保障调试效率，也能确保线上服务稳定安全。关键是根据环境调整输出策略，并善用日志记录问题。不复杂但容易忽略细节。
以上就是Yii2错误处理怎么配置_Yii2框架错误与异常处理机制的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/731687.html
微信扫一扫 
支付宝扫一扫 
