PHPmig 安装与配置指南

项目基础介绍

Phpmig 是一个针对 PHP 项目的数据库迁移工具。它旨在与多种 PHP 5.3+ 项目兼容，提供一个类似 doctrine 迁移工具的功能，但不需要依赖于 doctrine。Phpmig 的设计理念是框架无关，因此在使用之前需要进行一些基本设置。

主要编程语言

Phpmig 主要使用 PHP 编程语言开发。

项目使用的关键技术和框架

• PDO（PHP Data Objects）：用于数据库访问的扩展。
• Pimple：一个简单的依赖注入容器，用于服务管理。
• Doctrine DBAL（可选）：一个数据库抽象层，用于数据库操作。

项目安装和配置准备工作

在开始安装 Phpmig 之前，请确保您的环境满足以下要求：

1. 安装了 PHP 5.3 或更高版本。
2. 安装了 Composer，这是一个 PHP 的依赖管理工具。
3. 确保您的服务器可以连接到数据库。

安装步骤

步骤 1：安装 Composer

如果您的系统还没有安装 Composer，请先执行以下命令进行安装：

curl -sS https://getcomposer.org/installer | php

步骤 2：安装 Phpmig

使用 Composer 安装 Phpmig：

php composer.phar require davedevelopment/phpmig

步骤 3：初始化项目

在您的项目根目录下执行以下命令来初始化 Phpmig：

phpmig init

这个命令将创建两个文件：

• ./migrations：这是放置迁移文件的地方。
• ./phpmig.php：这是配置文件，用于设置数据库连接和迁移适配器。

步骤 4：配置数据库连接

编辑 ./phpmig.php 文件来设置您的数据库连接。以下是一个示例配置，使用 PDO 连接 MySQL 数据库：

<?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;

确保替换 'mysql:dbname=testdb;host=127.0.0.1', 'username', 'passwd' 为您自己的数据库连接信息。

步骤 5：创建迁移文件

使用以下命令创建一个新的迁移文件：

phpmig generate AddFeatureToTable

这将生成一个名为 VERSION_AddFeatureToTable.php 的迁移文件，其中 VERSION 是当前时间戳。

步骤 6：运行迁移

执行以下命令来运行迁移：

phpmig migrate

这将执行所有尚未运行的迁移。

步骤 7：检查迁移状态

您可以随时检查迁移的状态：

phpmig status

以上就是 Phpmig 的详细安装和配置指南。按照这些步骤操作后，您应该能够成功地在您的 PHP 项目中开始使用数据库迁移功能。