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 格式的错误信息，提升前端交互体验。

<?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. 命名规范：控制器和服务类首字母大写，符合 PSR 标准。
3. 依赖注入：推荐在构造函数中注入服务，便于测试和维护。
4. 缓存策略：使用 Redis 并添加应用前缀，避免数据污染。
5. 路由规划：优先使用资源路由，减少手写路由规则。

14. 附录：环境配置示例

.env 文件配置参考：

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

生产环境务必关闭调试模式，并执行自动加载优化命令。