GET_BLOG_DETAILS() │ WP 3.0.0

Функция get_blog_details() позволяет получить информацию о блоге из таблицы блогов и его настройках.

Используется

• WP_Site()
• get_option()

Хуки из функции

• blog_details

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

Возвращает объект WP_Site с деталями блога при успешном выполнении или false в случае ошибки.

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

get_blog_details( $fields, $get_all );

• $fields (int|string|array) — ID блога, слуг (псевдоним) блога или массив полей для запроса.
  • По умолчанию: текущий ID блога
• $get_all (true|false) — Нужно ли получить все детали или только детали из таблицы блогов.
  • По умолчанию: true

Примеры

Пример 1: Получение деталей блога

$details = get_blog_details();

Это возвратит объект WP_Site, который будет содержать следующую информацию:

/*
$details = WP_Site Object (
    [blog_id] => 2
    [domain] => site.com
    [path] => /es/
    [site_id] => 1
    [registered] => 2023-09-16 20:18:00
    [last_updated] => 2023-09-16 20:20:15
    [public] => 1
    [archived] => 0
    [mature] => 0
    [spam] => 0
    [deleted] => 0
    [lang_id] => 0
    [blogname] => Site.com ES
    [siteurl] => https://site.com/es
    [post_count] => 
    [home] => https://site.com/es
)
*/

Если второй параметр равен false, то детали будут возвращены в виде объекта stdClass без некоторых данных:

$details = get_blog_details(null, false);
/*
stdClass Object
(
    [blog_id] => 2
    [site_id] => 1
    [domain] => site.com
    [path] => /es/
    [registered] => 2023-09-16 20:18:00
    [last_updated] => 2023-09-16 20:20:15
    [public] => 1
    [archived] => 0
    [mature] => 0
    [spam] => 0
    [deleted] => 0
    [lang_id] => 0
)
*/

Для получения URL текущего блога можно использовать:

$details = get_blog_details();
echo $details->siteurl;

Пример 2: Получение дополнительной информации

Если вам нужна дополнительная информация о блоге, например, его описание, воспользуйтесь следующей функцией:

get_blog_option( $blog_id, 'blogdescription' ); // Получить описание блога

Примечания

• Глобальный объект базы данных. Используйте $wpdb для работы с базой данных WordPress.

Журнал изменений

• Впервые была представлена в версии 3.0.0.

Код функции в WP 6.7.2

function get_blog_details( $fields = null, $get_all = true ) {
    global $wpdb;

    if ( is_array( $fields ) ) {
        if ( isset( $fields['blog_id'] ) ) {
            $blog_id = $fields['blog_id'];
        } elseif ( isset( $fields['domain'] ) && isset( $fields['path'] ) ) {
            $key  = md5( $fields['domain'] . $fields['path'] );
            $blog = wp_cache_get( $key, 'blog-lookup' );
            if ( false !== $blog ) {
                return $blog;
            }
            if ( str_starts_with( $fields['domain'], 'www.' ) ) {
                $nowww = substr( $fields['domain'], 4 );
                $blog  = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->blogs WHERE domain IN (%s,%s) AND path = %s ORDER BY CHAR_LENGTH(domain) DESC", $nowww, $fields['domain'], $fields['path'] ) );
            } else {
                $blog = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->blogs WHERE domain = %s AND path = %s", $fields['domain'], $fields['path'] ) );
            }
            if ( $blog ) {
                wp_cache_set( $blog->blog_id . 'short', $blog, 'blog-details' );
                $blog_id = $blog->blog_id;
            } else {
                return false;
            }
        } elseif ( isset( $fields['domain'] ) && is_subdomain_install() ) {
            $key  = md5( $fields['domain'] );
            $blog = wp_cache_get( $key, 'blog-lookup' );
            if ( false !== $blog ) {
                return $blog;
            }
            if ( str_starts_with( $fields['domain'], 'www.' ) ) {
                $nowww = substr( $fields['domain'], 4 );
                $blog  = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->blogs WHERE domain IN (%s,%s) ORDER BY CHAR_LENGTH(domain) DESC", $nowww, $fields['domain'] ) );
            } else {
                $blog = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->blogs WHERE domain = %s", $fields['domain'] ) );
            }
            if ( $blog ) {
                wp_cache_set( $blog->blog_id . 'short', $blog, 'blog-details' );
                $blog_id = $blog->blog_id;
            } else {
                return false;
            }
        } else {
            return false;
        }
    } else {
        if ( ! $fields ) {
            $blog_id = get_current_blog_id();
        } elseif ( ! is_numeric( $fields ) ) {
            $blog_id = get_id_from_blogname( $fields );
        } else {
            $blog_id = $fields;
        }
    }

    $blog_id = (int) $blog_id;

    $all     = $get_all ? '' : 'short';
    $details = wp_cache_get( $blog_id . $all, 'blog-details' );

    if ( $details ) {
        if ( ! is_object( $details ) ) {
            if ( -1 === $details ) {
                return false;
            } else {
                wp_cache_delete( $blog_id . $all, 'blog-details' );
                unset( $details );
            }
        } else {
            return $details;
        }
    }

    if ( $get_all ) {
        $details = wp_cache_get( $blog_id . 'short', 'blog-details' );
    } else {
        $details = wp_cache_get( $blog_id, 'blog-details' );
        if ( $details ) {
            if ( ! is_object( $details ) ) {
                if ( -1 === $details ) {
                    return false;
                } else {
                    wp_cache_delete( $blog_id, 'blog-details' );
                    unset( $details );
                }
            } else {
                return $details;
            }
        }
    }

    if ( empty( $details ) ) {
        $details = WP_Site::get_instance( $blog_id );
        if ( ! $details ) {
            wp_cache_set( $blog_id, -1, 'blog-details' );
            return false;
        }
    }

    if ( ! $details instanceof WP_Site ) {
        $details = new WP_Site( $details );
    }

    if ( ! $get_all ) {
        wp_cache_set( $blog_id . $all, $details, 'blog-details' );
        return $details;
    }

    $switched_blog = false;

    if ( get_current_blog_id() !== $blog_id ) {
        switch_to_blog( $blog_id );
        $switched_blog = true;
    }

    $details->blogname   = get_option( 'blogname' );
    $details->siteurl    = get_option( 'siteurl' );
    $details->post_count = get_option( 'post_count' );
    $details->home       = get_option( 'home' );

    if ( $switched_blog ) {
        restore_current_blog();
    }

    $details = apply_filters_deprecated( 'blog_details', array( $details ), '4.7.0', 'site_details' );

    wp_cache_set( $blog_id . $all, $details, 'blog-details' );

    $key = md5( $details->domain . $details->path );
    wp_cache_set( $key, $details, 'blog-lookup' );

    return $details;
}

Связанные функции

• get_current_blog_id()
• get_dirsize()
• get_id_from_blogname()
• get_main_site_id()
• get_site_meta()
• get_sites()
• grant_super_admin()
• is_blog_admin()
• is_main_site()
• is_multisite()
• is_network_admin()
• is_user_admin()
• network_admin_url()
• network_home_url()
• recurse_dirsize()
• restore_current_blog()
• switch_to_blog()