PHP数据库迁移工具使用-php教程-PHP中文网

php无内置数据库迁移功能，必须依赖phinx或laravel migrations等外部工具；phinx仅读取phinx.yml（yaml格式），host需按环境设为localhost或docker容器名，laravel migrations可单独使用但需手动构建migrator并注意功能限制。

php数据库迁移工具使用

PHP 本身没有内置数据库迁移能力，必须依赖外部工具；生产环境只推荐 Phinx 或 Laravel Migrations（即使不用 Laravel 框架也能单独用），其他自写脚本或纯 SQL 文件管理方式在回滚、协作、状态追踪上会快速失控。

常见现象是执行 php vendor/bin/phinx migrate 报 Connection refused 或连错库，根本原因不是密码错误，而是配置没被读到。

Phinx 只认 phinx.yml（YAML 格式），不读 phinx.php 或任何 PHP 配置文件，除非显式用 -c 参数指定
环境名必须全小写：development、production，写成 Development 会被忽略
MySQL 的 host 在本地开发别写 127.0.0.1，改用 localhost；Docker 环境则必须填容器名（如 mysql），不能填 localhost（容器内它指向自己）
确认 phinx.yml 里 adapter 值是 mysql、pgsql 或 sqlite，拼错（如写成 mysql5）会导致驱动加载失败

可以，但要手动补全底层依赖，不是装个包就能跑命令。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先装包：composer require illuminate/database
手动创建 PDO 实例，并传给 Illuminate\Database\Connectors\ConnectionFactory 构造连接
用该连接实例化 Illuminate\Database\Migrations\Migrator，再调用 run() 或 rollback()
迁移文件仍放 database/migrations/，类必须继承 Illuminate\Database\Migrations\Migration，且 up() 方法参数类型为 Blueprint
注意：不支持 php artisan migrate:status 这类命令行功能，所有操作需自行封装 CLI 入口

这不是命令输错了，是扩展没装或没注册进命令系统。

运行 composer require topthink/think-migration:^3.0（TP6.1+ 必须用 ^3.0）
检查 config/console.php 中 'commands' 数组是否包含 \think\migration\Command::class；若无，手动添加
执行 php think list，确认输出里有 migrate:install、migrate:run 等条目；没有就说明注册失败
如果之前删过 runtime/cache/ 目录，记得清空它——TP 会缓存命令注册状态，旧缓存可能让新注册不生效

这不是工具 bug，是你没写或没写对 down() 逻辑。Phinx 和 ThinkPHP 都不会自动推断逆向操作。

如果 up() 里调用了 $this->table('user')->addColumn('phone')，down() 就必须显式写 $this->table('user')->dropColumn('phone')
MySQL 5.7+ 的 MyISAM 引擎不支持 DROP COLUMN，执行会静默失败；换成 InnoDB 引擎或改用原生 SQL + ALTER TABLE ... DROP COLUMN（确认版本支持）
ThinkPHP 中避免用 Db::insert() 在 up() 填数据——回滚时不会删，结构和数据就脱节了；这类操作应交给 Seeder 单独管理
本地调试务必用 php vendor/bin/phinx rollback --target=20240501000000 或 php think migrate:rollback --step=1 单步验证，别等上线才发现 down() 是空壳