ThinkPHP 8 多应用架构搭建与落地要点

建目录时我更建议用 php think build，比手工一个个建省事，也少出漏项。

4. 路由怎么配

4.1 全局路由

在 config/route.php 里可以先把默认应用和域名绑定定下来。

<?php return [
    'default_app' => 'index',
    'deny_app_list' => ['common'],
    'domain_bind' => [
        'admin.example.com' => 'admin',
        'api.example.com' => 'api',
        'www.example.com' => 'index',
    ],
];

4.2 应用自己的路由

每个应用都可以有独立路由文件，比如 app/admin/route/app.php。

<?php use think\facade\Route;
Route::get('/', 'index/index');
Route::resource('user', 'user');
Route::group(function() {
    Route::get('dashboard', 'index/dashboard');
})->middleware(\app\admin\middleware\AdminAuth::class);

API 一般会顺手做版本号管理，比如 v1、v2。这不是为了好看，主要是后面升级接口时不会把老客户端一起拖下水。

5. 服务层放哪一层最合适

服务层夹在控制器和模型之间，用来收业务规则比较合适。通用逻辑放到 app/common/service/，应用自己的流程就留在各自目录里。

共享服务示例：

<?php declare(strict_types=1);
namespace app\common\service;
use think\facade\Cache;

class UserService {
    public function getUserInfo(int $userId): array {
        $cacheKey = 'user_info_' . $userId;
        return Cache::remember($cacheKey, function() use ($userId) {
            // 查询数据库逻辑
            return [];
        }, 3600);
    }
}

这样后台和 API 都能直接复用这段逻辑，少写重复代码，也少一层同步成本。

6. 模型共享怎么处理

模型统一放在 app/common/model/，各应用直接引用就行。这个做法挺朴素，但在多应用场景里很实用，至少不会把同一张表的模型拆成好几份。

<?php namespace app\common\model;
use think\Model;

class User extends Model {
    protected $name = 'user';
    protected $hidden = ['password'];
}

7. 缓存和数据库别混在一起

7.1 缓存策略

如果缓存后端用 Redis，最好给不同应用加前缀，不然后面查问题会很痛苦。

// 应用专属缓存
$appName = app('http')->getName();
Cache::set($appName . ':user_list', $data);

7.2 数据库连接

如果不同应用的数据本来就要隔离，可以在 config/database.php 里放多个连接。

return [
    'connections' => [
        'mysql' => [...],
        'mysql_admin' => ['database' => 'admin_db', ...],
    ],
];

8. 中间件按应用分开管

中间件适合做请求拦截、认证这类横切逻辑。全局中间件放在 app/middleware.php，应用级中间件放在各自目录下，边界会清楚很多。

后台认证中间件：

<?php namespace app\admin\middleware;
use think\facade\Session;

class AdminAuth {
    public function handle($request, \Closure $next) {
        if (!Session::has('admin_id')) {
            return redirect('/admin/login');
        }
        return $next($request);
    }
}

JWT 认证中间件（API）：

<?php namespace app\api\middleware;
use app\api\service\TokenService;

class JwtAuth {
    public function handle($request, \Closure $next) {
        $token = $request->header('Authorization');
        // 解析 Token 并注入用户信息
        return $next($request);
    }
}

9. 异常返回统一起来

自定义全局异常处理器 app/ExceptionHandle.php，把错误统一成 JSON 返回。前后端分离时这一步很值，至少接口行为不会一会儿 JSON、一会儿 HTML。

<?php class ExceptionHandle extends Handle {
    public function render($request, Throwable $e) {
        if ($e instanceof ValidateException) {
            return json(['code' => 1, 'msg' => $e->getError()]);
        }
        return json(['code' => 500, 'msg' => $e->getMessage()]);
    }
}

10. 跨应用调用别乱来

模型和服务虽然已经共享了，但有时还是会碰到必须调用某个应用专属服务的情况。能下沉到 common 的尽量下沉，不然很容易把依赖绕成一团。

// API 应用调用后台服务
use app\admin\service\AdminService;
$adminService = new AdminService();
$result = $adminService->login('admin', '123456');

11. 安全和性能，别只看功能跑通

11.1 SQL 注入防护

查询尽量走参数绑定，不要自己拼 SQL。

// ✅ 正确
$list = Db::name('user')->where('id', $id)->select();

// ❌ 错误
$sql = "SELECT * FROM user WHERE id = $id";

11.2 XSS 防护

模板引擎默认会转义，只有在你明确知道输出内容安全时，才考虑用 {raw}。

11.3 性能优化

• 开启路由缓存：php think optimize:route
• 开启配置缓存：php think optimize:config
• 热点数据放进 Redis

12. 常见问题

Q: 如何设置默认应用？ 在 config/route.php 中设置 'default_app' => 'index'。

Q: 多应用如何共享 Session？ Session 默认共享，确保 config/session.php 中的 prefix 一致。

Q: 如何实现应用独立配置？ 创建 app/admin/config/app.php，使用 config('app.app_name') 获取。

13. 实际落地时，我会优先做这几件事

1. 先把 common 和应用目录边界划清楚，别一上来就把所有逻辑堆进控制器。
2. 路由和域名绑定先定下来，后面改这个最容易牵一发动全身。
3. 缓存加前缀，数据库按业务隔离，省得排查时互相污染。
4. 资源路由能用就先用，手写规则留给少数特殊场景。

14. 环境配置示例

.env 文件可以先按这个模板配：

APP_DEBUG = false
[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = myapp
USERNAME = root
PASSWORD = 123456

生产环境里调试模式最好关掉，自动加载优化命令也别省。