create_table

(CDBT 2.0.0)

create_table新しいテーブルをデータベースに作成します

Description

bool create_table ( mixed $table_data [, string $sql ] )
指定した新たなテーブルをデータベースに作成します。作成が成功した場合、create_table()はTRUEを返します。

Parameters

table_data
新たに作成するテーブル名およびSQL文を含む配列。もしくは、新たに作成するテーブル名。
table_dataに配列を指定する場合の必要要素は下記の通り。
$table_data = array(
  'table_name' => 'new_table_name', 
  'sql' => 'CREATE TABLE new_table_name ...'
);
sql
table_dataの配列にSQL文が含まれていない場合や、table_dataがテーブル名の文字列である場合、sqlにはCREATE TABLEのSQL文を指定する必要があります。

Return

テーブルが新たに作成された場合にTRUEを、テーブルが作成できなかった場合はFALSEを返します。

History

バージョン 内容
2.0.0 CDBT v1の同名メソッドをリファクタリング

Example

例1 table_dataに配列を指定する。

<?php
global $cdbt;
if ( $cdbt->create_table( [ 'table_name' => 'new_table_name', 'sql' => 'CREATE TABLE new_table_name (...)' ] ) ) {
    echo "Table creation done.";
} else {
    echo "Table creation failed.";
}

例2 table_dataとsqlをそれぞれ指定する。

<?php
global $cdbt;
if ( $cdbt->create_table( 'new_table_name', 'CREATE TABLE new_table_name (...)' ) ) {
    echo "Table creation done.";
} else {
    echo "Table creation failed.";
}

Caution

テーブル作成前に内部でを実行し、テーブルの存在確認を行っているため、このメソッドの実行前にテーブルの存在確認は不要です。

Reference

Related Methods