TP8 命令行重构为显式注册、入口移至 app/command.php、内置命令大幅精简、参数需强类型声明、CLI 功能须通过 CommandRegister 接口或手动绑定。

ThinkPHP 6.1.5 迁移到 8.0 后，命令行指令（php think）发生了结构性变化：核心命令不再内置、部分功能移出框架、新增 CLI 生命周期控制机制。迁移不是“改几个参数”，而是重配命令入口与执行逻辑。

think 命令入口逻辑重构

TP8 不再通过 thinkphp/console.php 启动命令行，而是统一由 app/command.php 驱动，且默认不自动注册任何命令——所有命令需显式声明。

• 删除旧版 app/command.php 中的全局 Command::all() 自动扫描逻辑
• 新建 app/command.php，按 TP8 规范返回命令类数组，例如：
  return [
  app\command\Install::class,
  app\command\Clear::class,
];
• 自定义命令类必须继承 think\command\Command（非 TP6 的 think\Console\Command）

常用内置命令已移除或重命名

TP8 移除了多个 TP6 中默认可用的命令，避免隐式依赖和职责混淆。关键变更如下：

PHP 8.5.12 RC 1

PHP 8.5.12 RC 1 候选版修复 BZ2、DOM、PDO、Opcache/JIT 和扩展内存安全问题，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

• php think optimize:autoload → 已废弃，直接使用 composer dump-autoload -o
• php think build → 完全移除，模块/控制器生成需自行实现或借助第三方扩展（如 topthink/think-skeleton）
• php think migrate:run → 不再内置，需手动引入 topthink/think-migration 并在 app/command.php 中注册其命令类
• php think vendor:publish → 替换为更明确的 php think publish:config 或 php think publish:assets（取决于扩展是否适配 TP8 provider 机制）

命令参数与选项语法升级

TP8 全面支持 PHP 8 命名参数与类型提示，命令定义需同步更新，否则 CLI 解析失败或静默忽略参数。

立即学习“PHP免费学习笔记（深入）”；

• 命令类的 configure() 方法中，->addOption() 必须显式声明类型，例如：
  $this->addOption('force', 'f', Option::VALUE_NONE, 'Force overwrite');
• 接收参数时，推荐使用命名参数方式获取：
  $force = $input->getOption('force');（而非旧版 $input->getArgument(0) 模糊索引）
• 验证逻辑前移：TP8 要求在 execute() 开头调用 $this->validateInput($input)，否则可能跳过类型校验

服务提供者需显式绑定 CLI 功能

若项目依赖自定义命令（如数据库备份、定时任务触发），不能仅靠 app/provider.php 注册服务，还需确保其 CLI 相关能力被加载：

• 在 app/provider.php 中返回的服务提供者类，需实现 think\contract\CommandRegister 接口
• 或在服务提供者 register() 方法中手动调用：
  $this->app->bind('think\command\Build', app\command\Build::class);
• 执行 php think list 后应能清晰看到你注册的命令，无输出即未生效