데이터베이스 관리 클래스 Database Forge Class¶

관리 클래스 초기화 Initializing the Forge Class¶

관리 클래스를 아래와 같이 로드합니다:

$this->load->dbforge()

사용하고 싶은 데이터베이스가 기본값이 아닐 경우, 다른 데이터베이스 객체를 DB Forge 로더에 전달할 수 있습니다:

$this->myforge = $this->load->dbforge($this->other_db, TRUE);

위 예제에서, 첫 번째 파라미터로 데이터베이스 객체를 전달합니다. 그리고 $this->dbforge를 직접 할당하는 대신에 dbforge 객체를 돌려줍니다.

한 번 로드 되면, $this->dbforge 객체를 이용합니다 object:

$this->dbforge->some_method();

데이터베이스 생성 및 삭제 Creating and Dropping Databases¶

$this->dbforge->create_database(‘db_name’)

첫 번째 파라미터에 정의한대로 데이터베이스를 생성합니다. 그리고 그 결과에 따라서 TRUE/FALSE를 리턴합니다:

if ($this->dbforge->create_database('my_db'))
{
        echo 'Database created!';
}

$this->dbforge->drop_database(‘db_name’)

첫 번째 파라미터에 주어진 데이터베이스를 삭제합니다. 그리고 그 결과에 따라서 TRUE/FALSE를 리턴합니다:

if ($this->dbforge->drop_database('my_db'))
{
        echo 'Database deleted!';
}

Creating and Dropping Tables¶

테이블을 생성할 때 하고자 하는 일들이 몇 가지 있을 것입니다. 필드 추가, 키 추가, 칼럼 변경 등이 그것이죠. CodeIgniter는 이러한 작업에 대한 메커니즘을 제공합니다.

$fields = array(
        'users' => array(
                'type' => 'VARCHAR',
                'constraint' => '100',
        ),
);
// will translate to "users VARCHAR(100)" when the field is added.

$fields = array(
        'blog_id' => array(
                'type' => 'INT',
                'constraint' => 5,
                'unsigned' => TRUE,
                'auto_increment' => TRUE
        ),
        'blog_title' => array(
                'type' => 'VARCHAR',
                'constraint' => '100',
                'unique' => TRUE,
        ),
        'blog_author' => array(
                'type' =>'VARCHAR',
                'constraint' => '100',
                'default' => 'King of Town',
        ),
        'blog_description' => array(
                'type' => 'TEXT',
                'null' => TRUE,
        ),
);

$this->dbforge->add_field("label varchar(100) NOT NULL DEFAULT 'default label'");

$this->dbforge->add_field('id');
// gives id INT(9) NOT NULL AUTO_INCREMENT

$this->dbforge->add_key('blog_id', TRUE);
// gives PRIMARY KEY `blog_id` (`blog_id`)

$this->dbforge->add_key('blog_id', TRUE);
$this->dbforge->add_key('site_id', TRUE);
// gives PRIMARY KEY `blog_id_site_id` (`blog_id`, `site_id`)

$this->dbforge->add_key('blog_name');
// gives KEY `blog_name` (`blog_name`)

$this->dbforge->add_key(array('blog_name', 'blog_label'));
// gives KEY `blog_name_blog_label` (`blog_name`, `blog_label`)

$this->dbforge->create_table('table_name');
// gives CREATE TABLE table_name

$this->dbforge->create_table('table_name', TRUE);
// gives CREATE TABLE IF NOT EXISTS table_name

$attributes = array('ENGINE' => 'InnoDB');
$this->dbforge->create_table('table_name', FALSE, $attributes);
// produces: CREATE TABLE `table_name` (...) ENGINE = InnoDB DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci

// Produces: DROP TABLE table_name
$this->dbforge->drop_table('table_name');

// Produces: DROP TABLE IF EXISTS table_name
$this->dbforge->drop_table('table_name');

$this->dbforge->rename_table('old_table_name', 'new_table_name');
// gives ALTER TABLE old_table_name RENAME TO new_table_name

테이블 수정 Modifying Tables¶

$fields = array(
        'preferences' => array('type' => 'TEXT')
);
$this->dbforge->add_column('table_name', $fields);
// Executes: ALTER TABLE table_name ADD preferences TEXT

// Will place the new column after the `another_field` column:
$fields = array(
        'preferences' => array('type' => 'TEXT', 'after' => 'another_field')
);

// Will place the new column at the start of the table definition:
$fields = array(
        'preferences' => array('type' => 'TEXT', 'first' => TRUE)
);

$this->dbforge->drop_column('table_name', 'column_to_drop');

$fields = array(
        'old_name' => array(
                'name' => 'new_name',
                'type' => 'TEXT',
        ),
);
$this->dbforge->modify_column('table_name', $fields);
// gives ALTER TABLE table_name CHANGE old_name new_name TEXT

클래스 레퍼런스¶

class CI_DB_forge¶

add_column($table[, $field = array()[, $_after = NULL]])¶

인수:	$table (string) – Table name to add the column to $field (array) – Column definition(s) $_after (string) – Column for AFTER clause (deprecated)
반환값:	TRUE on success, FALSE on failure
반환형:	bool

컬럼을 테이블에 추가. 사용 : Adding a Column to a Table 참조.

add_field($field)¶

인수:	$field (array) – Field definition to add
반환값:	CI_DB_forge instance (method chaining)
반환형:	CI_DB_forge

테이블을 생성하는 데 사용되는 필드들을 추가. 사용: Adding fields 참조.

add_key($key[, $primary = FALSE])¶

인수:	$key (array) – Name of a key field $primary (bool) – Set to TRUE if it should be a primary key or a regular one
반환값:	CI_DB_forge instance (method chaining)
반환형:	CI_DB_forge

테이블을 생성하는 데 사용되는 세트에 키를 추가. 사용: Adding Keys 참조.

create_database($db_name)¶

인수:	$db_name (string) – Name of the database to create
반환값:	TRUE on success, FALSE on failure
반환형:	bool

새로운 데이터베이스 생성. 사용: Creating and Dropping Databases 참조.

create_table($table[, $if_not_exists = FALSE[, array $attributes = array()]])¶

인수:	$table (string) – Name of the table to create $if_not_exists (string) – Set to TRUE to add an ‘IF NOT EXISTS’ clause $attributes (string) – An associative array of table attributes
반환값:	TRUE on success, FALSE on failure
반환형:	bool

새로운 테이블 생성. 사용: Creating a table 참조.

drop_column($table, $column_name)¶

인수:	$table (string) – Table name $column_name (array) – The column name to drop
반환값:	TRUE on success, FALSE on failure
반환형:	bool

테이블에서 컬럼 삭제. 사용 : Dropping a Column From a Table 참조.

drop_database($db_name)¶

인수:	$db_name (string) – Name of the database to drop
반환값:	TRUE on success, FALSE on failure
반환형:	bool

데이터베이스 삭제. 사용: Creating and Dropping Databases 참조.

drop_table($table_name[, $if_exists = FALSE])¶

인수:	$table (string) – Name of the table to drop $if_exists (string) – Set to TRUE to add an ‘IF EXISTS’ clause
반환값:	TRUE on success, FALSE on failure
반환형:	bool

테이블 삭제. 사용: Dropping a table 참조.

modify_column($table, $field)¶

인수:	$table (string) – Table name $field (array) – Column definition(s)
반환값:	TRUE on success, FALSE on failure
반환형:	bool

테이블 컬럼 수정. 사용: Modifying a Column in a Table 참조.

rename_table($table_name, $new_table_name)¶

인수:	$table (string) – Current of the table $new_table_name (string) – New name of the table
반환값:	TRUE on success, FALSE on failure
반환형:	bool

테이블 이름 변경. 사용: Renaming a table 참조.