is_blog_installed() │ WP 2.1.0

Проверяет установлен ли сайт. Проверяется наличие опции siteurl и таблиц в базе данных. Результат кэшируется.

После проверки опции siteurl (если её нет), функция проверят наличие таблиц в БД. Если таблицы найдены, то вы увидите ошибку __( 'Error establishing a database connection' ). Такая ситуация может возникнуть, когда таблица опций повреждена и получить опцию siteurl невозможно, но сайт все же установлен. Поэтому если не удалось найти опцию siteurl функция проверят наличие таблиц. Если ни одной таблицы в БД нет, значит сайт не установлен.

Функция ничего не делает и всегда возвращает true, если мы находимся в режиме ремонта/восстановления таблиц БД.

1 раз — 0.000026 сек (очень быстро) | 50000 раз — 0.07 сек (скорость света) | PHP 7.0.14, WP 4.7

Хуков нет.

Возвращает

true|false.

Использование

if( is_blog_installed() ){
	// сайт установлен!
}

Примеры

0

#1 Проверим установлен ли сайт, перед регистрацией виджета 

function widgets_init() {

	if ( ! is_blog_installed() ) {
		return;
	}

	register_widget( 'WP_Widget_Black_Studio_TinyMCE' );
}

Заметки

  • Global. wpdb. $wpdb WordPress database abstraction object.

Список изменений

С версии 2.1.0 Введена.

Код is_blog_installed() WP 6.8.1

wp-includes/functions.php 
function is_blog_installed() {
	global $wpdb;

	/*
	 * Check cache first. If options table goes away and we have true
	 * cached, oh well.
	 */
	if ( wp_cache_get( 'is_blog_installed' ) ) {
		return true;
	}

	$suppress = $wpdb->suppress_errors();

	if ( ! wp_installing() ) {
		$alloptions = wp_load_alloptions();
	}

	// If siteurl is not set to autoload, check it specifically.
	if ( ! isset( $alloptions['siteurl'] ) ) {
		$installed = $wpdb->get_var( "SELECT option_value FROM $wpdb->options WHERE option_name = 'siteurl'" );
	} else {
		$installed = $alloptions['siteurl'];
	}

	$wpdb->suppress_errors( $suppress );

	$installed = ! empty( $installed );
	wp_cache_set( 'is_blog_installed', $installed );

	if ( $installed ) {
		return true;
	}

	// If visiting repair.php, return true and let it take over.
	if ( defined( 'WP_REPAIRING' ) ) {
		return true;
	}

	$suppress = $wpdb->suppress_errors();

	/*
	 * Loop over the WP tables. If none exist, then scratch installation is allowed.
	 * If one or more exist, suggest table repair since we got here because the
	 * options table could not be accessed.
	 */
	$wp_tables = $wpdb->tables();
	foreach ( $wp_tables as $table ) {
		// The existence of custom user tables shouldn't suggest an unwise state or prevent a clean installation.
		if ( defined( 'CUSTOM_USER_TABLE' ) && CUSTOM_USER_TABLE === $table ) {
			continue;
		}

		if ( defined( 'CUSTOM_USER_META_TABLE' ) && CUSTOM_USER_META_TABLE === $table ) {
			continue;
		}

		$described_table = $wpdb->get_results( "DESCRIBE $table;" );
		if (
			( ! $described_table && empty( $wpdb->last_error ) ) ||
			( is_array( $described_table ) && 0 === count( $described_table ) )
		) {
			continue;
		}

		// One or more tables exist. This is not good.

		wp_load_translations_early();

		// Die with a DB error.
		$wpdb->error = sprintf(
			/* translators: %s: Database repair URL. */
			__( 'One or more database tables are unavailable. The database may need to be <a href="%s">repaired</a>.' ),
			'maint/repair.php?referrer=is_blog_installed'
		);

		dead_db();
	}

	$wpdb->suppress_errors( $suppress );

	wp_cache_set( 'is_blog_installed', false );

	return false;
}

Проверки (checks)