milkme/thinkphp-migration

该包最新版本(1.0.0)没有提供许可证信息。

ThinkPHP6.0.x 的数据库迁移工具

1.0.0 2019-12-19 02:22 UTC

This package is auto-updated.

Last update: 2024-09-19 12:30:11 UTC


README

ke/thinkphp-migration 适配ThinkPHP6.0

需要ThinkPHP 6.0。*

本扩展与官方的区别是什么?

支持最新的 phinx 扩展,直接使用 composer 更新而不是固定版本

为什么不直接使用 phinx 包?因为需要使用 vendor\bin\phinx,还有配置文件也需要自定义,本扩展已支持加载 tp 的数据库配置

由于 tp 内置的命令行选项是两个连字符的,所以我们的命令都会是 php think migrate:run --e dev 这样的选项

安装

composer require milkme/thinkphp-migration

Config 配置文件

<?php
// /config/migration.php

use think\facade\Env;
return [
    'environments'  =>  [
        'default_migration_table'   =>  'phinxlog',
        'default_database'          =>  'default',
        'default'   =>  [
            'adapter'       =>  Env::get('database.type', 'mysql'),
            'host'          =>  Env::get('database.hostname', '127.0.0.1'),
            'name'          =>  Env::get('database.database', ''),
            'user'          =>  Env::get('database.username', ''),
            'pass'          =>  Env::get('database.password', ''),
            'table_prefix'  =>  '',
            'port'          =>  Env::get('database.port', '3306'),
            'charset'       =>  'utf8mb4',
            'collation'     =>  'utf8mb4_unicode_ci'
        ] ,
    ]
];

注册服务

<?php
//app/service.php

return [
    'milkme\phinx\MigrationService' ,
] ;

Breakpoint 命令

Breakpoint 命令用来设置断点,可以对回滚进行限制。可以不带参数调用 breakpoint 命令,也就是断点设在最新的迁移脚本上

php think migrate:breakpoint --e development

可以使用 --t 来指定断点打到哪个迁移版本上

php think migrate:breakpoint --e development --t 20120103083322

可以使用 --r 来移除所有断点

php think migrate:breakpoint --e development --r

运行 status 命令时可以看到断点信息

Create 命令

create 命令用来创建迁移脚本文件。需要一个参数:脚本名。迁移脚本命名应该保持驼峰命名法

php think migrate:create MyNewMigration

Run 命令

Run 命令默认运行执行所有脚本,可选指定环境

php think migrate:run --e development

可以使用 --t 来指定执行某个迁移脚本

php think migrate:run --e development --t 20110103081132

Rollback 命令

Rollback 命令用来回滚之前的迁移脚本。与 Run 命令相反。可以使用 rollback 命令回滚上一个迁移脚本。不带任何参数

php think migrate:rollback --e development

使用 --t 回滚指定版本迁移脚本

php think migrate:rollback --e development --t 20120103083322

如果指定版本设置为0则回滚所有脚本

php think migrate:rollback --e development --t 0

可以使用 --d 参数回滚指定日期的脚本

php think migrate:rollback --e development --d 2012
php think migrate:rollback --e development --d 201201
php think migrate:rollback --e development --d 20120103
php think migrate:rollback --e development --d 2012010312
php think migrate:rollback --e development --d 201201031205
php think migrate:rollback ---e development --d 20120103120530

创建 Seed 类

与数据库迁移不同,Phinx 并不记录 seed 是否执行过。这意味着 seeders 可以被重复执行。请在开发时记住

Phinx 使用以下命令创建一个新的 seed 类

php think seed:create UserSeeder

执行 Seed

这很简单,当注入数据库时,只需要运行 seed:run 命令

php think seed:run

默认 Phinx 会执行所有 seed。如果想要指定执行一个,只需增加 --s 参数并接上 seed 的名字

php think seed:run --s UserSeeder