WordPress 前端代码详细说明

本文的侧重点是:展示和解读 WordPress 从启动 (即从 index.PHP 入口进入) 到在网页上展示模板和内容的过程。这个过程可以分为 3 个阶段,一是初始化阶段,即初始化常量、环境、加载核心文件等等;二是内容处理阶段,即根据用户的请求调用相关函数获取和处理数据,为前端展示准备数据;三是主题应用阶段,在这个阶段,需要展示的数据已经准备完毕,需要根据用户的请求加载相应的主题模板,即对主题进行路由。经过这三各阶段,用户请求的页面就可以完全的展现出来了~_~

:为了是思路更加的清晰易懂,暂时不考虑后台管理相关的文件,以及多博客 / 站点相关的文件!

初始化阶段

从 WordPress 入口 (大部分情况下是 index.php) 进入,到这部分结束为止,我们看到 WordPress 主要做了如下几件事情:定义常量和全局变量设置环境参数进行初始化判断 (例如 WordPress 是否已经安装);加载 WordPress 核心文件处理 action 和 filter 相关事务创建功能对象 (如 $wp,$wp_rewrite 等);因而这一阶段可以看作是 WordPress 的初始化阶段。WordPress 的初始化阶段是一个相当繁琐的过程,详细见如下列表:

  1. 定义 WP_USE_THEMES 常量,当该常量定义为 false 时,即不使用主题,站点会显示为空白;为 true 时则正常显示。
  2. 设置 $wp_did_header 变量,相当于一个 flag ,确保每次刷新时 wp-blog-header.php 文件只执行一次。
  3. 设置 WordPress 目录的绝对路径 ABSPATH。
  4. 设置错误报告模式。
  5. 在 wp-config.php 文件中设置可配置项。
  6. 定义 WPINC 常量,版本相关变量,并对这些变量进行赋值。
  7. 调用 wp_initial_constants () 函数,初始化常量 WP_MEMORY_LIMIT, WP_DEBUG, WP_CONTENT_DIR 和 WP_CACHE。
  8. 关闭运行期的魔术引用,魔术引用稍后将在 wp-settings.php 中通过 wpdb 添加。
  9. 设置 PHP5 的默认时区。
  10. 调用 wp_unregister_GLOBALS () 函数关闭 register_globals。
  11. unset 全局变量 $wp_filter, $cache_lastcommentmodified, $cache_lastpostdate,以确保他们不会存在。
  12. 调用函数 wp_fix_server_vars () 规范 $_SERVER 变量设置。
  13. 调用函数 wp_check_php_mysql_versions () 检查所需的 PHP 版本和 MySQL 扩展或数据库 drop-in。
  14. 调用函数 wp_favicon_request () 检查是否收到由于缺少 favicon.ico 的而产生请求。
  15. 检查是否处于维护模式。
  16. 开启加载计时器。
  17. 检查是否处于 WP_DEBUG 模式。
  18. 根据 WP_CACHE 和 WP_DEBUG 常量判断是否载入以及以何种方式载入文件:1.WP_CONTENT_DIR/advanced-cache.php,属于 drop-in,供高级的缓存插件使用。
  19. 调用 wp_set_lang_dir () 函数设置常量 WP_LANG_DIR。
  20. 调用 require_wp_db () 函数,引入 wpdb 类,或者数据库 drop-in db.php (如果存在的话)。
  21. 调用 wp_set_wpdb_vars () 函数,设置数据库表前缀和数据库表列的格式说明符
  22. 调用 wp_start_object_cache () 函数,开启 WP 对象缓存,或者扩展对象缓存(如果相应 drop-in 存在的话)。
  23. 加载 WP 文件:
    1. WPINC/default-filters.php,为 WP 中的钩子设置默认的 action 和 filter;
  24. 如果开启了多站点,则加载文件;否则设置常量 MULTISITE 为 false:
    1. WPINC/ms-blogs.php,定义一组 Site/blog 函数,用于操作 blogs 表及相关数据;
    2. WPINC/ms-settings.php(涉及多站点的文件暂不考虑)。
  25. ———— 如果只需要基本功能(即 SHORTINIT 常量为真),则 wp-setting.php 文件执行到此即返回!————
  26. 调用 wp_not_installed () 函数,如果还没有安装 WP,则启动安装程序。
  27. 加载 WP 的 * 大头(most of WP)*:
    1. WPINC/capabilities.php,定义一组类 WP_Roles, WP_Role, WP_User 和函数,用于操作角色和权限;
    2. WPINC/post.php,定义一组文章相关的函数,并添加 add_action (‘init’, ‘create_initial_post_types’, 0);
    3. WPINC/rewrite.php, 定义一组 WP 的重写 API 以及 WP_Rewrite 类,用于重写链接的格式;并且该文件还定义了一组常量 EP_NONE,EP_PERMALINK,EP_ATTACHMENT,EP_DATE,EP_YEAR,EP_MONTH,EP_DAY,EP_ROOT,EP_COMMENTS,EP_SEARCH,EP_CATEGORIES,EP_TAGS,EP_AUTHORS,EP_PAGES,EP_ALL;
    4. WPINC/kses.php, 定义一组 HTML/XHTML 的过滤器 API,并定义一组标签数组,添加了两个 action:add_action (‘init’, ‘kses_init’);add_action (‘set_current_user’, ‘kses_init’);
    5. WPINC/script-loader.php,WP 中脚本和样式表的默认加载器 API,并加载了如下文件:
      • /class.wp-styles.php,定义类 WP_Styles,继承自 WP_Dependencies,用于反压样式表队列;
    6. 并添加了如下的 action 和 filter:
      • add_action( ‘wp_default_scripts’, ‘wp_default_scripts’ );
      • add_filter( ‘wp_print_scripts’, ‘wp_just_in_time_script_localization’ );
      • add_filter( ‘print_scripts_array’, ‘wp_prototype_before_jquery’ );
      • add_action( ‘wp_default_styles’, ‘wp_default_styles’ );
      • add_filter( ‘style_loader_src’, ‘wp_style_loader_src’, 10, 2 );
    7. WPINC/update.php,定义一组 API 用于检查版本升级信息,添加了一组 action,并进行事件调度:
      • add_action( ‘admin_init’, ‘_maybe_update_core’ );
      • add_action( ‘wp_version_check’, ‘wp_version_check’ );
      • add_action( ‘load-plugins.php’, ‘wp_update_plugins’ );
      • add_action( ‘load-update.php’, ‘wp_update_plugins’ );
      • add_action( ‘load-update-core.php’, ‘wp_update_plugins’ );
      • add_action( ‘admin_init’, ‘_maybe_update_plugins’ );
      • add_action( ‘wp_update_plugins’, ‘wp_update_plugins’ );
      • add_action( ‘load-themes.php’, ‘wp_update_themes’ );
      • add_action( ‘load-update.php’, ‘wp_update_themes’ );
      • add_action( ‘load-update-core.php’, ‘wp_update_themes’ );
      • add_action( ‘admin_init’, ‘_maybe_update_themes’ );
      • add_action( ‘wp_update_themes’, ‘wp_update_themes’ );
    8. WPINC/canonical.php,定义一组重定向规范函数,用于处理 WP 中重定向,并添加 action:
      • add_action(‘template_redirect’, ‘redirect_canonical’);
    9. WPINC/shortcodes.php,定义一组 WP 的简码 API,并定义数组 $shortcode_tags,添加 filter:
      • add_filter(‘the_content’, ‘do_shortcode’, 11);
    10. WPINC/media.php,定义一组媒体(视频、图片等)显示相关的 API 和类 WP_Embed,并创建 $wp_embed = new WP_Embed () 变量,添加简码:
      • add_shortcode(‘wp_caption’, ‘img_caption_shortcode’);
      • add_shortcode(‘caption’, ‘img_caption_shortcode’);
      • add_shortcode(‘gallery’, ‘gallery_shortcode’);
    11. WPINC/widgets.php,定义一组创建动态侧边栏的 API 和类 WP_Widget,WP_Widget_Factory,并定义了一组全局变量;
  28. 加载多站点特定文件:
    1. WPINC/ms-functions.php,
    2. WPINC/ms-default-filters.php,
    3. WPINC/ms-deprecated.php。
  29. 调用 wp_plugin_directory_constants () 函数,定义依赖于 API 获取默认值的常量,定义必须使用的插件文件夹常量,后者可能会在 sunrise.php drop-in 中被覆盖。
  30. 利用函数 wp_get_mu_plugins () 加载必须使用的插件,并触发挂载点 do_action ( ‘muplugins_loaded’);
  31. 调用函数 ms_cookie_constants () 为多站点设置 cookie 常量。
  32. 调用函数 wp_cookie_constants () 在多站点加载后定义常量,cookie 相关的常量可能会在 ms_network_cookies () 中被覆盖。
  33. 调用函数 wp_ssl_constants () 定义和执行 SSL 常量。
  34. 加载文件创建公共全局变量:
    1. WPINC/vars.php,为 WP 的剩余部分创建公共变量。
  35. 调用函数 create_initial_taxonomies () 和 create_initial_post_types () 使分类和文章对插件和主题可见。插件作者需要注意:这些在初始化 hook 时会被再次注册。
  36. 利用函数 wp_get_active_and_valid_plugins () 加载已激活的插件。
  37. 调用函数 wp_set_internal_encoding () 设置内部编码。
  38. 如果 WP_CACHE 开启并且 wp_cache_postload () 函数存在,则调用该函数。
  39. 触发挂载点 do_action (‘plugins_loaded’)。
  40. 调用函数 wp_functionality_constants () 定义那些尚未被定义但会影响功能的常量。
  41. 调用函数 wp_magic_quotes () 添加魔术引用并装配 $_REQUEST ( $_GET + $_POST)。
  42. 触发挂载点 do_action (‘sanitize_comment_cookies’)(无害的评论 cookie)。
  43. 创建全局的 WP 查询对象 $wp_the_query =& new WP_Query (),并保存 $wp_the_query 的引用到 $wp_query,使用 $wp_query 进行查询。
  44. 创建 WP 的重写对象 $wp_rewrite =& new WP_Rewrite (),以创建漂亮的 URLs。
  45. 创建 WP 对象 $wp =& new WP ()。
  46. 创建 WP Widget 工厂对象 $wp_widget_factory =& new WP_Widget_Factory ()。
  47. 触发挂载点 do_action (‘setup_theme’)。
  48. 调用函数 wp_templating_constants () 设置模板相关常量。
  49. 调用函数 load_default_textdomain () 加载默认的文本本地化域。
  50. 找到博客区域设置 $locale = get_locale ()。
  51. 创建本地化对象 $wp_locale =& new WP_Locale () 用以加载本地化域数据和各种字符串。
  52. 加载激活的主题的函数库文件:
    1. TEMPLATEPATH/functions.php,加载模板自带函数。
  53. 触发挂载点 do_action (‘after_setup_theme’)。
  54. 注册关闭函数 register_shutdown_function (‘shutdown_action_hook’)。
  55. 建立当前用户 $wp->init ()。
  56. 触 发挂载点 do_action (‘init’),在这个阶段 WP 的大部分已被加载,用户也已认证。WP 会继续加载 init 钩子上的挂载者,如 widgets 和各种插件实例。如果你想在 WP 加载后插入一个 action,请使用下面的 wp_loaded 钩子。
  57. 如果是多站点,则检查站点的状态。
  58. 触发挂载点 do_action (‘wp_loaded’),当 WP、所有插件以及主题都被完全加载和实例化后,该钩子将被解除。Ajax 请求应该使用 wp-admin/admin-ajax.php,admin-ajax.php 能够处理未登录用户的请求。

内容处理阶段

在这一阶段,调用 wp () 函数对数据库内容进行查询,并将查询的内容赋值给一些全局变量,方便在模板中使用模板标签获取相应的数据并展示在前端。

  1. 调用 wp () 函数。
  2. 调用 $wp->main () 函数。
  3. 初始化,调用 wp_get_current_user () 函数 (pluggable.php 中),获取当前用户信息,即设置全局变量 $current_user。
  4. 调用 parse_request () 函数,对查询参数进行解析。
  5. 调用 send_headers () 函数,发送附加的 http 头信息。
  6. 调用 query_posts () 函数,进行查询操作。
  7. 调用 handle_404 () 函数,处理 404 错误。
  8. 调用 register_globals () 函数,注册全局变量。
  9. 调用 do_action_ref_array () 函数 (在 wp-includes/plugin.php 文件中),设置本对象作为 wp 钩子上的函数的参数。

主题应用阶段

WordPress 主题的路由和加载主要在 WPINC/template-loader.php 文件中进行,该文件相当于是一个模板加载的路由器,根据 url 加载相应的模板。

  1. 如果 WP_USE_THEMES 常量为真,则触发挂载点 do_action (‘template_redirect’);
  2. 根据判断函数 is_robots (), is_feed () 和 is_trackback () 的返回结果,处理 feeds 和 trackbacks,即使没有使用任何主题;
  3. 如果 WP_USE_THEMES 常量为真,则根据下列判断函数的结果,调用相应函数获取主题:
    • is_404()–>get_404_template()
    • is_search()–>get_search_template()
    • is_tax()–>get_taxonomy_template()
    • is_front_page()–>get_front_page_template()
    • is_home()–>get_home_template()
    • is_attachment()–>get_attachment_template()
    • is_single()–>get_single_template()
    • is_page()–>get_page_template()
    • is_category()–>get_category_template()
    • is_tag()–>get_tag_template()
    • is_author()–>get_author_template()
    • is_date()–>get_date_template()
    • is_archive()–>get_archive_template()
    • is_comments_popup()–>get_comments_popup_template()
    • is_paged()–>get_paged_template()
    • Other–>get_index_template()
  4. 如果对主题应用 filter 成功 apply_filters (‘template_include’, $template),则加载该主题。

模板路由完成以后,被调用的模板会被加载,模板中的模板标签也会访问在内容准备阶段所设置的全局变量,获取所需的数据,并且将这些数据输出到模板中,最终完成样式 + 内容在前端的显示!