maybe_create_table() – Creates a table in the database, if it doesn’t already exist.

You appear to be a bot. Output may be restricted

Description

Creates a table in the database, if it doesn't already exist.

This method checks for an existing database table and creates a new one if it's not already present. It doesn't rely on MySQL's "IF NOT EXISTS" statement, but chooses to query all tables first and then run the SQL statement creating the table.

Usage

$bool = maybe_create_table( $table_name, $create_ddl );

Parameters

$table_name
( string ) required – Database table name.
$create_ddl
( string ) required – SQL statement to create table.

Returns

bool True on success or if the table already exists. False on failure.

Source

File name: wordpress/wp-admin/includes/upgrade.php
Lines:

1 to 19 of 19
function maybe_create_table( $table_name, $create_ddl ) {
  global $wpdb;

  $query = $wpdb->prepare( 'SHOW TABLES LIKE %s', $wpdb->esc_like( $table_name ) );

  if ( $wpdb->get_var( $query ) === $table_name ) {
    return true;
  }

  // Didn't find it, so try to create it.
  $wpdb->query( $create_ddl );

  // We cannot directly tell that whether this succeeded!
  if ( $wpdb->get_var( $query ) === $table_name ) {
    return true;
  }

  return false;
}
 

 View on GitHub View on Trac