blob: cb7d96a6d22a81e15db9b49542794aec1f2e1ffb (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
################
Migrations Class
################
Migrations are a convenient way for you to alter your database in a
structured and organized manner. You could edit fragments of SQL by hand
but you would then be responsible for telling other developers that they
need to go and run them. You would also have to keep track of which changes
need to be run against the production machines next time you deploy.
The database table **migration** tracks which migrations have already been
run so all you have to do is update your application files and
call **$this->migrate->current()** to work out which migrations should be run.
The current version is found in **config/migration.php**.
******************
Create a Migration
******************
.. note:: Each Migration is run in numerical order forward or backwards
depending on the method taken. Use a prefix of 3 numbers followed by an
underscore for the filename of your migration.
This will be the first migration for a new site which has a blog. All
migrations go in the folder **application/migrations/** and have names such
as: **001_add_blog.php**.::
defined('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->create_table('blog');
}
public function down()
{
$this->dbforge->drop_table('blog');
}
Then in **application/config/migration.php** set **$config['migration_version'] = 1;**.
*************
Usage Example
*************
In this example some simple code is placed in **application/controllers/migrate.php**
to update the schema.::
$this->load->library('migration');
if ( ! $this->migration->current())
{
show_error($this->migration->error_string());
}
******************
Function Reference
******************
There are five available methods for the Migration class:
- $this->migration->current();
- $this->migration->error_string();
- $this->migration->find_migrations();
- $this->migration->latest();
- $this->migration->version();
$this->migration->current()
============================
The current migration is whatever is set for **$config['migration_version']** in
**application/config/migration.php**.
$this->migration->error_string()
=================================
This returns a string of errors while performing a migration.
$this->migration->find_migrations()
====================================
An array of migration filenames are returned that are found in the **migration_path**
property.
$this->migration->latest()
===========================
This works much the same way as current() but instead of looking for
the **$config['migration_version']** the Migration class will use the very
newest migration found in the filesystem.
$this->migration->version()
============================
Version can be used to roll back changes or step forwards programmatically to
specific versions. It works just like current but ignores **$config['migration_version']**.::
$this->load->library('migration');
$this->migration->version(5);
*********************
Migration Preferences
*********************
The following is a table of all the config options for migrations.
========================== ====================== ============= =============================================
Preference Default Options Description
========================== ====================== ============= =============================================
**migration_enabled** FALSE TRUE / FALSE Enable or disable migrations.
**migration_path** APPPATH.'migrations/' None The path to your migrations folder.
**migration_version** 0 None The current version your database should use.
**migration_table** migrations None The table name for storing the shema
version number.
**migration_auto_latest** FALSE TRUE / FALSE Enable or disable automatically
running migrations.
========================== ====================== ============= =============================================
|
