traackr/sql-migration

此包的最新版本(0.6)没有可用的许可信息。

CakePHP 的 SQL 迁移插件

0.6 2022-02-17 22:45 UTC

This package is auto-updated.

Last update: 2024-09-04 18:42:18 UTC


README

简介

这是一个用于管理数据库模式更新的 CakePHP 插件

安装

要安装此插件,您可以

  • 在 GitHub 上克隆项目:https://github.com/Traackr/cakephp-sqlmigration。请确保将其克隆到您的 app/Plugin 目录中,最好在名为 SqlMigration 的目录中
  • 使用 Composer 将此插件作为依赖项管理。为此,只需将其添加到您的 composer.json 文件中
"minimum-stability": "dev",
"require": {
   "traackr/sql-migration": "dev-master"
}

需求

所有升级脚本都是 SQL 脚本,并且通过 mysql 执行,因此您想使用的 mysql 可执行文件必须在您的路径中,以便插件可以工作。

设置

此插件使用一个数据库表(schema_versions)来跟踪模式升级。要开始,您需要设置插件,它将为您创建该表。一旦插件安装完成,只需在您的 app 目录中执行以下操作

Console/cake SqlMigration.SqlMigration setup

运行此命令多次是安全的。在后续调用中,该命令将尝试对 schema_versions 表应用任何更改(这可能发生在您升级到此插件的新版本时)。

升级脚本

升级脚本简单的 SQL 脚本,需要位于以下目录:app/Config/Sql。脚本名称必须遵循以下命名约定:upgrade-.sql

运行升级

要运行模式上的升级脚本,只需调用

Console/cake SqlMigration.SqlMigration

SqlMigration 插件将运行尚未应用的所有升级脚本(基于 schema-versions 表中找到的信息)。版本号不必连续(例如,您可以跳过一些版本),插件将按顺序应用脚本并跳过缺失的版本。如果您后来为任何缺失的版本添加了新的升级脚本(例如,在分支中创建并后来与主核心合并),则这些脚本将在您下次运行插件时应用(即它将尝试填补差距)。