phalcon mysql port_数据库迁移 · Phalcon 3.4中文手册 · 看云

[TOC]

# 数据库迁移

迁移是一种以结构化和有组织的方式更改数据库的便捷方式。

>[danger] Phalcon开发者工具中提供了迁移您至少需要Phalcon Framework 0.5.0才能使用开发人员工具。

通常在开发中，我们需要更新生产环境中的更改。其中一些更改可能是数据库修改，如新字段，新表，删除索引等。

生成迁移时，会创建一组类来描述在特定时刻数据库的结构。这些类可用于同步远程数据库上的模式结构，使您的数据库可以使用应用程序实现的新更改。迁移使用普通PHP描述这些转换。

## 架构转储

[Phalcon开发者工具](https://github.com/phalcon/docs/blob/3.3/zh/devtools-usage.md) 提供了用于管理迁移(生成，运行和回滚)的脚本。

用于生成迁移的可用选项包括：


在没有任何参数的情况下运行此脚本只会将数据库中的每个对象(表和视图)转储到迁移类中。

每个迁移都有一个与之关联的版本标识符。版本号允许我们确定迁移是否比我们数据库的当前“版本”更新或更旧。版本还将在执行迁移时通知Phalcon正在运行的订单。


生成迁移时，控制台上会显示说明，以描述迁移的不同步骤和这些语句的执行时间。最后，生成迁移版本。

默认情况下，Phalcon开发者工具使用`app/migrations`目录转储迁移文件。您可以通过在生成脚本上设置其中一个参数来更改位置。数据库中的每个表都在一个分隔文件中生成其各自的类，该文件位于引用其版本的目录下：


## 迁移类解剖

每个文件都包含一个扩展`Phalcon\Mvc\Model\Migration`类的唯一类。这些类通常有两种方法：`up()`和`down()`。`up()`执行迁移，而`down()`将其回滚。

`up()` 还包含magic方法`morphTable()`。当它识别出将数据库中的实际表与给定描述同步所需的更改时，就会产生魔术方法。

```php

use Phalcon\Db\Column as Column;

use Phalcon\Db\Index as Index;

use Phalcon\Db\Reference as Reference;

use Phalcon\Mvc\Model\Migration;

class ProductsMigration_100 extends Migration

{

public function up()

{

$this->morphTable(

'products',

[

'columns' => [

new Column(

'id',

[

'type' => Column::TYPE_INTEGER,

'size' => 10,

'unsigned' => true,

'notNull' => true,

'autoIncrement' => true,

'first' => true,

]

),

new Column(

'product_types_id',

[

'type' => Column::TYPE_INTEGER,

'size' => 10,

'unsigned' => true,

'notNull' => true,

'after' => 'id',

]

),

new Column(

'name',

[

'type' => Column::TYPE_VARCHAR,

'size' => 70,

'notNull' => true,

'after' => 'product_types_id',

]

),

new Column(

'price',

[

'type' => Column::TYPE_DECIMAL,

'size' => 16,

'scale' => 2,

'notNull' => true,

'after' => 'name',

]

),

],

'indexes' => [

new Index(

'PRIMARY',

[

'id',

]

),

new Index(

'product_types_id',

[

'product_types_id',

]

),

],

'references' => [

new Reference(

'products_ibfk_1',

[

'referencedSchema' => 'invo',

'referencedTable' => 'product_types',

'columns' => ['product_types_id'],

'referencedColumns' => ['id'],

]

),

],

'options' => [

'TABLE_TYPE' => 'BASE TABLE',

'ENGINE' => 'InnoDB',

'TABLE_COLLATION' => 'utf8_general_ci',

],

]

);

}

}

```

该类称为`ProductsMigration_100`。后缀100指的是版本1.0.0。`morphTable()` 接收一个包含4个可能部分的关联数组：

| Index | 描述 | 是否可选 |

| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |:--------:|

| `columns` | 带有一组表列的数组 | No |

| `indexes` | 包含一组表索引的数组。 | Yes |

| `references` |带有一组表引用(外键)的数组。 | Yes |

| `options` | 包含一组表创建选项的数组。这些选项通常与生成迁移的数据库系统相关。| Yes |

### 列定义

`Phalcon\Db\Column` 用于定义表列。它封装了各种与列相关的功能。它的构造函数接收列名称和描述列的数组作为第一个参数。描述列时可以使用以下选项：

| 选项 | 描述 | 是否可选 |

| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |:--------:|

| `type` | 列类型。必须是`Phalcon\Db\Column` 常量(见下文) | No |

| `size` | 某些类型的列(如`VARCHAR`或`INTEGER`)可能具有特定大小 | Yes |

| `scale` | `DECIMAL` 或 `NUMBER` 列可以有一个比例来指定它必须存储多少小数 | Yes |

| `unsigned` | `INTEGER` 列可以是有符号或无符号的。此选项不适用于其他类型的列 | Yes |

| `notNull` | 列可以存储 null 值吗？ | Yes |

| `default` | 定义列的默认值(只能是实际值，而不是 `NOW()`等函数)) | Yes |

| `autoIncrement` | 使用此属性列将自动填充自动增量整数。表中只有一列可以具有此属性。| Yes |

| `primary` | 使用`columnName_pkey` 作为标识符将此列设置为主键索引。类型 - `BOOLEAN` | Yes |

| `first` | 列必须按列顺序放置在第一个位置 | Yes |

| `after` | 必须在指定的列之后放置 | Yes |

数据库迁移支持以下数据库列类型：

* `Phalcon\Db\Column::TYPE_INTEGER`

* `Phalcon\Db\Column::TYPE_VARCHAR`

* `Phalcon\Db\Column::TYPE_CHAR`

* `Phalcon\Db\Column::TYPE_DATE`

* `Phalcon\Db\Column::TYPE_DATETIME`

* `Phalcon\Db\Column::TYPE_TIMESTAMP`

* `Phalcon\Db\Column::TYPE_DECIMAL`

* `Phalcon\Db\Column::TYPE_TEXT`

* `Phalcon\Db\Column::TYPE_BOOLEAN`

* `Phalcon\Db\Column::TYPE_FLOAT`

* `Phalcon\Db\Column::TYPE_DOUBLE`

* `Phalcon\Db\Column::TYPE_TINYBLOB`

* `Phalcon\Db\Column::TYPE_BLOB`

* `Phalcon\Db\Column::TYPE_MEDIUMBLOB`

* `Phalcon\Db\Column::TYPE_LONGBLOB`

* `Phalcon\Db\Column::TYPE_JSON`

* `Phalcon\Db\Column::TYPE_JSONB`

* `Phalcon\Db\Column::TYPE_BIGINTEGER`

### 索引定义

`Phalcon\Db\Index` 定义表索引。索引仅要求您为其定义名称及其列的列表。请注意，如果任何索引的名称为`PRIMARY`，Phalcon将为该表创建主键索引。

### 引用定义

`Phalcon\Db\Reference` 定义表引用(也称为外键)。以下选项可用于定义引用：

| Index | 描述 | 是否可选 | 作用于 |

| ------------------- | --------------------------------------------------------------------------------------------------- |:--------:| ---------------- |

| `referencedTable` | 它是自动描述性的。它指的是引用表的名称。 | No | All |

| `columns` | 一个数组，其中包含表中具有引用的列的名称| No | All |

| `referencedColumns` | 一个数组，其中包含引用表中列的名称 | No | All |

| `referencedSchema` | 引用的表可能在另一个模式或数据库上。此选项允许您定义它。 | Yes | All |

| `onDelete` | 如果删除了外部记录，请在本地记录上执行此操作。 | Yes | MySQL PostgreSQL |

| `onUpdate` | 如果更新了外部记录，请对本地记录执行此操作。 | Yes | MySQL PostgreSQL |

## 编写迁移

迁移不仅设计为“变形”表。迁移只是一个常规的PHP类，因此您不仅限于这些函数。例如，在添加列之后，您可以编写代码来为现有记录设置该列的值。有关各个方法的更多详细信息和示例，请检查数据库组件。

```php

use Phalcon\Mvc\Model\Migration;

class ProductsMigration_100 extends Migration

{

public function up()

{

// ...

self::$_connection->insert(

'products',

[

'Malabar spinach',

14.50,

],

[

'name',

'price',

]

);

}

}

```

## 运行迁移

生成的迁移在目标服务器上上传后，您可以轻松运行它们，如以下示例所示：



根据数据库在迁移方面的过时程度，Phalcon可能会在同一迁移过程中运行多个迁移版本。如果指定目标版本，Phalcon将运行所需的迁移，直到达到指定的版本。