Yii1.1 Yii2 Yii3错误处理页面怎么自定义

絕刀狂花

絕刀狂花

2026-07-31

536人浏览

原创

yii各版本错误处理机制不同:yii1.1用cerrorhandler+erroraction配置;yii2基于errorhandler组件分发视图,需确保url重写正确;yii3改用psr-15中间件和自定义exceptionhandlerinterface实现灵活控制。

yii1.1 yii2 yii3错误处理页面怎么自定义

Yii 不同版本的错误处理机制差异较大,自定义错误页面的方式也各不相同。下面按版本分别说明核心要点和实操路径,避免混淆、直击关键配置。

Yii1.1:靠 CErrorHandler + errorAction 配置

Yii1.1 使用 CErrorHandler 统一接管异常和 PHP 错误,自定义页面依赖控制器动作和视图配合。

  • protected/config/main.phpcomponents 中配置:
    'errorHandler'=>array( 'errorAction'=>'site/error' ),
  • SiteController::actionError() 必须存在,且需手动获取错误信息:
    $error = Yii::app()->errorHandler->error;
    然后 $this->render('error', $error);
  • 视图文件固定为 protected/views/site/error.php,可直接使用 $error['code']$error['message'] 等字段
  • 注意:开发环境(YII_DEBUG=true)会强制显示调试堆栈,不走自定义页;生产环境才生效

Yii2:基于 errorHandler 组件 + errorAction + 视图分发

Yii2 将错误处理模块化,更灵活,但需明确区分 Web 请求与 API 请求,且 Web 服务器(Nginx/Apache)不能提前拦截 404。

Yii Framework 2.0.51
Yii Framework 2.0.51

下载 Yii Framework 2.0.51 官方 Basic 应用模板,查看 Composer 安装方式、版本信息与开发文档。

下载
  • 基础配置在 config/web.php
    'errorHandler' => ['errorAction' => 'site/error'],
  • SiteController::actionError() 推荐用 ErrorAction 类(简洁)或手动逻辑:
    $exception = Yii::$app->errorHandler->exception;
    再根据类型分发视图,例如:
    if ($exception instanceof \yii\web\NotFoundHttpException) { return $this->render('error-404'); }
  • 视图路径为 @app/views/site/error.php(默认),若用 errors/error,则视图必须是 @app/views/errors/error.php
  • 关键前提:确保 URL 重写规则正确(如 Nginx 的 try_files $uri $uri/ /index.php?$args;),并启用 enablePrettyUrl,否则 404 被 Web 服务器吃掉,Yii 根本收不到请求

Yii3:全新架构,取消全局 errorHandler,改用中间件 + 异常处理器

Yii3 彻底重构了错误处理流程,不再依赖组件配置,而是通过 PSR-15 中间件链和可插拔的异常处理器(ExceptionHandlerInterface)实现。

  • 自定义错误页需实现 yii\web\exception\ExceptionHandlerInterface,例如:
    class CustomExceptionHandler implements ExceptionHandlerInterface { public function render(\Throwable $throwable): ResponseInterface { ... } }
  • 在应用启动时注册(如 config/web.php 或 bootstrapping 阶段):
    'exceptionHandler' => CustomExceptionHandler::class,
  • 视图渲染由你完全控制,推荐返回 HtmlResponseJsonResponse,无固定路径约束;可自由组织模板位置(如 resources/views/errors/404.php
  • 404 处理更自然:路由未匹配时自动抛 yii\web\exceptions\NotFoundException,交由你的处理器统一响应,无需担心 Web 服务器兜底干扰
不复杂但容易忽略

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

yii yii框架

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

642

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

1221

5

PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

2025.09.04

869

22

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

8

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

5

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

7

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

4

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

3

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.1万人学习