©
本文档使用 PHP中文网手册 发布
迁移是以结构化和有组织的方式更改数据库的一种方便的方式。您可以手工编辑SQL片段,但随后您将负责告诉其他开发人员他们需要去运行它们。您还必须跟踪下次部署时需要针对生产机器运行哪些更改。
数据库表迁移跟踪哪些迁移已经运行,所以您所要做的就是更新应用程序文件并调用$this->migration->current()
以确定应该运行哪些迁移。当前版本可在application/config/移入.php...
迁移文件名
创建迁移
使用实例
迁移偏好
类引用
根据所采用的方法,每个迁移都按数字顺序向前或向后运行。有两种编号样式:
顺序:每个迁移按顺序编号,从001开始。每个数字必须是三位数字,并且序列中不得有空位。(这是CodeIgniter 3.0之前的编号方案。)
时间戳:使用YYYYMMDDHHIISS格式(例如20121031100537)创建迁移时,使用时间戳对每个迁移进行编号。这有助于防止在团队环境中工作时编号冲突,并且是CodeIgniter 3.0及更高版本中的首选方案。
可以使用$config['migration_type']
在你的application/config/移入.php档案。
无论您选择使用哪种编号样式,迁移文件的前缀都是迁移号,后面是下划线和迁移的描述性名称。例如:
001_add_blog.php(顺序编号)
20121031100537_add_blog.php(时间戳编号)
这将是一个拥有博客的新网站的首次迁移。所有迁移都在application / migrations /目录中,并具有名称,如20121031100537_add_blog.php。
<?phpdefined('BASEPATH') OR exit('No direct script access allowed'); class Migration_Add_blog extends CI_Migration { public function up() { $this->dbforge->add_field(array( 'blog_id' => array('type' => 'INT','constraint' => 5,'unsigned' => TRUE,'auto_increment' => TRUE), 'blog_title' => array('type' => 'VARCHAR','constraint' => '100',),'blog_description' => array('type' => 'TEXT','null' => TRUE,),)); $this->dbforge->add_key('blog_id', TRUE); $this->dbforge->create_table('blog'); } public function down() { $this->dbforge->drop_table('blog'); } }
然后进去application/config/移入.php集$config['migration_version'] = 20121031100537;
...
在这个例子中,一些简单的代码放在应用程序/控制器/Migrate.php若要更新架构,请执行以下操作:
<?phpclass Migrate extends CI_Controller{ public function index(){ $this->load->library('migration'); if ($this->migration->current() === FALSE) { show_error($this->migration->error_string());} } }
下面是用于迁移的所有配置选项的表。
偏好 | 默认 | 选项 | 描述 |
---|---|---|---|
migration_enabled | 假 | 真假 | 启用或禁用迁移。 |
migration_path | APPPATH.'migrations /” | 没有 | 您的迁移文件夹的路径。 |
migration_version | 0 | 没有 | 数据库应该使用的当前版本。 |
migration_table | 迁移 | 没有 | 用于存储模式版本号的表名。 |
migration_auto_latest | 假 | 真假 | 启用或禁用自动运行迁移。 |
MIGRATION_TYPE | “时间戳” | '时间戳'/'顺序' | 用于命名迁移文件的数字标识符的类型。 |
class CI_Migrationcurrent()
返回: | 如果未找到迁移,则为TRUE,成功时为当前版本字符串,失败时为FALSE |
---|---|
返回类型: | mixed |
error_string()
返回: | 错误消息 |
---|---|
返回类型: | 串 |
find_migrations()
返回: | 一组迁移文件 |
---|---|
返回类型: | 数组 |
latest()
返回: | 成功时的当前版本字符串,失败时为FALSE |
---|---|
返回类型: | mixed |
version($target_version)
参数: | $ target_version(混合) - 将迁移版本处理 |
---|---|
返回: | 如果未找到迁移,则为TRUE,成功时为当前版本字符串,失败时为FALSE |
返回类型: | mixed |
$ target_version(混合) - 将迁移版本处理
Returns: TRUE if no migrations are found, current version string on success, FALSE on failure
Return type: mixed
版本可用于回滚更改或以编程方式前进到特定版本。它像`current()`一样工作,但忽略`$ config ['migration_version']`。