概述

wp_get_themes() 函数根据参数返回一个 WP_Theme 对象数组，用于检索主题信息。相比已弃用的 get_themes() 有所改进，但性能开销较大，建议优先使用 wp_get_theme()。

关键要点

• 返回 WP_Theme 对象数组，支持通过参数过滤主题列表。
• 参数包括 errors（控制是否返回有错误的主题）、allowed（在多站点环境中控制允许的主题类型）和 blog_id（指定博客ID）。
• 函数内部处理多站点主题权限和错误过滤，并缓存 WP_Theme 对象以提高效率。
• 性能警告：函数开销随主题数量线性增长，应谨慎使用。

代码示例

function wp_get_themes( $args = array() ) {
    global $wp_theme_directories;

    $defaults = array(
        'errors'  => false,
        'allowed' => null,
        'blog_id' => 0,
    );
    $args     = wp_parse_args( $args, $defaults );

    $theme_directories = search_theme_directories();

    if ( is_array( $wp_theme_directories ) && count( $wp_theme_directories ) > 1 ) {
        /*
         * 确保活动主题优先，以防 search_theme_directories() 在冲突时选择错误主题根。
         */
        $current_theme = get_stylesheet();
        if ( isset( $theme_directories[ $current_theme ] ) ) {
            $root_of_current_theme = get_raw_theme_root( $current_theme );
            if ( ! in_array( $root_of_current_theme, $wp_theme_directories, true ) ) {
                $root_of_current_theme = WP_CONTENT_DIR . $root_of_current_theme;
            }
            $theme_directories[ $current_theme ]['theme_root'] = $root_of_current_theme;
        }
    }

    if ( empty( $theme_directories ) ) {
        return array();
    }

    if ( is_multisite() && null !== $args['allowed'] ) {
        $allowed = $args['allowed'];
        if ( 'network' === $allowed ) {
            $theme_directories = array_intersect_key( $theme_directories, WP_Theme::get_allowed_on_network() );
        } elseif ( 'site' === $allowed ) {
            $theme_directories = array_intersect_key( $theme_directories, WP_Theme::get_allowed_on_site( $args['blog_id'] ) );
        } elseif ( $allowed ) {
            $theme_directories = array_intersect_key( $theme_directories, WP_Theme::get_allowed( $args['blog_id'] ) );
        } else {
            $theme_directories = array_diff_key( $theme_directories, WP_Theme::get_allowed( $args['blog_id'] ) );
        }
    }

    $themes         = array();
    static $_themes = array();

    foreach ( $theme_directories as $theme => $theme_root ) {
        if ( isset( $_themes[ $theme_root['theme_root'] . '/' . $theme ] ) ) {
            $themes[ $theme ] = $_themes[ $theme_root['theme_root'] . '/' . $theme ];
        } else {
            $themes[ $theme ] = new WP_Theme( $theme, $theme_root['theme_root'] );

            $_themes[ $theme_root['theme_root'] . '/' . $theme ] = $themes[ $theme ];
        }
    }

    if ( null !== $args['errors'] ) {
        foreach ( $themes as $theme => $wp_theme ) {
            if ( (bool) $wp_theme->errors() !== $args['errors'] ) {
                unset( $themes[ $theme ] );
            }
        }
    }

    return $themes;
}

注意事项

• 函数自 WordPress 3.4.0 版本引入，替代了已弃用的 get_themes()。
• 在多站点环境中，allowed 参数可设置为 'network'、'site' 或布尔值，以过滤网络或站点允许的主题。
• errors 参数为 true 时返回有错误的主题，false 时返回无错误的主题，null 时返回所有主题。
• 由于性能考虑，在主题数量较多时应避免频繁调用此函数。