yii restful接口可开箱即用，关键在于正确配置urlmanager的yii\rest\urlrule规则并让控制器继承yii\rest\activecontroller且设置$modelclass；pluralize默认true生成复数路径（如/users），符合主流rest风格。
Yii 框架里 RESTful 接口能不能“开箱即用”，取决于你有没有踩对两个关键点：路由规则配置是否匹配 yii\rest\UrlRule 的预期，以及控制器是否真正继承自 yii\rest\ActiveController 并正确绑定 $modelClass。其他所谓“手动实现 REST”或“改写所有 action”的做法，反而绕开了 Yii 自身最省力的机制。
urlManager 中 yii\rest\UrlRule 的 pluralize 参数怎么设
默认情况下，Yii 会把资源名转成复数形式（如 /products），这是由 pluralize => true 控制的。这个开关直接影响 URL 路径是否符合主流 REST 风格，也决定客户端能否按惯例猜出接口结构。
- 设为
true（默认）：生成/users、/orders等路径，符合 RFC 和多数前端 SDK（如 Axios REST client）的默认行为 - 设为
false：变成/user、/order，虽语法合法，但容易和单例资源（如/me）混淆，且部分 OpenAPI 工具不识别单数资源路径 - 若已上线且用单数路径，不要中途改
pluralize—— 这会直接破坏所有客户端调用，必须同步发新版本并灰度迁移
控制器继承 yii\rest\ActiveController 后必须重写哪些方法
继承本身只提供基础 CRUD，但真实业务几乎总会遇到这几个典型缺口：
-
actions()必须显式调用parent::actions()，否则index、view等内置 action 不生效 - 需要权限控制时，在
behaviors()里加authenticator，比如用CompositeAuth支持 Bearer Token + Query Param 双模式 - 要禁用某个 HTTP 方法（如禁止直接删商品），在
actions()返回数组中 unset 对应项：unset($actions['delete']) - 想让
POST /products返回完整对象（含 ID、时间戳等），而不是仅 201 + 空 body，需重写afterCreate()并设置$response->data
为什么 GET /products?status=active 不能靠默认行为支持
yii\rest\ActiveController 默认只支持分页（page、per-page）、排序（sort）和字段筛选（expand、fields），所有其他查询参数（如 status、category_id）都会被忽略 —— 这不是 bug，是设计使然：它假设模型层自己处理过滤逻辑。
- 正确做法是在控制器中重写
findModel()或search()方法，从\Yii::$app->request->get()拿参数，再传给ProductSearch::search()类 - 切忌在
actionIndex()里手动拼 SQL 或where()—— 这会让分页、排序等默认功能失效 - 如果多个控制器都要支持相同过滤字段（如
created_at_range），建议抽成一个 trait，避免重复写andFilterWhere()
版本号该放 URL 还是 Header
Yii 官方文档没强制，但实践中 URL 前缀（如 /v1/products）更稳妥：
- Web 服务器（Nginx/Apache）能直接按前缀分流到不同部署目录或后端集群，无需 PHP 解析请求头
- 调试时 curl 直接可见，日志里也清晰，不像
Accept: application/vnd.myapi.v1+json那样容易漏看 - 如果坚持用 Header，必须在
UrlRule的patterns里加'OPTIONS *' => 'options'，否则预检请求（CORS）会 404
复杂点在于，一旦选了 URL 版本，后续每个新模块（如 coupon、refund）都得对齐 /v1/xxx 路径，且 urlManager 规则要按版本分组，漏配一条就导致 404 —— 这个细节，上线前最容易被跳过。
