Yii 2.0 中控制器 action 方法必须以小写 action 开头、public 且无参数;方法名驼峰转 kebab-case 生成 URL,如 actionUserList → /site/user-list;非 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 或直接跳过调用。
性能影响:框架在匹配路由时会反射检查方法签名,带参数的方法被直接排除,不进后续流程 —— 所以不是“报错”,而是“静默失效”。
- ✅ 正确:
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前缀)









