Yii框架控制器开发教程

本文深入解析了Yii 1.x框架中控制器编写的核心规范与实战要点，涵盖继承CController、action方法命名与访问限制、文件路径与大小写敏感规则、安全获取参数（getParam）、灵活跳转（redirect）和视图渲染（render）等关键环节，并直击开发者常遇的404错误与空白页痛点，一针见血指出缺失action前缀、调试未开启、文件权限异常等高频陷阱及高效排查技巧，是Yii 1.x项目开发与维护不可或缺的实用指南。

Yii 1.x 的控制器必须继承 CController，且动作方法名必须以 action 开头，否则路由找不到、404 直接报给你看。

控制器文件位置和命名规则

控制器类文件必须放在 protected/controllers/ 目录下，文件名与类名严格对应，且首字母大写、后缀为 Controller：

• PostController.php → 类名必须是 PostController
• UserAdminController.php → 类名必须是 UserAdminController
• 不能叫 postController.php 或 Postcontroller.php，大小写错一个就加载失败
• 类定义前无需 namespace（Yii 1.x 不用命名空间）

action 方法的写法和访问限制

所有可被 URL 路由调用的方法，必须是 public、以 action 开头、驼峰命名，并且不能带参数：

• ✅ 正确：public function actionView()、public function actionCreatePost()
• ❌ 错误：public function view()（没 action 前缀）、private function actionIndex()（非 public）、public function actionEdit($id)（带参数，Yii 1.x 不允许）
• 参数必须通过 $_GET 或 $this->createUrl() 生成的 URL 传入，再用 $this->getParam('id') 取
• 若想禁止外部访问某个方法，改用 protected function doSomething()，不加 action 前缀即可

控制器里怎么取 GET/POST 参数和跳转

别直接碰 $_GET 或 $_POST —— Yii 提供了更安全、可过滤的封装：

• 取参数：$this->getParam('name')（等价于 isset($_GET['name']) ? $_GET['name'] : null），支持默认值：$this->getParam('page', 1)
• 验证并取整数：$id = (int)$this->getParam('id');，但更推荐用 CVarDumper::dump() 先看结构再处理
• 跳转到其他动作：$this->redirect(array('post/view', 'id'=>123))，注意数组第一个元素是路由字符串，不是方法名
• 渲染视图：$this->render('view', array('model'=>$model))，视图文件路径自动映射到 protected/views/post/view.php

常见 404 和空白页原因

控制器写完跑不起来？大概率卡在这几个点上：

• URL 是 /index.php?r=post/index，但控制器叫 PostController，方法叫 actionIndex —— 少了 action 前缀就 404
• 入口文件没开调试模式：defined('YII_DEBUG') or define('YII_DEBUG', true); 注释掉了，错误全被吃掉，页面就空白
• protected/controllers/ 下控制器文件权限不对，或 PHP 无法读取（尤其部署到 Linux 时）
• 控制器里抛了异常但没配置 errorHandler 组件，导致白屏无提示

最省事的排查方式：在控制器构造函数里加 die('here');，能输出说明类加载成功，问题出在动作方法或路由上。

今天关于《Yii框架控制器开发教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于Yii的内容请关注golang学习网公众号！