直接使用./yii controller/create命令创建控制器骨架，需在项目根目录执行，控制器名用驼峰式（如user-profile生成userprofilecontroller），restful接口应继承yii\rest\activecontroller并设置$modelclass指向继承activerecord的模型类，否则报错。
直接用 ./yii controller/create 命令，别碰 gii/controller —— 它根本不存在，敲了就报 Unknown command "gii/controller"。
命令行创建控制器只能用 controller/create
这是 Yii2 内置的 console 命令，不依赖 Gii，也不需要启动 Web 服务。它只生成空骨架：controllers/UserProfileController.php，不带任何 action、不建视图、不配路由。
- 控制器名必须驼峰，比如
user-profile→ 生成UserProfileController；写成user_profile或user/profile会导致类名错乱 - 执行位置必须是项目根目录（有
yii文件的地方），不是console/子目录里 - 加
--namespace=app\controllers\v2会写命名空间，但controllers/v2/目录得你手动创建，命令不会自动建 - Linux 下生成后检查权限：有时新文件因
umask缺少读权限，Web 服务一访问就 500
RESTful 控制器优先继承 yii\rest\ActiveController
如果你做 API，别从 yii\web\Controller 继承。用 ActiveController 可以直接暴露标准 CRUD 接口，只要配一个 $modelClass：
class UserController extends \yii\rest\ActiveController
{
public $modelClass = 'app\models\User';
}
它自动支持 GET /users、POST /users、GET /users/1 等，底层靠过滤器（VerbFilter、ContentNegotiator）驱动。
- 不设
$modelClass会直接报错：找不到模型类 - 模型类必须继承
yii\db\ActiveRecord，否则ActiveController的内置操作无法工作 - 如果只是简单返回数据（比如查缓存、调外部接口），用
yii\rest\Controller更轻量，自己写action方法就行
自定义控制器路径要用 controllerMap
想把控制器放非标准位置（比如 api/v1/PostController.php），不能靠改命名空间或目录结构硬塞，得在 config/web.php 或 config/console.php 里配 controllerMap：
'controllerMap' => [
'v1-post' => [
'class' => 'api\v1\PostController',
],
],
之后就能用 r=v1-post/index 访问，和默认路径完全解耦。
-
controllerMap是“路由 ID → 类名”的映射，不是目录映射，别指望它自动扫描子目录 - 映射后的控制器仍需满足 Yii 的类加载规则（PSR-4 或自动注册），否则
Class not found - 后台管理类常用这个方式隔离逻辑，比如把所有 CMS 操作映射到
admin/*路由下
最常被忽略的一点：生成的控制器文件本身不触发任何行为，action 方法得手动写、路由得手动配、权限得手动加——controller/create 只负责“起个头”，后面全是实打实的手工活。
