proklung/wp.migrations

适配 Arrilot 数据库迁移到 WordPress。

1.0.5 2021-08-07 20:03 UTC

This package is auto-updated.

Last update: 2024-09-08 02:35:51 UTC


README

原始包 - https://github.com/arrilot/bitrix-migrations

安装

  1. composer require proklung/wp.migrations

  2. cp vendor/proklung/wp-migrations/migrator bin/migrator - 将可执行文件复制到方便的位置。

  3. 进入并确认设置了正确 $_SERVER['DOCUMENT_ROOT']。如果需要,请更改设置。

  4. php migrator install

该命令将在数据库中创建一个用于存储已执行迁移名称的表。

默认情况下

  1. 表名为 wp_arrilot_migrations。

  2. composer.json 位于网站根目录,migrator 位于 /bin。

  3. 迁移文件将创建在相对于网站根目录的 ./app/arrilot_migrations 目录。

如果需要,所有这些都可以在复制的 migrator 文件中进行更改。

使用

工作流程

工作流程通过控制台进行,简要描述如下

  1. 使用 php migrator make 名称_迁移 创建迁移文件(或文件)

迁移文件是一个具有两个方法 up()down() 的类

  1. up() 方法中实现对数据库的必要更改。如果愿意,可以在 down() 方法中实现这些更改的回滚

  2. 应用现有迁移 - php migrator migrate

  3. 将迁移文件添加到版本控制系统,以便可以在其他机器上运行

可用的命令

可以在控制台获得可用的命令列表 - php bin/migrator list

迁移模板

由于通过 Bitrix API 修改数据库结构是一项非常繁琐的工作,因此存在一个迁移模板机制,其工作方式如下:在生成迁移文件时,可以指定其模板:php migrator make 名称_迁移 -t add_iblock 其中 add_block 是模板名称。这将生成一个具有模板的样板类,然后只需指定细节(例如名称和代码块)即可。可以直接在 migrator 文件中添加自己的迁移模板,使用 TemplateCollection::registerTemplate()

现有模板

  1. php migrator status - 显示可用的迁移以及最后执行的迁移。