在 actions() 返回数组中添加自定义动作需以小写键名配 ['class' => 'app\controllers\MyCustomAction'] 格式，且自定义类必须继承 yii\rest\Action 并重写 run()；同时需在 behaviors() 中配置 VerbFilter，并确保控制器继承 yii\rest\Controller、开启美化 URL、类路径与命名空间一致。
Yii2 REST Controller 里 actions() 返回的数组怎么加自定义动作
直接在 actions() 方法返回的数组里加键值对就行，键是动作名（URL 路径段），值是动作配置。但注意：这个配置不是直接写类名或闭包，而是得用 Yii2 REST 动作工厂能识别的格式。
- 最常用的是
['class' => 'yii\rest\CreateAction']这种标准写法，但自定义动作必须指向你自己的 Action 类，比如['class' => 'app\controllers\MyCustomAction'] - 如果想用匿名函数（不推荐），得包装成
['class' => 'yii\base\InlineAction', 'actionMethod' => 'myCustomMethod']，然后在 Controller 里定义public function myCustomMethod($id = null) { ... } - 别漏掉
'class'键——只写字符串（如'app\controllers\MyCustomAction'）会被当成 action ID 处理，报Unknown property: yii\rest\Controller::myCustomAction
为什么继承 yii\rest\Action 比写 InlineAction 更可靠
REST Controller 默认用 yii\rest\Action 做基类，它自动处理了内容协商、HTTP 状态码、序列化、beforeAction/afterAction 钩子等。InlineAction 不具备这些能力，容易导致返回 JSON 失败、状态码始终是 200、OPTIONS 请求没响应等问题。
- 自定义 Action 类必须继承
yii\rest\Action，不能只继承yii\base\Action - 记得重写
run()方法，而不是runWithParams()—— 后者是老版本兼容接口，REST 组件不调用它 - 如果要支持 PUT/PATCH，别忘了在
behaviors()里显式声明'verbFilter' => ['class' => 'yii\filters\VerbFilter', 'actions' => ['my-custom' => ['put', 'patch']]]
my-custom 这种动作名在 URL 中怎么访问，和标准 CRUD 动作冲突吗
不会冲突。Yii2 REST 路由默认只把 index、view、create、update、delete 映射到对应 HTTP 方法；其他动作名一律走 GET /users/my-custom 或 POST /users/my-custom 这种形式，完全由你控制动词绑定。
- URL 路径就是
http://api.example.com/users/my-custom（假设控制器是UsersController） - 如果希望支持
/users/123/my-custom，动作类里要手动从$this->request->get('id')或$this->request->getBodyParam('id')取参数，REST 基类不自动注入 - 别在
actions()里把my-custom写成myCustom——键名必须全小写，否则路由匹配失败，返回 404
调试时发现动作根本没执行？先查这三个地方
常见“写了动作但请求 404 或进错方法”的原因，基本就卡在这三处。
- 控制器类没正确继承
yii\rest\Controller（比如误继承了yii\web\Controller），会导致整个actions()机制失效 -
urlManager配置里没启用'enablePrettyUrl' => true和'showScriptName' => false，导致路由解析不到自定义动作段 - 动作类文件没被自动加载——检查命名空间是否和
app/controllers/目录结构一致，比如app\controllers\MyCustomAction必须放在@app/controllers/MyCustomAction.php
自定义动作真正麻烦的不是写法，而是它游离在标准 REST 生命周期之外：序列化规则、数据验证、事务边界、缓存头，都得自己补全。很多人加完动作发现返回数据没转 JSON、没带 Content-Type: application/json，其实就是忘了在 run() 里调 $this->controller->serializeData() 或手动设置响应格式。
