0

0

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

看不見的法師

看不見的法師

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

|

387人浏览过

|

来源于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_commentactionCreatecomment

  • 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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

1951

2023.10.19

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

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

658

2025.10.17

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

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

2401

2025.12.29

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

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

47

2026.01.19

function是什么
function是什么

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

499

2023.08.04

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

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

166

2023.10.07

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

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

89

2025.09.04

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

25

2026.03.13

Python异步编程与Asyncio高并发应用实践
Python异步编程与Asyncio高并发应用实践

本专题围绕 Python 异步编程模型展开,深入讲解 Asyncio 框架的核心原理与应用实践。内容包括事件循环机制、协程任务调度、异步 IO 处理以及并发任务管理策略。通过构建高并发网络请求与异步数据处理案例,帮助开发者掌握 Python 在高并发场景中的高效开发方法,并提升系统资源利用率与整体运行性能。

44

2026.03.12

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号