README

一个小型库，可用于数据库迁移。

警告：此库尚未完全测试，处于开发阶段。请在使用时考虑此信息。

需求

• PHP 7.4 或更高版本
• PHP PDO 扩展
• PHP JSON 扩展
• InitPHP 控制台库

安装

composer require initphp/barbarian

使用

首先为迁移类创建一个目录。

例如，让您的当前目录为 /Migrations/。

一个示例迁移类如下所示；

<?php
declare(strict_types=1);

namespace App\Migrations;

use InitPHP\Barbarian\QueryInterface;

class Migration_20220718152243 extends \InitPHP\Barbarian\MigrationAbstract
{

    public function up(QueryInterface $query) : bool
    {
        $query->query("CREATE TABLE IF NOT EXISTS `users` (
                    `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT,
                    `name` varchar(255) NOT NULL,
                    `mail` varchar(255) NOT NULL,
                    `status` tinyint(1) NOT NULL DEFAULT 1,
                    PRIMARY KEY (`id`)
                    ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4;");
        return true;
    }
    
    public function down(QueryInterface $query) : bool
    {
        $query->query("DROP TABLE `users`");
        return true;
    }
    
}

在您的 PHP 代码中使用

require_once "vendor/autoload.php";

$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", "root", "");

$migration = new \InitPHP\Barbarian\Migrations($pdo, __DIR__ . '/Migrations/', [
    'migrationTable'    => 'migrations_versions',
    'namespace'         => '\\App\\Migrations\\' // If you are not using namespace, define NULL.
]);


// Runs the up() method of a migration object.
$migration->upMigration(new \App\Migrations\Migration_20221230153013());

// Runs the down() method of a migration object.
$migration->upMigration(new \App\Migrations\Migration_20221230153013());

使用基本 CLI

要使用 CLI 接口，首先在您的当前目录中创建 "barbarian.json" 文件，并按照您的需求编辑以下结构。

{
  "dsn":"mysql:host=localhost;dbname=test;charset=utf8mb4",
  "username":"root",
  "password":"",
  "folder":"C:\\xampp\\Projects\\App\\Migrations\\",
  "table_name":"migrations_versions",
  "namespace":null
}

或者，您可以使用以下命令尝试创建此文件。

vendor/bin/barbarian json

您可以使用以下命令创建一个新的迁移类。

vendor/bin/barbarian create

您可以使用以下命令升级所有迁移。

vendor/bin/barbarian up

您可以使用 -version 标志仅升级一个迁移。

vendor/bin/barbarian up -version=20221230153013

或

vendor/bin/barbarian up -version=Migration_20221230153013

您可以使用以下命令降级所有迁移。

vendor/bin/barbarian down

您可以使用 -version 标志仅升级一个迁移。

vendor/bin/barbarian down -version=20221230153013

或

vendor/bin/barbarian down -version=Migration_20221230153013

致谢

• Muhammet ŞAFAK <info@muhammetsafak.com.tr>

许可证

版权所有 © 2022 MIT 许可证