wpseek.com
Eine auf WordPress spezialiserte Suchmaschine für Entwickler und Theme-Autoren



maybe_add_column › WordPress Function

Seit1.0.0
Veraltetn/v
› maybe_add_column ( $table_name, $column_name, $create_ddl )
Parameter: (3)
  • (string) $table_name Database table name.
    Erforderlich: Ja
  • (string) $column_name Table column name.
    Erforderlich: Ja
  • (string) $create_ddl SQL statement to add column.
    Erforderlich: Ja
Gibt zurück:
  • (bool) True on success or if the column already exists. False on failure.
Definiert in:
Codex:

Adds column to database table, if it doesn't already exist.



Ähnliche Funktionen: maybe_drop_column, image_add_caption, get_hidden_columns, maybe_hash_hex_color, _maybe_update_core

Quellcode 

function maybe_add_column( $table_name, $column_name, $create_ddl ) {
		global $wpdb;

		// phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Cannot be prepared. Fetches columns for table names.
		foreach ( $wpdb->get_col( "DESC $table_name", 0 ) as $column ) {
			if ( $column === $column_name ) {
				return true;
			}
		}

		// Didn't find it, so try to create it.
		// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared -- No applicable variables for this query.
		$wpdb->query( $create_ddl );

		// We cannot directly tell whether this succeeded!
		// phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Cannot be prepared. Fetches columns for table names.
		foreach ( $wpdb->get_col( "DESC $table_name", 0 ) as $column ) {
			if ( $column === $column_name ) {
				return true;
			}
		}

		return false;
	}
endif;

/**
 * Drops column from database table, if it exists.
 *
 * @since 1.0.0
 *
 * @global wpdb $wpdb WordPress database abstraction object.
 *
 * @param string $table_name  Database table name.
 * @param string $column_name Table column name.
 * @param string $drop_ddl    SQL statement to drop column.
 * @return bool True on success or if the column doesn't exist. False on failure.
 */