YII2 - Yii 2 控制器不能包含大写字母的Bug

发布时间：2020-08-19 08:04:02 作者：tywali
来源：网络阅读：1544

在Yii1里，URL路由参数中的控制器名称是可以有大写字母的（首字母除外），但是到了Yii2的时候（我的版本是2.0.8，其它版本未确认），却是不支持控制器名称中包含大写字母了，我查了下官方文档，其对于控制器命名的规则如下：

控制器ID遵循以下规则衍生控制器类名：

将用正斜杠区分的每个单词第一个字母转为大写。注意如果控制器ID包含正斜杠，只将最后的正斜杠后的部分第一个字母转为大写；
去掉中横杠，将正斜杠替换为反斜杠;
增加Controller后缀;
在前面增加yii\base\Application::controllerNamespace控制器命名空间.

下面为一些示例，假设yii\base\Application::controllerNamespace控制器命名空间为 app\controllers:

article 对应 app\controllers\ArticleController;
post-comment 对应 app\controllers\PostCommentController;
admin/post-comment 对应 app\controllers\admin\PostCommentController;
adminPanels/post-comment 对应 app\controllers\adminPanels\PostCommentController.

首先，它没有说控制器是否可以用大写字母，其次，从它的命名规则中推测，Yii2的作者也许是想用“-”来区分不同的单词，这样方便输入URL（不用按Shift+字母输入大写字母了）。

想要把Yii 2改为支持控制器名称包含大写字母也很容易，找到module.php，在createControllerByID()函数里，

public function createControllerByID($id)
{
    $pos = strrpos($id, '/');
    if ($pos === false) {
        $prefix = '';
        $className = $id;
    } else {
        $prefix = substr($id, 0, $pos + 1);
        $className = substr($id, $pos + 1);
    }

    // 这是修改前的代码
    /*if (!preg_match('%^[a-z][a-z0-9\\-_]*$%', $className)) {
        return null;
    }*/
    // 这是修改后的代码
    if (!preg_match('%^[a-z][\w0-9\\-_]*$%', $className)) {
        return null;
    }

修改前的代码：

preg_match('%^[a-z][a-z0-9\\-_]*$%', $className)

其含义是查找以小写字母开头，由小写字母、数字和“-”符号组成的控制器名称。

修改后的代码：

preg_match('%^[a-z][\w0-9\\-_]*$%', $className)

其含义是查找以小写字母开头，由任意字母、数字和“-”符号组成的控制器名称。

YII2 - Yii 2 控制器不能包含大写字母的Bug

相关阅读