数据库迁移
最后更新于：2022-04-02 05:14:41
[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
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
insert(
'products',
[
'Malabar spinach',
14.50,
],
[
'name',
'price',
]
);
}
}
```
## 运行迁移
生成的迁移在目标服务器上上传后，您可以轻松运行它们，如以下示例所示：
根据数据库在迁移方面的过时程度，Phalcon可能会在同一迁移过程中运行多个迁移版本。如果指定目标版本，Phalcon将运行所需的迁移，直到达到指定的版本。
';