在 thinkphp 8.0 中需手动集成 phinx 实现数据库迁移：安装 think-phinx 扩展，执行 phinx:init 生成配置，严格将迁移文件置于 database/migrations/ 下并仅使用 change() 方法，注册 \think\phing\command 命令后运行 phinx:migrate 完成建表。
在 ThinkPHP 8.0 中为新项目初始化数据库结构，必须绕过已移除的内置迁移机制，手动集成 Phinx 并严格遵循其路径、命名与方法规范，否则迁移命令根本不会识别文件或静默跳过执行。
安装并初始化 think-phinx
执行 composer require topthink/think-phinx 安装官方兼容扩展——【不是 topthink/think-migration】，后者在 TP8 中完全失效且会报 Class not found。
运行 php think phinx:init 生成 phinx.php 配置文件，它会自动读取 config/database.php 中的连接参数。
打开 phinx.php，确认 'paths' => ['migrations' => 'database/migrations'] 这一行存在且路径未被修改——TP8 强制要求迁移文件只能放在 database/migrations/ 下，放错位置将导致 “No migrations to run”。
创建迁移文件并定义建表逻辑
使用命令 php think phinx:create CreateUsersTable，它会在 database/migrations/ 下生成类似 20260707120000_create_users_table.php 的文件。
编辑该文件，删掉默认的 up() 和 down() 方法，只保留 change()：
public function change(): void {
$this->table('users')
->addColumn('id', 'biginteger', ['identity' => true, 'primary_key' => true])
->addColumn('name', 'string', ['limit' => 50])
->addColumn('email', 'string', ['limit' => 100, 'null' => false])
->addColumn('created_at', 'datetime')
->addColumn('updated_at', 'datetime', ['null' => true])
->create();
}
这一步不能写 up() 或 down()——TP8 的 think-phinx 集成默认禁用这两个方法，只识别 change()；写错会导致迁移完全不执行，控制台无报错也无建表动作。
注册命令并执行迁移
若执行 php think list 看不到 phinx:migrate 命令，说明命令类未注册。打开 config/console.php，在 'commands' 数组中追加：'\think\phing\Command::class'。
确保数据库服务可连通，再运行：php think phinx:migrate
如果提示 Command "phinx:migrate" is not defined，请检查是否拼错类名（注意是 \think\phing\Command，不是 \think\phinx\Command）——这是常见手误点。
迁移成功后，think_migration 表中会新增一条记录，对应文件名前缀（如 20260707120000），同时数据库中出现 users 表。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
