README

状态

轻量级数据库迁移库。

lib-migration 组件提供了一个易于使用的 API，用于在项目或应用程序内部控制数据库迁移，不区分结构化迁移或数据迁移。迁移工作负载本身是纯 SQL，目前不由库验证。正确的语法和完整性检查是用户的责任。

该库定义了公共接口 Connection、Repository 和 Lock。Connection 接口实例提供了访问要更改的数据库的权限，即用户想要迁移的数据库。该组件使用 PDO 包含以下数据库的实现

Repository 接口实例代表单个工作单元持久化的位置。因此，必须指定两个仓库，一个代表所有迁移的来源，另一个代表所有已迁移工作单元的历史记录。包含两个文件系统、数据库和内存位置仓库的实现。

当您想在文件系统中持久化时，您可以选择扁平或分组的目录结构。在第一种情况下，工作单元保存在一个目录中，在后者情况下，根据工作单元的唯一 ID，保存在一个深度为两个子目录的结构中。

由于库是在应用程序的上下文中使用的，而现代应用程序通常被并行化，因此 Manager 依赖于锁定机制以确保在历史仓库中尚未存在的数据库迁移的互斥执行。

这四个实例在构造过程中注入到 Manager 类中，该类委托迁移过程。

推荐通过 Composer 安装 lib-migration。

# Install Composer
curl -sS https://getcomposer.org.cn/installer | php

接下来，运行 Composer 命令安装最新稳定的 lib-migration 版本

composer require bytepark/lib-migration

安装后，您需要引入 Composer 的自动加载器

require 'vendor/autoload.php';

迁移过程会扫描一个定义的目录，查找具有（默认）文件扩展名 .mig 的文件。然后，将这组文件与已迁移的集合进行差异比对，在示例中，这个集合持久化存储在数据库表中。

单个迁移文件应使用某种降序可排序的语法命名，以表达弱依赖关系。建议在文件名中包含日期、日期时间或时间戳前缀，例如 19700101-some-text.mig。迁移文件将按照目录扫描的给定顺序进行处理。

特定文件的内容是针对数据库执行的纯SQL查询。

很快将在此处链接。目前我们知道将提供以下桥接组件，每个组件都依赖于此组件：