README

MySQL模式差异 - 比较和迁移脚本生成

为什么不使用MySQL实用工具中的mysqldiff呢？

MySQL实用工具包括一个类似的工具mysqldiff，但非常糟糕！本项目旨在提供一个简单易用、可靠且快速的工具。

安装

要安装PHP MySQL Diff，请安装Composer并执行以下命令

$ ./composer.phar global require camcima/php-mysql-diff

然后，确保~/.composer/vendor/bin已在您的PATH中，您就可以开始了

export PATH="$PATH:$HOME/.composer/vendor/bin"

更新

您可以通过以下命令更新PHP MySQL Diff

$ ./composer.phar global update camcima/php-mysql-diff

使用方法

数据库创建脚本

PHP MySQL Diff与MySQL发行版中的mysqldump创建的数据库创建脚本一起工作。要生成数据库创建脚本，请使用以下命令

$ mysqldump -h hostname -u username -p -d dbname > outputfile.sql

此工具可能无法处理由其他方式生成的创建脚本，因为它依赖于精确调整的正则表达式，如果文件格式不同则可能无法工作。

我选择使用数据库创建脚本而不是直接连接到数据库，因为这更便携，您也可以离线工作。未来，我可能会开发直接从数据库的INFORMATION_SCHEMA表获取信息的选项。

差异

$ php-mysql-diff diff <from> <to> [-i <ignore-tables-file>]

其中from是初始数据库创建脚本的路径，to是目标数据库创建脚本的路径。

忽略表

使用-i选项在比较过程中忽略表。文件格式是一系列正则表达式，用于匹配要忽略的表名，每行一个。

示例

/^employee.+/
/^catalog$/
/^test[\d]$/

输出文件

输出将如下所示

PHP MySQL Diff 1.0.0
----------------------------------------

• Parsing initial database ...... ✓
• Parsing target database ....... ✓
• Comparing databases ........... ✓

FROM tests\fixtures\sakila.sql
  TO tests\fixtures\sakila_new.sql

▲ table "test3" is in the TO database but not in the FROM database
▼ table "test1" is in the FROM database but not in the TO database
► table "test2" has a different schema
    ▲ column "new_field" is in the TO database but not in the FROM database
    ► column "id" has a different definition
        FROM `id` int(11) NOT NULL AUTO_INCREMENT
          TO `id` int(10) NOT NULL AUTO_INCREMENT
    ► column "fk" has a different definition
        FROM `fk` int(10) NOT NULL
          TO `fk` int(10)
    ► column "val" has a different definition
        FROM `val` decimal(10,2) NOT NULL
          TO `val` decimal(11,3) NOT NULL
    ► column "texto" has a different definition
        FROM `texto` varchar(60) DEFAULT NULL
          TO `texto` char(60) NOT NULL DEFAULT 'default'
    ► primary key has a different definition
        FROM PRIMARY KEY (`id`)
          TO PRIMARY KEY (`id`,`new_field`)
    ▲ foreign key "FK__test3" is in the TO database but not in the FROM database
    ▼ foreign key "FK__test1" is in the FROM database but not in the TO database
    ► index "FK__test1" has a different definition
        FROM KEY `FK__test1` (`fk`)
          TO UNIQUE KEY `FK__test1` (`datade`)

Diff completed!

▲ = 仅在TO数据库中存在

► = FROM和TO数据库中的定义不同

▼ = 仅在FROM数据库中存在

迁移脚本

$ php-mysql-diff migrate <from> <to> [-o <output-file>] [-i <ignore-tables-file>] [-p]

其中from是初始数据库创建脚本的路径，to是目标数据库创建脚本的路径。

忽略表

使用-i选项在比较过程中忽略表。文件格式是一系列正则表达式，用于匹配要忽略的表名，每行一个。

示例

/^employee.+/
/^catalog$/
/^test[\d]$/

输出文件

如果不使用-o选项，迁移脚本将输出到stdout。

输出（使用-o选项）将如下所示

PHP MySQL Diff 1.0.0
----------------------------------------

• Parsing initial database ...... ✓
• Parsing target database ....... ✓
• Comparing databases ........... ✓
• Generating migration script ... ✓
• Writing output file ........... ✓

Migration script generated!

迁移脚本将如下所示

# Disable Foreign Keys Check
SET FOREIGN_KEY_CHECKS = 0;
SET SQL_MODE = '';

# Deleted Tables

-- deleted table `test1`

DROP TABLE `test1`;

# Changed Tables

-- changed table `test2`

ALTER TABLE `test2`
  DROP PRIMARY KEY,
  DROP FOREIGN KEY `FK__test1`,
  DROP INDEX `FK__test1`,
  CHANGE COLUMN `id` `id` int(10) NOT NULL AUTO_INCREMENT FIRST,
  CHANGE COLUMN `fk` `fk` int(10) AFTER `id`,
  CHANGE COLUMN `val` `val` decimal(11,3) NOT NULL AFTER `fk`,
  CHANGE COLUMN `texto` `texto` char(60) NOT NULL DEFAULT 'default' AFTER `val`,
  ADD COLUMN `new_field` int(10) AFTER `datade`,
  ADD PRIMARY KEY (`id`,`new_field`),
  ADD UNIQUE KEY `FK__test1` (`datade`),
  ADD CONSTRAINT `FK__test3` FOREIGN KEY (`fk`) REFERENCES `test3` (`id`);

# New Tables

-- new table `test3`

CREATE TABLE `test3` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

# Disable Foreign Keys Check
SET FOREIGN_KEY_CHECKS = 1;

显示进度

对于长时间运行的迁移，建议使用-p选项来显示迁移的进度。

贡献

请随时通过PR发送您的贡献。请确保更新/编写新的测试以支持您的贡献。请遵循PSR-2。