# check_column()

URL: https://chugunov.pro/api-wordpress/functions/check_column/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 1.0.0.

## Сигнатура

```php
check_column( string $table_name, string $col_name, string $col_type, bool $is_null = null, mixed $key = null, mixed $default_value = null, mixed $extra = null ): bool
```

## Описание

Использует SQL-инструкцию DESC для получения сведений о столбце таблицы. Это поможет разобраться в параметрах, если вы подробнее изучите, какая информация о столбце возвращается этим SQL-запросом. Передайте null, чтобы пропустить проверку соответствующего критерия.
Имена столбцов, возвращаемые командой DESC для таблицы, чувствительны к регистру и перечислены ниже:

Field

Type

Null

Key

Default

Extra

## Параметры

- `$table_name` `string` — обязательный. Имя таблицы базы данных.
- `$col_name` `string` — обязательный. Имя столбца таблицы.
- `$col_type` `string` — обязательный. Тип столбца таблицы.
- `$is_null` `bool` — необязательный, по умолчанию `null`. Проверка на null.
- `$key` `mixed` — необязательный, по умолчанию `null`. Сведения о ключе.
- `$default_value` `mixed` — необязательный, по умолчанию `null`. Значение по умолчанию.
- `$extra` `mixed` — необязательный, по умолчанию `null`. Дополнительное значение.

## Возвращаемое значение

`bool`

## Исходный код

Файл: `wp-admin/install-helper.php:183`

```php
function check_column( $table_name, $col_name, $col_type, $is_null = null, $key = null, $default_value = null, $extra = null ) {
	global $wpdb;

	$diffs = 0;

	// phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Cannot be prepared. Fetches columns for table names.
	$results = $wpdb->get_results( "DESC $table_name" );

	foreach ( $results as $row ) {

		if ( $row->Field === $col_name ) {

			// Got our column, check the params.
			if ( ( null !== $col_type ) && ( $row->Type !== $col_type ) ) {
				++$diffs;
			}
			if ( ( null !== $is_null ) && ( $row->Null !== $is_null ) ) {
				++$diffs;
			}
			if ( ( null !== $key ) && ( $row->Key !== $key ) ) {
				++$diffs;
			}
			if ( ( null !== $default_value ) && ( $row->Default !== $default_value ) ) {
				++$diffs;
			}
			if ( ( null !== $extra ) && ( $row->Extra !== $extra ) ) {
				++$diffs;
			}

			if ( $diffs > 0 ) {
				return false;
			}

			return true;
		} // End if found our column.
	}

	return false;
}
```

## История изменений

- 1.0.0 — Introduced.

## Связанные

Использует: `wpdb::get_results`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/check_column/