Yii2通过ErrorHandler组件统一处理错误与异常，配置errorAction指向site/error动作以显示友好页面，结合YII_DEBUG与YII_ENV区分环境，生产环境关闭调试信息并记录日志，可自定义ErrorHandler类处理特定异常，提升安全性与可维护性。
Yii2 的错误与异常处理机制非常完善，通过内置的 ErrorHandler 组件统一管理 PHP 错误、异常以及 HTTP 状态码响应。合理配置错误处理不仅能提升开发效率，还能增强线上环境的安全性与用户体验。
在 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' => 'yii\web\ErrorAction',
],
];
}
然后创建对应视图文件 views/site/error.php，根据环境判断是否显示详细错误信息：
<?php if (Yii::$app->errorHandler->exception) : ?>
<h1>发生错误</h1>
<p><?= htmlspecialchars($exception->getMessage()) ?></p>
<div class="aritcle_card">
<a class="aritcle_card_img" href="/ai/762">
<img src="https://img.php.cn/upload/ai_manual/000/000/000/175679962759206.png" alt="百宝箱">
</a>
<div class="aritcle_card_info">
<a href="/ai/762">百宝箱</a>
<p>百宝箱是支付宝推出的一站式AI原生应用开发平台，无需任何代码基础，只需三步即可完成AI应用的创建与发布。</p>
<div class="">
<img src="/static/images/card_xiazai.png" alt="百宝箱">
<span>911</span>
</div>
</div>
<a href="/ai/762" class="aritcle_card_btn">
<span>查看详情</span>
<img src="/static/images/cardxiayige-3.png" alt="百宝箱">
</a>
</div>
<?php endif; ?>
为避免泄露敏感信息，应关闭生产环境的错误详情输出。可通过设置 YII_DEBUG 和 YII_ENV 控制行为：
defined('YII_DEBUG') or define('YII_DEBUG', false);
defined('YII_ENV') or define('YII_ENV', 'prod');
在生产环境中建议：
若需对特定异常类型做特殊处理，可继承 ErrorHandler 并重写 handleException 方法：
class CustomErrorHandler extends \yii\base\ErrorHandler
{
public function handleException($exception)
{
if ($exception instanceof CustomException) {
Yii::warning('捕获自定义异常：' . $exception->getMessage());
// 可跳转到特定页面或返回 JSON 响应
}
parent::handleException($exception);
}
}
然后在配置中替换默认处理器：
'components' => [
'errorHandler' => [
'class' => 'app\components\CustomErrorHandler',
'errorAction' => 'site/error',
],
],
基本上就这些。合理利用 Yii2 的错误处理机制，既能保障调试效率，也能确保线上服务稳定安全。关键是根据环境调整输出策略，并善用日志记录问题。不复杂但容易忽略细节。
以上就是Yii2错误处理怎么配置_Yii2框架错误与异常处理机制的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
158
收藏
