讲师中心 微信公众号
AI工具推荐 视频效率加速

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

阿墨君_1079

阿墨君_1079

发布时间:2026-03-13 12:29:41

|

407人浏览过

|

来源于php中文网

原创

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。

Yii Framework 2.0.51
Yii Framework 2.0.51

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

下载
  • 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 或直接跳过调用。

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

  • ✅ 正确: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 的识别只依赖命名+可见性,不看注释、不读文档、不协商。写错一个字母,就等于没写。

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

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

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

3168

2023.10.19

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

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

5029

2025.10.17

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

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

3809

2025.12.29

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

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

466

2026.01.19

function是什么
function是什么

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

3240

2023.08.04

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

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

554

2023.10.07

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

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

3070

2025.09.04

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

40

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共22课时 | 9.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn