ThinkPHP 5 到 ThinkPHP 8 路由迁移完整指南

小虎哥-技术博客2026-01-01 19:07

ThinkPHP 5 到 ThinkPHP 8 路由迁移完整指南

本文档详细说明如何在 ThinkPHP 8.1.3 中实现 ThinkPHP 5.0.24（易优CMS）的路由效果

目录

  1. 路由系统对比分析
  2. 易优CMS路由特点
  3. [ThinkPHP 8路由机制](#ThinkPHP 8路由机制)
  4. 完整实现方案
  5. 关键差异对照表
  6. URL生成对比
  7. 最佳实践建议
  8. 迁移检查清单

路由系统对比分析

ThinkPHP 5.0.24（易优CMS）

路由文件位置 ：application/route.php

核心特点：

  • 单文件配置，所有路由规则在一个文件中
  • 支持动态路由生成（从数据库读取配置）
  • 使用数组方式定义路由规则
  • 支持复杂的伪静态规则

路由定义示例：

php 复制代码 
<?php
use think\Route;

$route = [
    '__pattern__' => [
        'tid' => '[\-\w]+',
        'dirname' => '[\-\w]+',
        'aid' => '(.*)',
    ],
];

// 列表页路由
$route['<tid>$'] = [
    'home/Lists/index',
    ['method' => 'get', 'ext' => ''],
    ['tid' => '[\-\w]+'],
];

// 内容页路由
$route['<dirname>/<aid>$'] = [
    'home/View/index',
    ['method' => 'get', 'ext' => 'html'],
    ['dirname' => '[\-\w]+', 'aid' => '(.*)'],
];

return $route;

ThinkPHP 8.1.3

路由文件位置：

  • 配置：config/route.php
  • 定义：route/app.php

核心特点：

  • 配置与定义分离
  • 使用 Facade 模式
  • 支持链式调用
  • 更强的类型约束

路由定义示例：

php 复制代码 
<?php
declare(strict_types=1);

use think\facade\Route;

// 列表页路由
Route::get('<tid>$', 'index/Lists/index')
    ->ext('')
    ->pattern(['tid' => '[\-\w]+'])
    ->name('lists');

// 内容页路由
Route::get('<dirname>/<aid>$', 'index/View/index')
    ->ext('html')
    ->pattern([
        'dirname' => '[\-\w]+',
        'aid' => '(.*)'
    ])
    ->name('view');

易优CMS路由特点

通过分析易优CMS的 application/route.php 文件，发现其路由系统具有以下特点：

1. 动态配置驱动

php 复制代码 
// 从缓存读取全局配置
$globalTpCache = tpCache('global');

// 根据配置动态设置路由行为
$seo_pseudo = !empty($globalTpCache['seo_pseudo'])
    ? intval($globalTpCache['seo_pseudo'])
    : config('ey_config.seo_pseudo');

2. 三种URL模式

模式 值 说明 示例
动态模式 1 兼容模式，使用 ?s= 参数 index.php?s=/article/view/id/123
静态模式 2 纯静态HTML文件 /article/news/123.html
伪静态模式 3 SEO友好的伪静态URL /article/news/123.html

3. 多语言/多站点支持

多语言路由：

php 复制代码 
// 中文：/cn/article/news/123.html
// 英文：/en/article/news/123.html
$lang_rewrite_str = '<lang>/';

多城市路由：

php 复制代码 
// 北京站：/beijing/article/news/123.html
// 上海站：/shanghai/article/news/123.html
$site_rewrite_str = '<site>/';

4. 内容模型路由

易优CMS为不同内容类型定义了专门的路由规则：

精简格式（seo_rewrite_format = 1）
php 复制代码 
// 列表页
'<tid>$' => 'home/Lists/index'
'<tid>/list_<typeid>_<page>$' => 'home/Lists/index'

// 内容页
'<dirname>/<aid>$' => 'home/View/index'

URL示例：

  • 列表页：/news 或 /news/list_1_2
  • 内容页：/news/article-123.html
完整格式（seo_rewrite_format = 2）
php 复制代码 
// 文章模型
'article/<tid>$' => 'home/Article/lists'
'article/<dirname>/<aid>$' => 'home/Article/view'

// 产品模型
'product/<tid>$' => 'home/Product/lists'
'product/<dirname>/<aid>$' => 'home/Product/view'

// 图集模型
'images/<tid>$' => 'home/Images/lists'
'images/<dirname>/<aid>$' => 'home/Images/view'

// 下载模型
'download/<tid>$' => 'home/Download/lists'
'download/<dirname>/<aid>$' => 'home/Download/view'

// 视频模型
'media/<tid>$' => 'home/Media/lists'
'media/<dirname>/<aid>$' => 'home/Media/view'

// 专题模型
'special/<tid>$' => 'home/Special/lists'
'special/<dirname>/<aid>$' => 'home/Special/view'

// 单页模型
'single/<tid>$' => 'home/Single/lists'

URL示例：

  • 文章列表：/article/news.html
  • 文章内容：/article/news/article-123.html
  • 产品列表：/product/electronics.html
  • 产品详情：/product/electronics/product-456.html

5. 自定义模型动态路由

php 复制代码 
// 从数据库读取自定义模型
$channeltype_row = \think\Db::name('channeltype')
    ->field('nid,ctl_name')
    ->where(['ifsystem' => 0])
    ->select();

// 动态生成路由
foreach ($channeltype_row as $value) {
    $home_rewrite += [
        $value['nid'].'/<tid>$' => [
            'home/'.$value['ctl_name'].'/lists',
            ['method' => 'get', 'ext' => 'html'],
        ],
        $value['nid'].'/<dirname>/<aid>$' => [
            'home/'.$value['ctl_name'].'/view',
            ['method' => 'get', 'ext' => 'html'],
        ],
    ];
}

6. 特殊功能路由

php 复制代码 
// 会员中心
'user$' => 'user/Users/login'
'reg$' => 'user/Users/reg'
'centre$' => 'user/Users/centre'
'cart$' => 'user/Shop/shop_cart_list'

// 搜索
'sindex$' => 'home/Search/index'
'search$' => 'home/Search/lists'

// 标签
'tags$' => 'home/Tags/index'
'tags/<tagid>$' => 'home/Tags/lists'
'tags/<tagid>_<page>$' => 'home/Tags/lists'

// 问答（如果安装了问答插件）
'ask$' => 'home/Ask/index'
'ask/view_<ask_id>$' => 'home/Ask/details'

7. 参数正则约束

php 复制代码 
'__pattern__' => [
    'tid' => '[\-\w]+',        // 栏目标识：字母、数字、下划线、横线
    'dirname' => '[\-\w]+',    // 目录名称
    'aid' => '(.*)',           // 文档ID：任意字符
    'typeid' => '[\d]+',       // 类型ID：纯数字
    'page' => '[\d]+',         // 页码：纯数字
    'tagid' => '[\d]+',        // 标签ID：纯数字
]

ThinkPHP 8路由机制

1. 配置与定义分离

配置文件 ：config/route.php

php 复制代码 
<?php
return [
    // pathinfo分隔符
    'pathinfo_depr' => '/',

    // 是否强制使用路由
    'url_route_must' => false,

    // URL伪静态后缀
    'url_html_suffix' => 'html',

    // 默认的路由变量规则
    'default_route_pattern' => '[\w\.]+',
];

路由定义 ：route/app.php

php 复制代码 
<?php
declare(strict_types=1);

use think\facade\Route;

Route::get('user/<id>', 'user/read');

2. Facade 模式

php 复制代码 
use think\facade\Route;

// 而不是 TP5 的
use think\Route;

3. 链式调用

php 复制代码 
Route::get('article/<id>', 'article/read')
    ->ext('html')                          // 设置URL后缀
    ->pattern(['id' => '\d+'])             // 参数约束
    ->name('article.read')                 // 路由命名
    ->middleware(['auth'])                 // 中间件
    ->cache(3600);                         // 路由缓存

4. 路由分组

php 复制代码 
Route::group('admin', function () {
    Route::get('user/index', 'admin.User/index');
    Route::get('user/add', 'admin.User/add');
    Route::post('user/save', 'admin.User/save');
})->middleware(['auth', 'admin']);

5. 资源路由

php 复制代码 
// 自动生成 RESTful 路由
Route::resource('article', 'Article');

// 等同于：
// GET    /article          -> index
// GET    /article/create   -> create
// POST   /article          -> save
// GET    /article/:id      -> read
// GET    /article/:id/edit -> edit
// PUT    /article/:id      -> update
// DELETE /article/:id      -> delete

6. 参数约束

php 复制代码 
// 方式1：在路由中直接约束
Route::get('user/<id:\d+>', 'user/read');

// 方式2：使用 pattern 方法
Route::get('user/<id>', 'user/read')
    ->pattern(['id' => '\d+']);

// 方式3：全局约束（在 config/route.php 中）
'default_route_pattern' => '\d+',

完整实现方案

方案选择

方案 适用场景 优点 缺点
方案1：静态路由 小型项目、路由规则固定 简单直观、性能好 不支持动态配置
方案2：动态路由 大型CMS、需要动态配置 灵活、完全模拟易优CMS 实现复杂

本文档推荐使用方案2：动态路由生成，完全模拟易优CMS的路由特性。

实现步骤

步骤 1：创建路由配置文件

创建 config/eyoucms.php：

php 复制代码 
<?php
declare(strict_types=1);

return [
    // URL模式：1=动态，2=静态，3=伪静态
    'seo_pseudo' => 3,

    // 伪静态格式：1=精简，2=完整，3=目录层级，4=父目录/当前目录
    'seo_rewrite_format' => 1,

    // 多语言数量
    'system_langnum' => 1,

    // 默认语言
    'system_home_default_lang' => 'cn',

    // 是否启用多城市
    'city_switch_on' => false,

    // URL后缀
    'url_html_suffix' => 'html',

    // 路由参数正则规则
    'route_pattern' => [
        'tid' => '[\-\w]+',
        'dirname' => '[\-\w]+',
        'aid' => '(.*)',
        'typeid' => '\d+',
        'page' => '\d+',
        'tagid' => '\d+',
        'ask_id' => '\d+',
        'type_id' => '\d+',
    ],

    // 内容模型列表
    'content_models' => [
        'article',   // 文章
        'product',   // 产品
        'images',    // 图集
        'download',  // 下载
        'media',     // 视频
        'special',   // 专题
    ],
];
步骤 2：创建路由服务类

创建 app/service/RouteService.php：

php 复制代码 
<?php
declare(strict_types=1);

namespace app\service;

use think\facade\Route;
use think\facade\Db;
use think\facade\Cache;

class RouteService
{
    /**
     * 注册易优CMS风格的路由
     */
    public static function register(): void
    {
        $config = config('eyoucms');
        $seo_pseudo = $config['seo_pseudo'] ?? 3;
        $seo_rewrite_format = $config['seo_rewrite_format'] ?? 1;
        $pattern = $config['route_pattern'] ?? [];

        // 根据URL模式注册不同的路由
        match ($seo_pseudo) {
            3 => self::registerRewriteRoutes($seo_rewrite_format, $pattern),
            2 => self::registerStaticRoutes($pattern),
            1 => self::registerDynamicRoutes(),
            default => null,
        };
    }

    /**
     * 注册伪静态路由（seo_pseudo = 3）
     */
    private static function registerRewriteRoutes(int $format, array $pattern): void
    {
        $langPrefix = self::getLangPrefix();

        if ($format === 1) {
            // 精简格式
            self::registerSimpleRewriteRoutes($langPrefix, $pattern);
        } else {
            // 完整格式
            self::registerFullRewriteRoutes($langPrefix, $pattern);
        }
    }

    /**
     * 注册精简伪静态路由
     */
    private static function registerSimpleRewriteRoutes(string $langPrefix, array $pattern): void
    {
        // 首页
        Route::get($langPrefix . '$', 'index/index')
            ->ext('')
            ->name('home');

        // 会员中心
        Route::group($langPrefix . 'user', function () {
            Route::get('$', 'user.Users/login')->name('user.login');
            Route::get('reg$', 'user.Users/reg')->name('user.reg');
            Route::get('centre$', 'user.Users/centre')->name('user.centre');
            Route::get('index$', 'user.Users/index')->name('user.index');
        })->ext('');

        // 购物车
        Route::get($langPrefix . 'cart$', 'user.Shop/shop_cart_list')
            ->ext('')
            ->name('cart');

        // 搜索
        Route::get($langPrefix . 'sindex$', 'index/Search/index')
            ->ext('')
            ->name('search.index');

        Route::get($langPrefix . 'search$', 'index/Search/lists')
            ->ext('html')
            ->name('search.lists');

        // 标签
        self::registerTagsRoutes($langPrefix, $pattern);

        // 通用列表页和内容页
        self::registerCommonRoutes($langPrefix, $pattern);
    }

    /**
     * 注册完整伪静态路由
     */
    private static function registerFullRewriteRoutes(string $langPrefix, array $pattern): void
    {
        // 会员中心
        Route::group($langPrefix . 'Users', function () {
            Route::get('login$', 'user.Users/login')->name('user.login');
            Route::get('reg$', 'user.Users/reg')->name('user.reg');
            Route::get('centre$', 'user.Users/centre')->name('user.centre');
            Route::get('index$', 'user.Users/index')->name('user.index');
            Route::get('cart$', 'user.Shop/shop_cart_list')->name('user.cart');
        })->ext('html');

        // 各种内容模型
        $models = config('eyoucms.content_models', []);
        foreach ($models as $model) {
            self::registerModelRoutes($langPrefix, $model, $pattern);
        }

        // 单页模型
        Route::get($langPrefix . 'single/<tid>$', 'index/Single/lists')
            ->ext('html')
            ->pattern(['tid' => $pattern['tid']])
            ->name('single');

        // 留言模型
        Route::get($langPrefix . 'guestbook/<tid>$', 'index/Guestbook/lists')
            ->ext('html')
            ->pattern(['tid' => $pattern['tid']])
            ->name('guestbook');

        // 搜索
        Route::get($langPrefix . 'sindex$', 'index/Search/index')
            ->ext('')
            ->name('search.index');

        Route::get($langPrefix . 'search$', 'index/Search/lists')
            ->ext('html')
            ->name('search.lists');

        // 标签
        self::registerTagsRoutes($langPrefix, $pattern);

        // 自定义模型（从数据库读取）
        self::registerCustomModelRoutes($langPrefix, $pattern);
    }

    /**
     * 注册标签路由
     */
    private static function registerTagsRoutes(string $langPrefix, array $pattern): void
    {
        Route::group($langPrefix . 'tags', function () use ($pattern) {
            Route::get('$', 'index/Tags/index')->name('tags.index');
            Route::get('<tagid>_<page>$', 'index/Tags/lists')
                ->pattern([
                    'tagid' => $pattern['tagid'],
                    'page' => $pattern['page']
                ])
                ->name('tags.lists.page');
            Route::get('<tagid>$', 'index/Tags/lists')
                ->pattern(['tagid' => $pattern['tagid']])
                ->name('tags.lists');
        })->ext('html');
    }

    /**
     * 注册通用列表和内容路由（精简格式）
     */
    private static function registerCommonRoutes(string $langPrefix, array $pattern): void
    {
        // 列表页 - 带分页
        Route::get($langPrefix . '<tid>/list_<typeid>_<page>$', 'index/Lists/index')
            ->ext('')
            ->pattern([
                'tid' => $pattern['tid'],
                'typeid' => $pattern['typeid'],
                'page' => $pattern['page']
            ])
            ->name('lists.page');

        // 列表页
        Route::get($langPrefix . '<tid>$', 'index/Lists/index')
            ->ext('')
            ->pattern(['tid' => $pattern['tid']])
            ->name('lists');

        // 内容页
        Route::get($langPrefix . '<dirname>/<aid>$', 'index/View/index')
            ->ext('html')
            ->pattern([
                'dirname' => $pattern['dirname'],
                'aid' => $pattern['aid']
            ])
            ->name('view');
    }

    /**
     * 注册内容模型路由
     */
    private static function registerModelRoutes(string $langPrefix, string $model, array $pattern): void
    {
        $controller = ucfirst($model);

        Route::group($langPrefix . $model, function () use ($controller, $pattern) {
            // 列表页 - 带分页
            Route::get('<tid>/list_<typeid>_<page>$', "index/{$controller}/lists")
                ->pattern([
                    'tid' => $pattern['tid'],
                    'typeid' => $pattern['typeid'],
                    'page' => $pattern['page']
                ]);

            // 列表页
            Route::get('<tid>$', "index/{$controller}/lists")
                ->pattern(['tid' => $pattern['tid']]);

            // 内容页
            Route::get('<dirname>/<aid>$', "index/{$controller}/view")
                ->pattern([
                    'dirname' => $pattern['dirname'],
                    'aid' => $pattern['aid']
                ]);
        })->ext('html')->name($model);
    }

    /**
     * 注册自定义模型路由（从数据库读取）
     */
    private static function registerCustomModelRoutes(string $langPrefix, array $pattern): void
    {
        // 使用缓存避免每次请求都查询数据库
        $cacheKey = 'eyoucms_custom_models';
        $models = Cache::get($cacheKey);

        if (empty($models)) {
            // 从数据库读取自定义模型
            $models = Db::name('channeltype')
                ->field('nid,ctl_name')
                ->where('ifsystem', 0)
                ->select()
                ->toArray();

            Cache::set($cacheKey, $models, 3600); // 缓存1小时
        }

        foreach ($models as $model) {
            $nid = $model['nid'];
            $ctlName = $model['ctl_name'];

            Route::group($langPrefix . $nid, function () use ($ctlName, $pattern) {
                // 列表页 - 带分页
                Route::get('<tid>/list_<typeid>_<page>$', "index/{$ctlName}/lists")
                    ->pattern([
                        'tid' => $pattern['tid'],
                        'typeid' => $pattern['typeid'],
                        'page' => $pattern['page']
                    ]);

                // 列表页
                Route::get('<tid>$', "index/{$ctlName}/lists")
                    ->pattern(['tid' => $pattern['tid']]);

                // 内容页
                Route::get('<dirname>/<aid>$', "index/{$ctlName}/view")
                    ->pattern([
                        'dirname' => $pattern['dirname'],
                        'aid' => $pattern['aid']
                    ]);
            })->ext('html');
        }
    }

    /**
     * 获取多语言前缀
     */
    private static function getLangPrefix(): string
    {
        $config = config('eyoucms');
        $system_langnum = $config['system_langnum'] ?? 1;

        if ($system_langnum > 1) {
            return '<lang>/';
        }

        return '';
    }

    /**
     * 注册静态路由（seo_pseudo = 2）
     */
    private static function registerStaticRoutes(array $pattern): void
    {
        // 静态模式主要访问HTML文件，只需要少量动态接口
        Route::get('api/<controller>/<action>', 'api.<controller>/<action>');
    }

    /**
     * 注册动态路由（seo_pseudo = 1）
     */
    private static function registerDynamicRoutes(): void
    {
        // 动态模式使用默认路由，不需要特殊配置
    }
}
步骤 3：在应用启动时注册路由

修改 route/app.php：

php 复制代码 
<?php
declare(strict_types=1);

use think\facade\Route;
use app\service\RouteService;

// 注册易优CMS风格的路由
RouteService::register();

// 其他自定义路由
Route::get('think', function () {
    return 'hello,ThinkPHP8!';
});
步骤 4：配置路由参数

修改 config/route.php：

php 复制代码 
<?php
return [
    // pathinfo分隔符
    'pathinfo_depr' => '/',

    // 是否强制使用路由
    'url_route_must' => false,

    // URL伪静态后缀
    'url_html_suffix' => 'html',

    // 默认的路由变量规则
    'default_route_pattern' => '[\w\.]+',

    // 是否区分大小写
    'url_case_sensitive' => false,

    // 路由是否完全匹配
    'route_complete_match' => false,

    // 去除URL尾部斜杠
    'remove_slash' => false,
];

关键差异对照表

特性 ThinkPHP 5（易优CMS） ThinkPHP 8 实现方式
路由定义位置 application/route.php route/app.php
路由注册方式 数组方式 Facade + 链式调用
参数语法 <id> 或 :id 统一使用 <id>
参数约束 数组第3个参数 ->pattern([]) 方法
扩展名设置 ['ext' => 'html'] ->ext('html') 方法
路由命名 不支持 ->name('route.name')
中间件 不支持（使用行为） ->middleware([])
路由分组 手动数组合并 Route::group()
动态路由 直接在route.php中执行 通过服务类注册
缓存支持 手动实现 ->cache(3600)

URL生成对比

TP5（易优CMS）

php 复制代码 
// 生成URL
url('home/Article/view', ['aid' => 123, 'dirname' => 'news']);
// 输出：/article/news/123.html

// 带域名的URL
url('home/Article/view', ['aid' => 123], true, true);

TP8

php 复制代码 
// 方式1：使用路由名称生成URL（推荐）
url('article.view', ['aid' => 123, 'dirname' => 'news']);
// 输出：/article/news/123.html

// 方式2：使用完整路径
url('index/Article/view', ['aid' => 123, 'dirname' => 'news']);

// 带域名的URL
url('article.view', ['aid' => 123, 'dirname' => 'news'])->domain(true);

最佳实践建议

1. 使用路由缓存

生成路由缓存以提升性能：

bash 复制代码 
# 生成路由缓存
php think optimize:route

# 清除路由缓存
php think clear --route

2. 分离路由文件

建议按模块分离路由文件：

复制代码 
route/
├── app.php          # 主路由入口
├── admin.php        # 后台路由
├── api.php          # API路由
└── web.php          # 前台路由

在 route/app.php 中引入：

php 复制代码 
<?php
declare(strict_types=1);

use app\service\RouteService;

// 注册易优CMS路由
RouteService::register();

// 引入其他路由文件
require __DIR__ . '/admin.php';
require __DIR__ . '/api.php';

3. 使用路由中间件

php 复制代码 
// 后台路由使用认证中间件
Route::group('admin', function () {
    Route::get('user/index', 'admin.User/index');
    Route::get('article/index', 'admin.Article/index');
})->middleware(['auth', 'admin']);

// API路由使用限流中间件
Route::group('api', function () {
    Route::get('user/info', 'api.User/info');
})->middleware(['throttle:60,1']); // 每分钟60次

4. 合理使用缓存

php 复制代码 
// 自定义模型路由使用缓存
$cacheKey = 'eyoucms_custom_models';
$models = Cache::remember($cacheKey, 3600, function () {
    return Db::name('channeltype')
        ->field('nid,ctl_name')
        ->where('ifsystem', 0)
        ->select()
        ->toArray();
});

5. 类型声明

在控制器方法中使用类型声明：

php 复制代码 
<?php
declare(strict_types=1);

namespace app\controller;

class Article
{
    public function view(int $aid, string $dirname): string
    {
        // 控制器逻辑
        return view('article/view', [
            'aid' => $aid,
            'dirname' => $dirname
        ]);
    }
}

6. 路由命名规范

建议使用统一的路由命名规范：

php 复制代码 
// 模块.控制器.操作
Route::get('article/<id>', 'Article/read')->name('article.read');
Route::get('product/<id>', 'Product/read')->name('product.read');

// 使用时
url('article.read', ['id' => 123]);

迁移检查清单

环境准备

  • 确认PHP版本 >= 8.0
  • 确认已安装Composer 2.0+
  • 确认数据库版本符合要求

配置文件

  • 创建路由配置文件 config/eyoucms.php
  • 修改路由配置 config/route.php
  • 配置数据库连接 config/database.php

代码实现

  • 创建路由服务类 app/service/RouteService.php
  • 修改 route/app.php 注册路由
  • 更新控制器添加类型声明
  • 更新模型添加类型声明

功能测试

  • 测试首页访问
  • 测试列表页路由（带分页和不带分页）
  • 测试内容页路由
  • 测试会员中心路由
  • 测试搜索功能路由
  • 测试标签路由
  • 测试多语言路由（如果启用）
  • 测试自定义模型路由
  • 测试URL生成功能

性能优化

  • 生成路由缓存
  • 测试路由缓存是否生效
  • 配置OPcache
  • 配置Redis缓存（如果使用）

上线准备

  • 备份原有系统
  • 准备回滚方案
  • 编写部署文档
  • 进行压力测试

常见问题解答

Q1: 路由不生效怎么办？

A: 检查以下几点：

  1. 确认 RouteService::register() 已在 route/app.php 中调用
  2. 清除路由缓存：php think clear --route
  3. 检查 Nginx/Apache 的 rewrite 规则是否正确配置
  4. 确认 config/route.php 中 url_route_must 设置正确

Q2: 如何调试路由？

A: 使用以下方法：

php 复制代码 
// 在 route/app.php 中添加
Route::get('debug/routes', function () {
    $routes = app()->route->getRuleList();
    dump($routes);
});

访问 /debug/routes 查看所有已注册的路由。

Q3: 多语言路由如何实现？

A: 在 config/eyoucms.php 中设置：

php 复制代码 
'system_langnum' => 2, // 启用多语言

路由会自动添加 <lang>/ 前缀，如：

  • 中文：/cn/article/news/123.html
  • 英文：/en/article/news/123.html

Q4: 如何添加新的内容模型？

A: 有两种方式：

方式1：配置文件添加

php 复制代码 
// config/eyoucms.php
'content_models' => [
    'article',
    'product',
    'mynewmodel', // 新增模型
],

方式2：数据库添加

在 channeltype 表中添加记录，路由会自动从数据库读取。

Q5: 性能如何优化？

A: 建议采取以下措施：

  1. 启用路由缓存：php think optimize:route
  2. 使用Redis缓存自定义模型数据
  3. 启用OPcache
  4. 使用CDN加速静态资源
  5. 开启Gzip压缩

总结

本文档详细说明了如何在 ThinkPHP 8.1.3 中实现 ThinkPHP 5.0.24（易优CMS）的路由效果。核心要点：

  1. 配置驱动：通过配置文件控制路由行为
  2. 服务类注册：使用服务类动态注册路由规则
  3. 完全兼容：支持易优CMS的所有路由特性
  4. 性能优化：使用缓存提升性能
  5. 类型安全：利用PHP 8的类型系统提升代码质量

通过本方案，可以在保持易优CMS路由特性的同时，享受ThinkPHP 8带来的现代化特性和性能提升。

参考资料

文档版本 ：v1.0
最后更新 ：2025-12-31
适用版本：ThinkPHP 8.1.3 / 易优CMS (ThinkPHP 5.0.24)

相关推荐
BingoGo1 天前
当你的 PHP 应用的 API 没有限流时会发生什么？
后端·php
JaguarJack1 天前
当你的 PHP 应用的 API 没有限流时会发生什么？
后端·php·服务端
BingoGo2 天前
OpenSwoole 26.2.0 发布：支持 PHP 8.5、io_uring 后端及协程调试改进
后端·php
JaguarJack2 天前
OpenSwoole 26.2.0 发布：支持 PHP 8.5、io_uring 后端及协程调试改进
后端·php·服务端
JaguarJack3 天前
推荐 PHP 属性(Attributes) 简洁读取 API 扩展包
后端·php·服务端
BingoGo3 天前
推荐 PHP 属性(Attributes) 简洁读取 API 扩展包
php
JaguarJack4 天前
告别 Laravel 缓慢的 Blade！Livewire Blaze 来了，为你的 Laravel 性能提速
后端·php·laravel
郑州光合科技余经理5 天前
代码展示：PHP搭建海外版外卖系统源码解析
java·开发语言·前端·后端·系统架构·uni-app·php
QQ5110082855 天前
python+springboot+django/flask的校园资料分享系统
spring boot·python·django·flask·node.js·php
WeiXin_DZbishe5 天前
基于django在线音乐数据采集的设计与实现-计算机毕设 附源码 22647
javascript·spring boot·mysql·django·node.js·php·html5
热门推荐
01GitHub 镜像站点02OpenClaw 使用和管理 MCP 完全指南03OpenClaw + 飞书（Feishu）环境搭建指南04【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆05OpenClaw优化飞书API 额度已耗尽问题06Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services07小黑课堂计算机二级WPSoffice题库软件下载安装教程（2026年3月最新版）08Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤09Window 10部署openclaw报错node.exe : npm error code 12810OpenClaw大龙虾机器人完整安装教程