Yii控制器动作怎么定义_2.0版本action方法命名规则与示例【详解】

阿墨君_1079

阿墨君_1079

2026-03-13

427人浏览

原创

Yii 2.0 中控制器 action 方法必须以小写 action 开头、public 且无参数;方法名驼峰转 kebab-case 生成 URL,如 actionUserList → /site/user-list;非 action 前缀或含参数的方法均不可路由。

yii控制器动作怎么定义_2.0版本action方法命名规则与示例【详解】

Yii 2.0 中控制器 action 方法必须以 action 开头

Yii 2.0 不再接受任意命名的公共方法作为可路由动作,必须显式以 action 为前缀,且首字母小写。这是框架自动识别和绑定 URL 路由的硬性约定。

常见错误现象:Invalid Route 或 404,但控制器里明明写了 public function getUserList() —— 框架根本不会把它当 action 看。

  • actionIndex() → 对应 /site/index(合法)
  • actionUserList() → 对应 /site/user-list(合法,自动转连字符)
  • getUserList()、indexAction()、ActionIndex() → 全部无效(不可访问)

action 方法名转 URL 的连字符规则(不是驼峰直译)

Yii 2.0 把 action 后的驼峰名自动转换为 kebab-case(小写+连字符),用于生成 URL 路径。这不是可选行为,是内置解析逻辑,改不了。

使用场景:比如你想通过 /post/create-comment 访问方法,就必须定义 actionCreateComment(),而不是 actionCreate_comment 或 actionCreatecomment。

  • actionViewDetail() → /controller/view-detail
  • actionAPIv2Data() → /controller/a-p-i-v2-data(不推荐,语义混乱)
  • 想用下划线?不行 —— action_user_list() 会被忽略,PHP 方法名也不允许中划线,下划线本身不触发转换

public 且无参数是 action 方法的最低要求

Yii 2.0 的 action 方法必须是 public,且不能声明任何参数(包括默认值)。参数只能通过 Yii::$app->request 显式获取,否则会报 ReflectionException: Function does not exist 或直接跳过调用。

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载

性能影响:框架在匹配路由时会反射检查方法签名,带参数的方法被直接排除,不进后续流程 —— 所以不是“报错”,而是“静默失效”。

  • ✅ 正确:public function actionUpdate() { $id = \Yii::$app->request->get('id'); }
  • ❌ 错误:public function actionUpdate($id) { ... }(运行时报错或 404)
  • ❌ 错误:public function actionSearch($q = '') { ... }(即使有默认值也不行)

private/protected 方法不会被路由,但可在 action 内部调用

有人试图把重复逻辑抽成 protected function buildQuery(),然后在多个 action 里复用 —— 这完全没问题,而且推荐。只要它不叫 actionXXX,就不会被暴露为路由入口。

容易踩的坑:把本该是私有工具方法的命名写成 actionHelper(),结果意外开放了一个空逻辑的 URL 接口,还可能被扫描到。

  • ✅ 安全复用:protected function normalizeInput($raw) { ... }
  • ⚠️ 隐患命名:protected function actionNormalize() { ... }(虽然 protected,但名字触发框架误判风险,建议彻底避开 action 前缀)

框架对 action 的识别只依赖命名+可见性,不看注释、不读文档、不协商。写错一个字母,就等于没写。

相关文章

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

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

下载

相关标签:

yii

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

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3208

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5229

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3869

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

486

15

function是什么
function是什么

function是函数的意思,是一段具有特定功能的可重复使用的代码块,是程序的基本组成单元之一,可以接受输入参数,执行特定的操作,并返回结果。本专题为大家提供function是什么的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.04

3460

5

js函数function用法
js函数function用法

js函数function用法有:1、声明函数;2、调用函数;3、函数参数;4、函数返回值;5、匿名函数;6、函数作为参数;7、函数作用域;8、递归函数。本专题提供js函数function用法的相关文章内容,大家可以免费阅读。

2023.10.07

574

5

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

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

2025.09.04

3150

22

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共22课时 | 9.3万人学习