PHPmig 使用教程

1. 项目的目录结构及介绍

phpmig 是一个 PHP 编写的简单迁移工具，用于数据库版本控制。项目的目录结构如下：

.
├── bin/                       # 存放可执行脚本
├── migrations/                # 存放迁移文件
├── src/                       # 包含 Phpmig 核心代码
│   └── Phpmig/
├── tests/                     # 单元测试文件
├── .gitignore                 # 指定 Git 忽略的文件
├── .travis.yml                # Travis CI 配置文件
├── CHANGELOG.md               # 更新日志
├── LICENCE                    # 项目许可证
├── README.md                  # 项目说明文件
├── composer.json              # Composer 配置文件
└── phpunit.xml.dist           # PHPUnit 配置文件

• bin/: 包含 phpmig 命令行工具。
• migrations/: 存放所有的迁移脚本文件。
• src/: 包含 phpmig 的 PHP 类和库。
• tests/: 包含用于测试 phpmig 功能的测试代码。
• .gitignore: 指定 git 应该忽略的文件和目录。
• .travis.yml: 用于配置 Travis CI 的持续集成服务。
• CHANGELOG.md: 记录了 phpmig 的所有更新和变更历史。
• LICENCE: 项目使用的许可证信息。
• README.md: 项目的自述文件，包含项目的描述、使用方法和安装步骤。
• composer.json: PHP 的依赖管理器 Composer 的配置文件。
• phpunit.xml.dist: PHPUnit 测试框架的配置文件。

2. 项目的启动文件介绍

phpmig 的启动和配置主要通过 bin/phpmig 脚本进行。当运行此脚本时，它将执行以下步骤：

1. 检查环境，确保所有必需的 PHP 扩展已经安装。
2. 加载项目依赖，通常通过 composer install 命令完成。
3. 初始化迁移环境，通常通过 phpmig init 命令创建必要的配置文件和迁移目录。

启动脚本通常不需要直接修改，除非你需要自定义 phpmig 的行为。

3. 项目的配置文件介绍

phpmig 的配置文件通常位于项目的根目录中，名为 phpmig.php。此文件定义了迁移工具的行为和数据库连接信息。以下是一个基本的配置文件示例：

<?php
use Phpmig\Adapter;
use Pimple\Container;

$container = new Container();

$container['db'] = function () {
    $dbh = new PDO('mysql:dbname=testdb;host=127.0.0.1', 'username', 'passwd');
    $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    return $dbh;
};

$container['phpmig.adapter'] = function ($c) {
    return new Adapter\PDO\Sql($c['db'], 'migrations');
};

$container['phpmig.migrations_path'] = __DIR__ . DIRECTORY_SEPARATOR . 'migrations';

return $container;

在上述配置文件中：

• db 服务定义了如何连接到数据库。
• phpmig.adapter 服务定义了 phpmig 应该如何管理迁移。
• phpmig.migrations_path 设置了迁移文件的存储路径。

根据你的数据库类型和项目需求，你可能需要调整这些配置项。