简单介绍
原生php一般用的最多的迁移工具应该是phinx
,它出现的时间特别久,github仓库star也是最多的
还有一个和它类似的是 phoneix
如果你很不喜欢phinx则可以试试它
phinx的初始化
如果是0.11.x版本的话默认生成的是yaml 使用下面方法则可以初始化成phinx.php
文件
0.12.x则是初始化默认就是 phinx.php
F:\wamp\www\tp51>vendor\bin\phinx init --format php
--format yaml, yml, json, or php
0.11.x默认配置文件
<?php
return
[
'paths' => [
'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
],
'environments' => [
'default_migration_table' => 'phinxlog',
'default_database' => 'development',
'production' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'production_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8',
],
'development' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'development_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8',
],
'testing' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'testing_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8',
]
],
'version_order' => 'creation'
];
0.12.x默认配置文件
<?php
return
[
'paths' => [
'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
],
'environments' => [
'default_migration_table' => 'phinxlog',
'default_environment' => 'development',
'production' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'production_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8',
],
'development' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'development_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8',
],
'testing' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'testing_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8',
]
],
'version_order' => 'creation'
];
简单使用
本扩展与官方的区别是什么?
支持最新的phinx扩展,直接composer更新而不是固定死版本
为什么不直接使用phinx包?因为使用命令需要vendor\bin\phinx
,还有配置文件也要自定义,本扩展已支持加载tp的数据库配置
由于tp内置的命令行选项是2个-
的,所以我们的命令都会成 php think migrate:run --e dev
这样子的选项
补充:
- 官方的数据库迁移工具也是基于phinx进行改造的。
- 在windows和linux平台的使用上还有些许区别,否则就会报错
- 如果是thinkphp5.1要使用官方拓展的话,默认是会报错的😅
- 官方到现在还不修复,只修复了最新版中的问题但是只有thinkphp6.0才能使用最新的版本😨
- 该库是为了解决以上问题
要求
thinkphp5.1维护了几十个小版本,用起来非常稳定,还兼容php8,目前还是可以一战的
- 要求ThinkPHP 5.1.*
优化
- 安装即可使用,无需配置
- 自动创建迁移目录
- 支持完全自定义配置(如迁移目录路径等)
- 默认模板上添加示例
安装
composer require gztrljh/thinkphp-migration
Config 配置文件
默认使用的使用的是开发development
环境
如需多个环境可以在框架config
目录下
自行创建migration.php
进行自定义配置
<?php
return
[
'paths' => [
'migrations' => '%%PHINX_CONFIG_DIR%%/db/migrations',
'seeds' => '%%PHINX_CONFIG_DIR%%/db/seeds'
],
'environments' => [
'default_migration_table' => 'phinxlog',
'default_database' => 'development',
'production' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'production_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8mb4',
],
'development' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'development_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8mb4',
],
'testing' => [
'adapter' => 'mysql',
'host' => 'localhost',
'name' => 'testing_db',
'user' => 'root',
'pass' => '',
'port' => '3306',
'charset' => 'utf8mb4',
]
],
'version_order' => 'creation'
];
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 UserMigration
默认模板
<?php
use Phinx\Migration\AbstractMigration;
class UserMigration extends AbstractMigration
{
//表名
protected $table = 'user';
/**
* Migrate Up.
*/
public function up()
{
$this->execute(
"create table {$this->getPrefix()}{$this->table}
(
id int not null auto_increment primary key,
username varchar(10) comment '用户名',
password varchar(32) comment '密码',
phone varchar(11) comment '注册手机号',
email varchar(50) unique comment '邮箱',
last_login_ip char (15) comment '最后登录IP地址',
last_login_time timestamp null comment '最后登录的时间',
active tinyint not null default 0 comment '激活状态 0:未激活 1:激活',
create_time timestamp null comment '创建时间',
update_time timestamp null comment '更新时间',
delete_time timestamp null comment '删除时间'
);"
);
}
/**
* Migrate Down.
*/
public function down()
{
$this->execute(
"DROP TABLE {$this->getPrefix()}{$this->table};"
);
}
/**
* @return string 数据表前缀
*/
public function getPrefix()
{
return config('database.prefix');
}
}
个人小建议:不建议使用phinx
中那种方式创建表,就使用原生的sql创建回归初心,还能让自己更熟悉sql不是么😏?所以我很贴心的给你们准备了默认示例
😂😂😂
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
在linux上部署的问题
问题产生,我在windows上开发好后直接上传到linux上进行部署,结果问题产生。
php vendor/bin/phinx migrate
死活就是无法执行,差不多报出如下错误
下图作为参考,因为我忘记截图了,当时
然后我通过git把项目从gitee中拉下来,在用composer install执行一下就好了。
新的问题产生
然后我去phinx.php项目文件中
把localhost 改成 127.0.0.1就行了。