简介

WordPress 专用的全局变量在整个 WordPress 代码中被用于各种目的。几乎所有由 WordPress 生成的数据都可以找到在全局变量中。

请注意，当有合适的 API 函数可用时，最好使用它们，而不是直接修改全局变量。

要在代码中访问全局变量，首先需要使用 global $variable; 将该变量声明为全局变量。

不建议访问下列列出的其他全局变量。

循环内的变量

在循环内部时，会设置这些全局变量，包含有关当前正在处理的帖子的信息。

  • $post (WP_Post)：当前帖子的帖子对象。对象描述见 WP_Post 类参考。
  • $posts：由一些核心函数使用，不要与 $query->$posts 混淆。
  • $authordata (WP_User)：当前帖子的作者对象。对象描述见 WP_User 类参考。
  • $currentday (string)：当前帖子发布的日期。
  • $currentmonth (string)：当前帖子发布的月份。
  • $page (int)：当前查看的帖子的页码。由查询变量 page 指定。
  • $pages (array)：当前帖子的页面内容。每个页面元素包含由 <!--nextpage--> 标签分隔的部分内容。
  • $multipage (boolean)：标志位，用于判断当前帖子是否有多页。如果帖子有多页则返回 true，与 $pages 相关。
  • $more (boolean)：标志位，用于判断 WordPress 是否应强制对当前帖子使用 <!--more--> 标签。如果为 true，WordPress 将不会强制使用该标签。
  • $numpages (int)：返回帖子中的页数，与 $pages 相关。

浏览器检测布尔值

这些全局变量存储有关用户所用浏览器的数据。

  • $is_iphone (boolean)：iPhone Safari
  • $is_chrome (boolean)：Google Chrome
  • $is_safari (boolean)：Safari
  • $is_NS4 (boolean)：Netscape 4
  • $is_opera (boolean)：Opera
  • $is_macIE (boolean)：Mac Internet Explorer
  • $is_winIE (boolean)：Windows Internet Explorer
  • $is_gecko (boolean)：FireFox
  • $is_lynx (boolean)：Lynx
  • $is_IE (boolean)：Internet Explorer
  • $is_edge (boolean)：Microsoft Edge

Web 服务器检测布尔值

这些全局变量存储有关 WordPress 运行所在的 Web 服务器的数据。

  • $is_apache (boolean)：Apache HTTP Server
  • $is_IIS (boolean)：Microsoft Internet Information Services (IIS)
  • $is_iis7 (boolean)：Microsoft Internet Information Services (IIS) v7.x
  • $is_nginx (boolean)：Nginx web server

版本变量

  • $wp_version (string)：已安装的 WordPress 版本
  • $wp_db_version (int)：数据库版本号
  • $tinymce_version (string)：已安装的 TinyMCE 版本
  • $manifest_version (string)：缓存清单版本
  • $required_php_version (string)：此 WordPress 安装所需的 PHP 版本
  • $required_mysql_version (string)：此 WordPress 安装所需的 MySQL 版本

杂项

  • $super_admins (array)：应授予超级管理员权限的用户 ID 数组（多站点）。此全局变量仅由站点所有者设置（例如在 wp-config.php 中），并包含应拥有超级管理员权限的用户 ID 数组。如果设置了它，将覆盖数据库中超级管理员列表。
  • $wp_query (object)：WP_Query 类的全局实例。
  • $wp_rewrite (object)：WP_Rewrite 类的全局实例。
  • $wp (object)：WP 环境设置类的全局实例。
  • $wpdb (object)：wpdb 类的全局实例。
  • $wp_locale (object)：WP_Locale 类的全局实例。
  • $wp_admin_bar (object)：WP_Admin_Bar 类的全局实例。
  • $wp_roles (object)：WP_Roles 类的全局实例。
  • $wp_meta_boxes (array)：包含所有注册的元框的对象，包括其 ID、参数、回调函数和标题，适用于所有文章类型，包括自定义类型。
  • $wp_registered_sidebars (array)
  • $wp_registered_widgets (array)
  • $wp_registered_widget_controls (array)
  • $wp_registered_widget_updates (array)

管理后台全局变量

  • $pagenow (string)：在 wp-admin 中使用。
    另请参阅 get_current_screen() 以了解 WordPress 管理屏幕 API。
  • $post_type (string)：在 wp-admin 中使用
  • $allowedposttags (array)
  • $allowedtags (array)
  • $menu (array)