罗罗编程学习记录
本页内容 展开查看

06.5.2.1 架构总览与应用生命周期

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.2 ThinkPHP

本节要解决的问题

  • 一次请求从入口文件到响应输出经过哪些阶段,各阶段由谁负责?
  • 应用初始化加载了哪些配置、公共文件、事件与服务?
  • 单应用与多应用目录约定、调试模式与 Trace、6.x 与 8.0 的框架层差异如何对照?

版本前提:ThinkPHP 6.x / 8.0;8.0 要求 PHP 8.0+,具体版本兼容矩阵以官方安装手册与项目 composer.json 为准。Swoole 扩展内部机制只引用不展开。

06.5.2.1-001 ThinkPHP 8.0 的入口文件做了什么?

一句话结论

入口文件 public/index.php 只做四件事:加载 Composer 自动加载、创建 think\App 实例并取 http 应用、执行 run() 得到响应、发送响应并调用 end() 收尾;业务逻辑不在入口文件里。

概念解释

入口是 Web 服务器唯一暴露的 PHP 文件,负责引导框架而不写业务。App 既是应用对象也是容器,http 属性指向 think\Http 应用类,真正的请求调度在 Http::run() 内完成。

原理流程

  1. require 引入 vendor/autoload.php,注册类自动加载。
  2. new App() 创建应用(容器)实例,通过 ->http 拿到 HTTP 应用对象。
  3. $http->run() 完成初始化、路由调度与控制器执行,返回 Response 对象。
  4. $response->send() 输出内容与头信息,$http->end($response) 执行收尾逻辑。

代码或图示

<?php
namespace think;

require __DIR__ . '/../vendor/autoload.php';

$http = (new App())->http;
$response = $http->run();
$response->send();
$http->end($response);

常见误区

  • 在入口文件里写鉴权、参数预处理:这些应放在中间件或控制器,入口只保留引导职责。
  • 把业务脚本放到 public 下直接访问:绕过框架引导,初始化与安全约束不一致。

追问

  • 多入口应用如何区分?答:可为后台等应用单独建 admin.php 入口,内容结构与 index.php 一致,入口文件名(不含后缀)即应用名,细节以多应用手册为准。
  • 自定义请求对象怎么注入?答:run($request) 可传入自定义 Request 实例,框架默认使用 app\Request。

06.5.2.1-002 think\App 与 think\Http 各承担什么职责?

一句话结论

App 是应用基础类兼容器,负责路径、配置、服务绑定与全局状态;Http 是 HTTP 应用类,负责把一次请求包装成 Request、跑中间件链、调度路由并产出 Response。

概念解释

App 在引导阶段完成环境与容器准备,Http 在请求阶段串联中间件与路由调度。命令行入口走另一套应用处理,HTTP 与 CLI 共享 App 但执行内核不同。

原理流程

  1. 构造 App:确定应用目录、加载基础环境与容器绑定。
  2. 从 App 解析 Http 实例(容器标识为 http)。
  3. Http::run() 构建请求对象、执行全局中间件、路由调度。
  4. Http::end() 在响应发送后执行终止阶段的清理与回调。

代码或图示

$app = new \think\App();
$http = $app->http;          // 等价于从容器解析 http 标识
$response = $http->run();    // 请求处理内核
$http->end($response);       // 终止阶段

常见误区

  • 把 App 当纯配置对象:它同时是容器,对象实例通过它解析。
  • 在 App 构造阶段读取请求参数:此时请求尚未进入 HTTP 内核。

追问

  • 容器与 App 的关系?答:容器工作由 think\Container 完成,App 继承/复用容器能力,多数场景通过 app() 助手操作。
  • CLI 请求由谁处理?答:由控制台应用类处理,Request 在 CLI 下有默认值,细节以框架控制台模块文档为准。

06.5.2.1-003 一次 HTTP 请求的完整生命周期分哪些阶段?

一句话结论

标准链路为:自动加载 → 创建 App → 初始化应用(环境、公共文件、配置、事件、服务)→ 注册异常处理 → 全局中间件 → 路由调度 → 路由/控制器中间件 → 控制器/闭包 → 响应经中间件返回 → 发送响应与终止。

概念解释

生命周期可概括为引导(initialize)、处理(run)、终止(end)三段。路由检测、模型绑定、控制器解析都发生在处理段;响应对象沿中间件链反向回到入口后发送。

原理流程

  1. 引导:载入 .env、公共函数、配置、事件定义、服务定义,判断调试模式,监听 AppInit。
  2. 处理:注册异常处理与服务,加载全局中间件,监听 HttpRun,执行全局中间件后进入路由调度。
  3. 调度:加载路由定义、监听 RouteLoaded、匹配路由、注册路由中间件、绑定模型并解析控制器。
  4. 返回:控制器产出数据,包装为 Response,经中间件后置逻辑处理后 send(),最后 end() 收尾。

代码或图示

public/index.php
  → new App() → App::initialize()
  → Http::run()
      → 全局中间件
      → 路由匹配与调度
      → 路由/控制器中间件
      → 控制器/闭包 → Response
  → Response::send()
  → Http::end()
// 各阶段对应的框架入口(示意)
$app = new \think\App();
$http = $app->http;
$response = $http->run();
$http->end($response);

常见误区

  • 认为控制器是生命周期入口:真正入口是入口文件与 Http 内核,控制器只是调度目标。
  • 把终止阶段要做的事写进控制器末尾:终止逻辑应挂到 end 阶段或对应事件。

追问

  • 路由未匹配走哪一步?答:由路由 MISS 规则或异常处理器兜底,返回 404 或统一错误结构。
  • 哪些事件挂在生命周期关键点?答:AppInit、HttpRun、RouteLoaded 等,事件定义在 app/event.php,具体事件名以版本手册为准。

06.5.2.1-004 应用初始化 initialize 阶段加载了哪些内容?

一句话结论

初始化阶段读取环境变量与全局初始化文件,加载公共函数、助手函数、全局配置、事件定义与服务定义,判断调试模式,监听 AppInit 事件并注册异常处理。

概念解释

该阶段把可在请求前准备好的元数据与绑定全部就绪,请求阶段直接使用。配置与事件文件按约定目录自动扫描,多应用下还会叠加应用级配置。

原理流程

  1. 读取 .env 环境变量与全局初始化文件。
  2. 加载全局公共文件 app/common.php 与系统助手函数。
  3. 读取 config 目录下全局配置文件、app/event.php 事件定义、app/provider.php 服务定义。
  4. 按 APP_DEBUG 判断调试/部署模式,触发 AppInit 事件,注册异常处理器。

代码或图示

// app/provider.php 服务/对象绑定示例
return [
    'app\Request'    => \app\Request::class,
    'app\ExceptionHandle' => \app\ExceptionHandle::class,
];

常见误区

  • 在初始化阶段访问路由参数或会话:此时请求尚未调度,参数不可用。
  • 每次请求重复注册绑定:服务与对象绑定应在 provider.php 或服务类中完成一次。

追问

  • 配置缓存后初始化还读文件吗?答:开启配置缓存后运行期直接读缓存产物,改动配置需重新生成缓存,命令以版本手册为准。
  • 多应用配置如何叠加?答:全局 config 对所有应用生效,应用目录下 config 同名参数覆盖全局。

06.5.2.1-005 调试模式由什么控制,生产环境应注意什么?

一句话结论

调试模式由环境变量 APP_DEBUG 控制(.env 中设置),开启后显示详细错误、Trace 与调试信息;生产环境必须关闭,避免堆栈、配置与路径泄漏。

概念解释

调试模式影响异常页面是否展示详情、Trace 是否记录、日志级别等行为。.env 不提交仓库,不同环境通过环境变量切换;框架按调试/部署模式加载对应行为。

原理流程

  1. .env 中写入 APP_DEBUG = true(开发)或 false(生产)。
  2. 初始化阶段读取该变量决定应用模式。
  3. 异常处理器按模式决定输出详细调试页还是统一错误响应。
  4. Trace 配置由 config/trace.php 控制,记录位置与开关以版本为准。

代码或图示

# .env(不提交版本库)
APP_DEBUG = false
// 运行期读取环境配置(业务代码建议经 config() 读取,而非直接 env())
$debug = \think\facade\Config::get('app.app_debug', false);

常见误区

  • 生产环境保留 APP_DEBUG=true:错误堆栈与内部路径直接暴露给客户端。
  • 在业务代码里到处调用 env():配置缓存后 env() 可能返回空,应通过 config() 取值。

追问

  • Trace 页面/日志在哪里配置?答:config/trace.php 控制 Trace 开关与记录方式,具体配置键名以当前版本手册核对。
  • 如何确认线上已关闭调试?答:检查运行环境变量与 config('app.app_debug'),并触发一个已知异常观察输出是否含堆栈详情。

06.5.2.1-006 单应用模式的目录结构约定是什么?

一句话结论

单应用下 app 目录直接放 controller、model、middleware、validate、event.php、provider.php 等;public 是唯一 Web 入口,config 放配置,runtime 放运行期产物,extend 放扩展类库,vendor 由 Composer 管理。

概念解释

目录约定对应框架自动加载与调度规则:控制器、模型等按命名空间定位。runtime 需要可写权限,public 之外的目录不应被 Web 直接访问。

原理流程

  1. app/controller 存放控制器,app/model 存放模型,app/middleware 存放中间件。
  2. app/validate 存放验证器,app/event.php 定义事件与监听器,app/provider.php 定义容器绑定。
  3. config/*.php 为全局配置,public/index.php 为入口,runtime 写缓存、日志与编译产物。

代码或图示

app/
├── controller/
├── model/
├── middleware/
├── validate/
├── BaseController.php
├── Request.php
├── ExceptionHandle.php
├── common.php
├── middleware.php
├── provider.php
└── event.php
namespace app\controller;

class User
{
    public function index()
    {
        return \think\facade\Db::name('user')->select();
    }
}

常见误区

  • 把模型、验证器放到 controller 同级目录但不改命名空间:PSR-4 自动加载失败。
  • 提交 runtime 或 vendor 到版本库:运行产物与依赖应通过构建/安装生成。

追问

  • 公共跨模块逻辑放哪里?答:app/common.php 放函数,类库可放 extend 或独立 Service 目录,经容器取用。
  • 自定义 Request/ExceptionHandle 改了类名要改哪里?答:同步调整 provider.php 中的容器绑定,否则框架仍解析默认绑定。

06.5.2.1-007 单应用与多应用目录结构有何区别?

一句话结论

多应用需要安装多应用扩展,app 下每个子目录是一个独立应用,各自带 controller、model、config、route 等;安装后需删除 app 根下的 controller 目录,框架据此判断是否多应用模式。

概念解释

多应用模式下应用间路由、配置、中间件相互隔离,共享框架核心与 Composer 扩展。是否启用自动多应用、默认应用名等由配置控制。

原理流程

  1. 通过 Composer 安装多应用扩展(包名以官方手册为准)。
  2. 把 app/controller 等移动到 app/<应用名>/ 子目录。
  3. 每个应用维护独立 route、config、middleware 与 MVC 文件。
  4. URL 第一段匹配应用名,未匹配时按默认应用或快速访问配置处理。

代码或图示

app/
├── index/            # index 应用
│   ├── controller/
│   ├── model/
│   ├── route/
│   └── config/
├── admin/            # admin 应用
└── common.php
namespace app\admin\controller;

class Dashboard
{
    public function index()
    {
        return json(['app' => 'admin']);
    }
}

常见误区

  • 多应用下仍保留 app/controller:框架可能误判为单应用模式。
  • 跨应用直接引用对方模型与内部类:破坏应用边界,应通过服务接口或公共层通信。

追问

  • 默认应用与快速访问如何配置?答:app.php 中 default_app、app_express 等参数,具体键名以多应用手册核对。
  • 多应用路由能跨应用吗?答:各应用路由独立,不能直接跨应用调度,跨应用跳转走重定向路由。

06.5.2.1-008 ThinkPHP 6.x 与 8.0 在框架层有哪些主要差异?

一句话结论

8.0 基于 PHP 8.0+ 重构,默认依赖 think-orm 3.0;模板引擎不再内置需单独装 think-view;部分组件(如 Validate、Container)在后续小版本中移出核心成为独立依赖;语法与类型声明按 PHP 8 规范编写。

概念解释

版本差异集中在运行时下限、组件拆分与依赖管理。跨版本升级需逐项核对废弃 API、配置键与行为变化,不能只改版本号。

原理流程

  1. 核对 PHP 版本下限:8.0 要求 PHP 8.0+;6.x 的 PHP 兼容区间以对应版本手册为准(待确认,按 composer.json 核实)。
  2. 核对 ORM 版本:8.0 默认 think-orm 3.0,4.0 为可选升级,实体模型分层为 4.0 特性。
  3. 核对模板与组件:视图需安装 think-view;独立组件通过 Composer 依赖引入。
  4. 升级时对照更新日志逐项检查废弃方法与行为变更。

代码或图示

// composer.json 中核对依赖约束(示意,实际以项目文件为准)
{
  "require": {
    "php": ">=8.0",
    "topthink/framework": "^8.0",
    "topthink/think-orm": "^3.0"
  }
}
// 升级前先核对 composer.json 的 php 与框架约束,再引导应用
require __DIR__ . '/../vendor/autoload.php';
$app = new \think\App();

常见误区

  • 只升框架主版本不升 PHP:语法特性与扩展不兼容,引导或调用期报错。
  • 假设 6.x 写法在 8.0 全部可用:移除/改名的组件与方法需按更新日志替换。

追问

  • 哪里查版本兼容矩阵?答:官方安装手册、更新日志与项目 composer.json 的 require 约束三者对照。
  • 8.1 有哪些框架层新特性?答:分组绑定 namespace/controller/layer/class、withoutMiddleware 排除中间件、when 路由变量验证等,以 8.1 更新日志为准。

06.5.2.1-009 provider.php 服务提供定义文件起什么作用?

一句话结论

app/provider.php 返回容器绑定数组,把类名或标识绑定到实现类;自定义 Request、异常处理器等基础对象在此登记,框架引导时自动解析。

概念解释

它是批量绑定容器对象的约定文件,避免在代码里手动 bind。绑定键通常为类名或容器标识,值为实现类名;替换实现只改这里。

原理流程

  1. 初始化阶段读取 provider.php 返回的数组。
  2. 逐项调用容器绑定,建立标识到实现的映射。
  3. 后续控制器、服务解析依赖时,按绑定标识从容器取实例。
  4. 更换实现时只需修改数组中的类名,消费方代码不变。

代码或图示

// app/provider.php
return [
    'app\Request'          => \app\Request::class,
    'app\ExceptionHandle'  => \app\ExceptionHandle::class,
];

常见误区

  • 改了自定义类名却不更新 provider.php:框架仍解析旧绑定,自定义方法不生效。
  • 在 provider.php 里写复杂初始化逻辑:绑定只声明映射,初始化应放服务类的注册/启动方法。

追问

  • 服务类与 provider 绑定区别?答:简单对象映射用 provider.php;需要注册事件、路由、批量绑定等逻辑用继承 think\Service 的服务类。
  • 绑定接口到实现怎么做?答:数组键写接口名,值写实现类名,消费方依赖接口注入。

06.5.2.1-010 全局公共函数 common.php 在什么时候被加载?

一句话结论

app/common.php 在应用初始化阶段随全局公共文件一起加载,其中定义的助手函数在控制器、模型、中间件等各处可直接调用。

概念解释

公共函数文件承载跨层复用的过程式函数,框架在引导阶段自动引入,无需手动 require。系统内置助手函数由框架助手函数文件提供,可在公共函数中覆盖。

原理流程

  1. 初始化阶段扫描并加载 app/common.php。
  2. 文件内定义的函数进入全局函数表。
  3. 请求处理各层直接调用这些函数。
  4. 多应用下还会加载各应用自己的公共函数文件。

代码或图示

// app/common.php
function money_fmt(int $cents): string
{
    return number_format($cents / 100, 2);
}
// 控制器中直接使用
return json(['amount' => money_fmt(1999)]);

常见误区

  • 在 common.php 里写有状态的类或依赖容器的逻辑:函数文件适合无状态工具函数。
  • 重复定义与内置助手同名的函数:可能覆盖系统行为,需谨慎并确认版本。

追问

  • 公共函数能依赖注入吗?答:普通全局函数不自动注入,需要时通过 app() 容器取实例。
  • 函数找不到怎么排查?答:先确认文件已被加载、命名无冲突,再查 OPcache 是否缓存旧版本。

06.5.2.1-011 生命周期上有哪些关键事件挂接点?

一句话结论

框架在初始化、HTTP 启动、路由加载等节点触发事件(如 AppInit、HttpRun、RouteLoaded),业务通过 event.php 注册监听器解耦横切动作;具体事件名以当前版本手册为准。

概念解释

事件把主流程与副作用分开:日志、统计、预处理等由监听器在挂载点执行。监听器可同步执行,重逻辑应转异步任务,避免拖慢主请求。

原理流程

  1. 在 app/event.php 中把事件类/标识映射到监听器类。
  2. 框架到达生命周期节点时触发对应事件。
  3. 监听器接收事件对象,执行附加逻辑。
  4. 监听器异常按同步/异步策略处理,同步异常会影响主流程。

代码或图示

// app/event.php 示例结构(事件名与监听器绑定以版本手册为准)
return [
    'listen' => [
        'AppInit' => [\app\listener\BootLogger::class],
    ],
];

常见误区

  • 监听器内做同步重计算或远程调用:主请求被拖慢,应投递队列异步执行。
  • 事件对象携带后续会被修改的引用:分发后被改动会影响监听器看到的数据。

追问

  • 监听器失败如何处理?答:同步事件异常向上抛出影响主流程;异步监听器走队列重试与死信机制。
  • 事件与模型事件区别?答:生命周期事件挂在框架流程节点,模型事件挂在数据保存/删除等动作上。

06.5.2.1-012 异常处理器如何接入并统一输出错误?

一句话结论

框架在初始化阶段注册异常处理器(默认 app\ExceptionHandle),链路中抛出的异常统一进入处理器,按异常类型映射状态码并渲染 JSON 或视图,业务代码只抛语义异常。

概念解释

异常收口在入口层:控制器与服务不各自拼接错误响应,处理器决定输出格式、记录日志并映射 HTTP 状态码。HTTP 异常与内部异常分别处理。

原理流程

  1. provider.php 绑定异常处理器类到容器。
  2. 初始化注册该处理器接管未捕获异常。
  3. 请求链路抛出异常后进入处理器的渲染方法。
  4. 处理器按类型选择响应结构与状态码,必要时记录日志后返回。

代码或图示

namespace app;

use think\exception\Handle;
use think\facade\Log;

class ExceptionHandle extends Handle
{
    public function render($request, \Throwable $e)
    {
        Log::error($e->getMessage(), ['trace' => $e->getTraceAsString()]);
        return json(['code' => 500, 'msg' => '服务器内部错误'], 500);
    }
}

常见误区

  • 每个控制器 try/catch 后自拼响应:错误结构不统一,难以收口。
  • 生产环境把完整堆栈与内部细节返回给客户端。

追问

  • 参数校验失败异常是什么?答:think\exception\ValidateException,可通过 getError() 取错误信息。
  • 404 与业务异常如何区分映射?答:路由未匹配走 MISS/404 处理;业务异常在处理器中按类型映射 400/403/404/409 等状态码。

06.5.2.1-013 runtime 运行时目录存放什么,权限有什么要求?

一句话结论

runtime 存放日志、缓存、模板编译、路由/配置缓存等运行期产物,目录必须对运行 PHP 的用户可写;该目录是生成物,不手工编辑也不纳入版本管理。

概念解释

框架把可再生的临时数据放 runtime,按子目录分类。部署时需保证目录存在且权限正确,否则写日志或缓存时失败。

原理流程

  1. 日志写入 runtime/log 下按日期分文件。
  2. 缓存与编译产物写入 runtime/cache 或对应子目录。
  3. 路由、配置等编译缓存落在运行时目录。
  4. 清理 runtime 可再生全部产物,不影响源码。

代码或图示

runtime/
├── log/          # 按日期的日志文件
├── cache/        # 文件缓存与编译产物
└── temp/         # 临时文件(子目录划分以版本为准)
// 日志与缓存产物落在 runtime,业务代码不直接写运行时路径
\think\facade\Log::info('request', ['module' => 'runtime']);
\think\facade\Cache::set('flag', 1, 60);

常见误区

  • 把业务数据或配置放进 runtime:重启/清理后丢失。
  • 生产环境 runtime 只读:日志与缓存写入直接报错。

追问

  • 部署后首次访问报权限错误怎么排查?答:检查 runtime 及其子目录属主与写权限,确认 PHP 运行用户可写。
  • 缓存残留导致改动不生效怎么办?答:清理对应运行时缓存产物并重新生成编译缓存。

06.5.2.1-014 路由定义文件放在哪里,如何被加载?

一句话结论

单应用路由定义在 route 目录下(默认 route.php,可拆多个文件);多应用下路由放在各应用目录的 route 子目录。框架在路由调度阶段加载定义文件并注册规则。

概念解释

路由按应用隔离,route 目录下所有文件都会被加载,拆分文件只为管理方便。未定义路由时可按“控制器/操作”方式访问,开启强制路由后则必须显式定义。

原理流程

  1. 路由文件中调用 Route::rule/get/post/... 注册规则。
  2. 进入路由调度阶段时框架加载当前应用的路由文件。
  3. 触发 RouteLoaded 事件后开始逐条匹配。
  4. 多应用只加载当前应用的路由文件。

代码或图示

// route/app.php
use think\facade\Route;

Route::get('hello/:name', 'hello/index');
Route::group('api', function () {
    Route::rule('list/:id', 'api/list');
});

常见误区

  • 把路由写进控制器文件:调度阶段加载不到,规则不生效。
  • 多应用下在全局路由里跨应用引用控制器:应用间路由相互隔离。

追问

  • 路由延迟解析与缓存有什么影响?答:开启延迟解析后规则按需解析,配合路由缓存提升匹配性能;URL 反转生成需要路由映射缓存,细节以手册为准。
  • 一个项目可以有多个路由文件吗?答:可以,route 目录下任意 .php 都会被加载。

06.5.2.1-015 中间件在生命周期的什么位置执行?

一句话结论

中间件包裹控制器执行:全局中间件先于应用、路由、控制器中间件,前置逻辑在请求进入控制器前,后置逻辑在响应返回后,整体呈洋葱嵌套。

概念解释

中间件处理鉴权、跨域、Session 初始化、请求缓存等横切关注点。注册分组与顺序决定前置逻辑能否拿到请求、后置逻辑能否改写响应。

原理流程

  1. 全局中间件在路由匹配前后依次通过。
  2. 匹配路由后注册路由中间件,控制器实例化后执行控制器中间件。
  3. 各中间件前置逻辑执行后调用 $next($request) 进入下一层。
  4. 响应沿链反向穿过各中间件后置逻辑后发送。

代码或图示

public function handle($request, \Closure $next)
{
    // 前置逻辑:控制器执行前
    $response = $next($request);
    // 后置逻辑:控制器执行后
    return $response;
}

常见误区

  • 中间件里写业务规则:应下沉到 Service 层复用。
  • 鉴权中间件排在业务处理之后:失去拦截意义。

追问

  • 中间件如何把值传给控制器?答:在前置阶段给 $request 对象赋值属性,控制器通过注入的 Request 读取。
  • 中间件分组顺序?答:全局 → 应用 → 路由 → 控制器。

06.5.2.1-016 什么是数据库惰性连接?

一句话结论

模型与 Db 只有在真正执行数据库查询时才建立连接,类实例化、组装查询条件阶段不连接数据库;这减少了不涉及 DB 的请求的连接开销。

概念解释

查询构造器先收集条件,最终执行 find/select/insert 等语句时才解析连接并发送 SQL。连接资源按需获取,支持多数据库与动态切换。

原理流程

  1. 创建模型或 Db::name() 查询对象,只保存表名与条件。
  2. 链式调用 where/order/field 等只修改查询构造状态。
  3. 调用执行方法时才获取数据库连接并绑定参数发送 SQL。
  4. 结果返回后连接由连接池/驱动管理复用或释放。

代码或图示

$query = \think\facade\Db::name('user')->where('status', 1);
// 此处尚未连接数据库
$list = $query->order('id', 'desc')->select();
// 执行 select 时才建立连接并查询

常见误区

  • 以为实例化模型就占用连接:连接发生在语句执行时。
  • 在组装条件阶段读取连接级状态(如事务标识):此时连接可能尚未建立。

追问

  • 事务何时开始占用连接?答:startTrans 或 transaction() 执行时开启事务并绑定连接。
  • 断点重连是什么?答:长时间空闲后连接被服务端断开,框架/驱动在下次执行前检测并重连,具体机制以 think-orm 文档为准。

06.5.2.1-017 为什么模板引擎需要单独安装?

一句话结论

8.0 不再内置 think-template 模板引擎,需要官方模板时单独安装 think-view 驱动扩展;纯 API 项目可以不装视图组件。

概念解释

框架把视图作为可替换驱动,减少核心体积。安装后通过 View 门面或 view() 助手渲染模板,模板标签由驱动解析。

原理流程

  1. Composer 安装 think-view 扩展。
  2. config/view.php 配置模板路径、后缀与驱动参数。
  3. 控制器返回 view() 渲染结果,驱动编译模板并输出。
  4. 不使用模板时,控制器直接返回 json() 数据。

代码或图示

composer require topthink/think-view
return view('hello', ['name' => 'ThinkPHP']);

常见误区

  • 升级到 8.0 后直接用视图:未装驱动导致视图类不存在。
  • 在模板里拼业务查询:模板只负责展示,数据由控制器/服务准备。

追问

  • 可以替换成其他模板引擎吗?答:视图采用驱动式设计,可按契约实现自定义驱动,具体接口以视图手册为准。
  • 模板编译缓存放哪里?答:落在 runtime 编译目录,改动模板后清理对应缓存生效。

06.5.2.1-018 命令行入口 think 与 HTTP 入口有何不同?

一句话结论

项目根目录的 think 文件是 CLI 入口,由控制台应用解析注册的命令;HTTP 入口 public/index.php 由 Web 服务器调用。两者共享 App 与容器,但执行内核与请求对象不同。

概念解释

CLI 下没有真实 HTTP 请求,Request 取默认值,method() 返回 GET 且 isCli() 为 true。命令在 app/console.php 注册,继承控制台命令类实现。

原理流程

  1. CLI 执行 php think <命令名> [参数],由 think 入口引导 App。
  2. 控制台应用读取 console.php 注册的命令列表并匹配。
  3. 执行命令的 configure/execute 逻辑,输出到终端。
  4. HTTP 请求则经 Http 内核调度到控制器。

代码或图示

php think run -p 8000
// app/console.php 命令注册示例(结构以版本手册为准)
return [
    'commands' => [
        'app\command\Foo',
    ],
];

常见误区

  • 在命令里依赖真实 $_SERVER / Session:CLI 上下文没有 HTTP 请求与会话。
  • 把定时任务逻辑写进 HTTP 控制器:应做成命令并由调度器调用。

追问

  • 开发服务器命令是什么?答:php think run 启动内置开发服务器,端口可用 -p 指定,仅用于本地开发。
  • 命令里如何取容器实例?答:通过 $this->app 或 app() 助手解析,与 HTTP 共用容器绑定。

06.5.2.1-019 Trace 调试信息如何配置与使用?

一句话结论

Trace 用于记录当前请求的 SQL、日志、运行信息等调试数据,配置在 config/trace.php;仅开发环境开启,生产关闭。具体开关与记录方式以当前版本手册为准(待确认项)。

概念解释

Trace 是调试辅助层,配合调试模式输出请求明细。生产环境开启会带来性能开销与信息泄漏风险。

原理流程

  1. 确认 APP_DEBUG 处于开启状态。
  2. 在 config/trace.php 中选择 Trace 记录方式(页面/日志/关闭,以版本为准)。
  3. 请求处理过程中框架把 SQL、日志等写入 Trace 数据。
  4. 开发时查看 Trace 定位问题,生产切换为关闭。

代码或图示

// config/trace.php 结构示意,实际配置键名以当前版本手册核对
return [
    'type' => 'html',
    'enable' => true,
];

常见误区

  • 生产环境保留 Trace 开启:暴露 SQL、路径与内部变量。
  • 把 Trace 数据当业务日志使用:Trace 面向调试,持久化日志应走 Log 组件。

追问

  • 如何核对 Trace 配置项?答:阅读当前版本 config/trace.php 默认注释与官方 Trace 文档,逐项确认键名与取值。
  • SQL 日志在哪里看?答:调试模式下可通过 Trace 或数据库日志配置查看,生产按需关闭慢 SQL 之外的明细记录。

06.5.2.1-020 框架扩展点有哪些,为什么不能改 vendor 内核?

一句话结论

官方扩展点包括服务类、容器绑定、中间件、路由、事件监听器、门面、验证器与自定义驱动;升级时不应修改 vendor 与框架内核文件,自定义逻辑挂在扩展点上以保证可升级。

概念解释

vendor 由 Composer 管理,升级会被覆盖。面向契约/扩展点编程,替换实现只改容器绑定或配置,业务代码不依赖内核内部方法。

原理流程

  1. 识别需求属于哪类横切或扩展能力(绑定、拦截、监听、渲染等)。
  2. 选择对应扩展点实现,不复制粘贴内核代码修改。
  3. 通过容器绑定或配置把自定义实现接入框架。
  4. 框架升级时内核文件随 Composer 更新,自定义代码保留在 app/extend。

代码或图示

// 面向契约替换实现的思路:容器绑定接口到自定义类
return [
    \app\contract\NotifierInterface::class => \app\service\SmsNotifier::class,
];

常见误区

  • 直接改 vendor/topthink 源码打补丁:升级被覆盖,补丁难以维护。
  • 业务代码调用框架类内部私有方法:版本升级即断裂。

追问

  • 如何替换框架默认实现?答:在容器中把契约/类名绑定到自定义实现,消费方依赖抽象。
  • 框架有哪些契约接口?答:缓存、Session、日志等组件提供 contract 接口,自定义驱动实现对应接口即可接入。