在 Yii2 中，支持生成基于别名的链接，别名只能包含小写字母、数字、中划线、@ 和下划线。

永夜 — Mon, 21 Jul 2025 01:39:51 +0000

浏览量： 90

1、表结构设计为允许别名为 null，且默认为 null，添加唯一索引。


-- `official-website-management-system`.articles definition

CREATE TABLE `articles` (
  `id` varchar(20) COLLATE utf8mb4_unicode_ci NOT NULL,
  `alias` varchar(200) COLLATE utf8mb4_unicode_ci DEFAULT NULL,
  `created_at` datetime DEFAULT NULL,
  `updated_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx-alias` (`alias`),
  KEY `idx-category_id` (`category_id`),
  KEY `idx-status` (`status`),
  KEY `idx-updated_at` (`updated_at`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

2、在后台表单提交编辑时，自动将空字符串转换为 null。在模型的 rules 中设置转换规则与验证


    /**
     * {@inheritdoc}
     */
    public function rules()
    {
        return [
            ['alias', 'filter', 'filter' => function ($value) {
                return $value === '' ? null : $value;
            }],
            ['alias', 'match', 'pattern' => '/^[a-z0-9\-@_]+$/', 'message' => '别名只能包含小写字母、数字、中划线、@ 和下划线。'],
        ];
    }

3、在前端的视图文件中，生成链接的实现如下

frontend/views/article/index.php

frontend/helpers/ArticleUrlHelper.php



    public static function detailUrl($article): string
    {
        if (!empty($article['alias']) && UrlHelper::isValidAlias($article['alias'])) {
            return Url::to(['article/view', 'alias' => $article['alias']]);
        }
        return Url::to(['article/view', 'id' => $article['id']]);
    }

frontend/helpers/UrlHelper.php


    public static function isValidAlias(string $alias): bool
    {
        return preg_match('/^[a-z0-9\-@_]+$/', $alias) === 1;
    }

4、在 frontend/config/main.php 中配置 urlManager 如下



        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'enableStrictParsing' => true,
            'normalizer' => [
                'class' => yii\web\UrlNormalizer::class,
                'collapseSlashes' => true,
                'normalizeTrailingSlash' => true,
            ],
            'rules' => [
                '' => 'page/index',
                // 资讯详情
                'industry/detail-.html' => 'article/view',
                'industry/.html' => 'article/view',
            ],
        ],

5、当别名为：@dd87-_s 时，生成的链接为：/industry/%40dd87-_s.html 。如图1

图1

6、原因是，Url::to() 自动对参数进行了 URL 编码， alias 是 @dd87-_s，其中 @ 是特殊字符，会被编码为 %40。决定暂不做处理。

中划线 – 永夜

在 Yii2 中，支持生成基于别名的链接，别名只能包含小写字母、数字、中划线、@ 和下划线。