[Doctrine Migrations] 数据库迁移组件的深入解析一:安装与使用

场景分析

团队开发中,每个开发人员对于数据库都修改都必须手动记录,上线时需要人工整理,运维成本极高。而且在多个开发者之间数据结构同步也是很大的问题。Doctrine Migrations组件把数据库变更加入到代码中和代码一起进行版本管理,很好的解决了上述问题。

Doctrine Migrations是基于Doctrine DBAL组件的数据迁移组件。集成于Laravel,Symfony等主流框架。大概可以分为两种方式进行迁移,即版本管理方式和diff方式。

版本管理:把数据库变更写入到代码中,来进行版本管理。Laravel框架就是版本管理的模式,迁移组件默认的命令行就是支持这种模式。

diff:把现有数据库结构和代码里面的数据库结构来做对比,执行差异的sql以保证一致性。一般需要ORM的支持,Symfony框架就是使用Doctrine2ORM工具加上Doctrine DBAL来进行diff方式的数据迁移。

此系列文章不讨论现有框架中数据迁移组件的使用,而是着重于探讨如何单独使用迁移组件以及如何把数据迁移组件集成到自己的项目、个性化定制

安装

composer安装

composer require doctrine/migrations ~1.8.0

本系列使用的是目前最新的1.8.1版本

配置

安装之后不能直接使用,还需要进行组件配置以及数据库配置:

  1. 根目录下建立migrations.php文件,配置组件:

php return [ ‘name‘ => ‘Doctrine Migrations‘, // 组件显示名称 ‘migrations_namespace‘ => ‘db\migrations‘, // 迁移类的命名空间 ‘table_name‘ => ‘migration_versions‘, // 迁移组件的表名 ‘migrations_directory‘ => ‘db/migrations‘, // 迁移类的文件夹 ];

详情的配置参数参见官方文档

  1. 根目录下简历migrations-db.php文件,配置数据库信息:

php return [ ‘driver‘ => ‘pdo_mysql‘, ‘host‘ => ‘localhost‘, ‘port‘ => 3306, ‘user‘ => ‘root‘, ‘password‘ => ‘1236‘, ‘dbname‘ => ‘migrations‘, ];

到此,组件需要的配置已经完成。

使用

  1. 运行vendor目录下面的命令生成版本迁移类文件。

bash ./vendor/bin/doctrine-migrations migrations:generate

在迁移类目录/db/migrations下面生成Version20180608155932.php类文件,此文件即是用于写入迁移sql的类,Version后面的数字则是当前版本号。

  1. 重写up方法,用于执行迁移sql:

php public function up(Schema $schema): void { $table = $schema->createTable(‘test1‘); $table->addColumn(‘id‘, ‘integer‘)->setUnsigned(true)->setAutoincrement(true); $table->addColumn(‘name‘, ‘string‘)->setDefault(‘‘)->setLength(20); $table->setPrimaryKey([‘id‘]); }

这个脚本是生成一个test1的表。

  1. 重写down方法,用于版本回退,撤销up方法的迁移操作:

php public function down(Schema $schema): void { if ($schema->hasTable(‘test1‘)) { $schema->dropTable(‘test1‘); } }

  1. 执行迁移命令:

bash ./vendor/bin/doctrine-migrations migrations:migrate

这样就成功的创建了一个版本的迁移数据。迁移类脚本可以使用$schema来操作数据库实体,也可以使用$this->addSql()方法来直接写入相关的sql,详细参加官方文档对于脚本编写的详细说明,此处不过多展开。

版本管理

既然迁移使用版本管理,那么多个版本之间可以来回切换。下面是相关的版本切换命令:

./vendor/bin/doctrine-migrations migrations:migrate 20180608161758

这条命令是恢复到20180608161758版本,除了直接输入具体版本号之外,还有更加方便的版本别名:

  • first:回退到初始版本
  • prev:回到上一个版本
  • next:迁移到下一个版本
  • latest:迁移到最新版本(和不加版本号效果一样)

常用命令

# 生成迁移脚本
php migration.php migrations:generate
# 执行迁移到最新版本
php migration.php migrations:migrate
# --dry-run是空转参数,只显示操作结果,不执行修改
php migration.php migrations:migrate --dry-run
# 不执行操作,只写入文件,对于生产环境需要手动验证并执行的场景有用
php migration.php migrations:migrate --write-sql=file.sql
# 查看详细信息
php migration.php status

结语

到此,就学会了migrations组件的基本使用,但是还有如下几个问题需要我们解决:

  1. 一般项目中都会有数据库配置文件,如何让组件公用项目中的配置文件?
  2. 现在迁移组件所需要的配置文件只能在根目录,如何让配置文件更合理的归档?
  3. 命令行又长又难记,如何简单使用命令行?

下一章,我们会解决以上问题,并且让组件更个性化的融入到我们自己的项目中去。

我的代码库可以查看这篇文章的详细代码,欢迎star。

原文地址:https://www.cnblogs.com/tbphp/p/9158719.html

时间: 2024-10-30 23:28:51

[Doctrine Migrations] 数据库迁移组件的深入解析一:安装与使用的相关文章

[Doctrine Migrations] 数据库迁移组件的深入解析四:集成diff方式迁移组件

场景及优势 熟悉Symfony框架之后,深刻感受到框架集成的ORM组件Doctrine2的强大之处,其中附带的数据迁移也十分方便.Doctrine2是使用Doctrine DBAL组件把代码里面的表结构与实际数据库中的表结构进行对比的方式进行数据迁移.这种方式比之前版本管理的方式更加精准也更方便. Symfony框架是自身ORM组件支持,但是很多项目并没有使用其中的ORM功能,或者有自己的ORM组件,又该如何集成diff方式的迁移呢?下面我们就来完成这个任务. 源码解析 在研究组件源码时,发现一

[Doctrine Migrations] 数据库迁移组件的深入解析三:自定义数据字段类型

自定义type 根据官方文档,新建TinyIntType类,集成Type,并重写getName,getSqlDeclaration,convertToPHPValue,getBindingType等方法. TinyIntType.php完整代码: <?php namespace db\types; use Doctrine\DBAL\ParameterType; use Doctrine\DBAL\Platforms\AbstractPlatform; use Doctrine\DBAL\Typ

EFCodeFirst Migrations数据库迁移

EFCodeFirst Migrations数据库迁移 数据库迁移 1.生成数据库 修改类文件PortalContext.cs的静态构造函数,取消当数据库模型发生改变时删除当前数据库重建新数据库的设置. static PortalContext() {  Database.SetInitializer<PortalContext>(null);  }  添加Migrations文件夹,并生成类文件Configuration.cs. namespace Portal.Migrations { 

EF Code First Migrations数据库迁移

http://www.cnblogs.com/libingql/p/3330880.html 1.EF Code First创建数据库 新建控制台应用程序Portal,通过程序包管理器控制台添加EntityFramework. 在程序包管理器控制台中执行以下语句,安装EntityFramework. PM> Install-Package EntityFramework 安装成功后,界面提示如下图: 在新建的Portal控制台应用程序中添加两个实体类,代码结构如下: 其中,类文件PortalCo

【EF】EF Code First Migrations数据库迁移

1.EF Code First创建数据库 新建控制台应用程序Portal,通过程序包管理器控制台添加EntityFramework. 在程序包管理器控制台中执行以下语句,安装EntityFramework. PM> Install-Package EntityFramework 安装成功后,界面提示如下图: 在新建的Portal控制台应用程序中添加两个实体类,代码结构如下: 其中,类文件PortalContext.cs的代码如下: using System; using System.Colle

【EF Code First】Migrations数据库迁移

1,打开工具->NuGet程序管理器->程序包管理器控制台 默认项目中要选择  数据访问上下文类  所在的项目 我的DB是在命名空间CodeFirst.UI下的所以选择CodeFirst.UI 然后执行Enable-Migrations 如果失败,有一种错误是会提醒你未安装XXXX或者缺少XXXX(遇到过一次,错误信息未保留,下次有机会补充), 需要安装 (不知道是什么鬼东西): 去官网上下载安装可以了http://www.microsoft.com/zh-cn/download/detail

数据库迁移

数据库迁移操作 准备环境 web01: 安装lnmp+博客 db01: 安装mysql服务 nfs01: 安装nfs服务 cd /home/oldboy/tools/ scp -rp mysql-5.6.34-linux-glibc2.5-x86_64.tar.gz 172.16.1.51:/home/oldboy/tools/ 第一个里程碑-部署mysql服务(db01) 01.下载解压软件程序 # 解压mysql二进制包软件程序 cd /home/oldboy/tools tar xf my

EF6与MVC5系列(5):使用数据库迁移( Code First Migrations)和发布

本节教程包含以下内容: 启用数据库迁移(Code First Migrations):迁移特性可以改变数据模型,并且不需要删除重建数据库就可以修改数据库架构. 部署在Azure中:这步骤是可选的,可以不发布在Azure中继续学习本教程后面的内容. ps:本文中只翻译Code First Migrations相关内容,有关如何在Azure中发布,可以查看原文:https://www.asp.net/mvc/overview/getting-started/getting-started-with-

2. Code First Migrations With Entity Framework【EF中 Code-First 方式的数据库迁移】

前面的文章中,学习了EF 中的几种关系,一对一,一对多,多对多.但是相信大家肯定会有疑问: 1.我难道每次都要创建数据库么? 2.我怎么样从已经存在的表中,添加字段和移除字段呢? 3.当我向表中,添加字段或者移除字段,我怎么来避免丢失数据呢? 4.当数据库发生改变的时候,我怎么获取到创建数据库的脚本呢? 不用着急,这篇文章,我会向大家一一讲到: 首先,说说我们为什么要使用数据库迁移技术吧,因为我们的实体总是变动地很频繁,在上篇文章中,我们使用了数据库初始化策略来做,也就是每次当数据库不存在的时候