借一步网

标签： PHP

  • WordPress 中 URL 重写规则

    在 WordPress 中，URL 重写规则是通过一个称为“重写 API”的机制来管理的。这个机制允许 WordPress 将用户友好的 URL（如 /about-us/）映射到实际的查询字符串（如 index.php?p=123）。以下是 WordPress URL 重写规则的基本概念和工作原理：

    1. 重写规则的基本概念

    • 友好的 URL：WordPress 允许用户使用更易读的 URL 结构，这些 URL 通常与内容相关，而不是包含复杂的查询参数。
    • 重写规则：这些规则定义了如何将请求的 URL 转换为 WordPress 可以理解的查询参数。

    2. 重写 API

    WordPress 的重写 API 主要通过以下几个函数来实现：

    • add_rewrite_rule()：用于添加自定义的重写规则。
    • add_rewrite_tag()：用于添加自定义的重写标签，以便在 URL 中使用。
    • flush_rewrite_rules()：用于刷新重写规则，通常在主题或插件激活时调用。

    3. 默认重写规则

    WordPress 默认提供了一些重写规则，主要包括：

    • 文章：/year/month/day/post-name/（例如 /2023/10/01/my-post/）
    • 页面：/page-name/（例如 /about-us/）
    • 分类：/category/category-name/（例如 /category/news/）
    • 标签：/tag/tag-name/（例如 /tag/wordpress/）

    4. 自定义重写规则示例

    以下是一个简单的示例，展示如何添加自定义重写规则：

    function custom_rewrite_rule() {
    add_rewrite_rule(
        '^custom/([^/]*)/?', // 匹配的 URL
        'index.php?pagename=custom-page&param=matches[1]', // 重写到的查询         'top' // 优先级     ); } add_action('init', 'custom_rewrite_rule');</code></pre> <!-- /wp:code -->  <!-- wp:paragraph --> 在这个示例中，当用户访问 <code>/custom/some-value/</code> 时，WordPress 会将其重写为 <code>index.php?pagename=custom-page&param=some-value</code>。 <!-- /wp:paragraph -->  <!-- wp:heading {"level":3} --> <h3 class="wp-block-heading">5. 刷新重写规则</h3> <!-- /wp:heading -->  <!-- wp:paragraph --> 在添加或修改重写规则后，通常需要刷新重写规则。可以通过访问 WordPress 管理后台的``设置'' -> ``固定链接''页面来自动刷新，或者在代码中调用 <code>flush_rewrite_rules()</code>： <!-- /wp:paragraph -->  <!-- wp:code --> <pre class="wp-block-code"><code>function my_plugin_activation() {     custom_rewrite_rule(); // 添加自定义重写规则     flush_rewrite_rules(); // 刷新重写规则 } register_activation_hook(__FILE__, 'my_plugin_activation');</code></pre> <!-- /wp:code -->  <!-- wp:heading {"level":3} --> <h3 class="wp-block-heading">6. 使用重写标签</h3> <!-- /wp:heading -->  <!-- wp:paragraph --> 重写标签允许你在 URL 中使用动态部分。例如： <!-- /wp:paragraph -->  <!-- wp:code --> <pre class="wp-block-code"><code>function custom_rewrite_tag() {     add_rewrite_tag('%custom_param%', '([^&]+)'); } add_action('init', 'custom_rewrite_tag');</code></pre> <!-- /wp:code -->  <!-- wp:paragraph --> 然后可以在重写规则中使用这个标签： <!-- /wp:paragraph -->  <!-- wp:code --> <pre class="wp-block-code"><code>function custom_rewrite_rule() {     add_rewrite_rule(         '^custom/([^/]*)/?',         'index.php?pagename=custom-page&custom_param=matches[1]',
        'top'
    );
}
add_action('init', 'custom_rewrite_rule');

    总结

    WordPress 的 URL 重写规则通过重写 API 提供了强大的功能，允许开发者创建用户友好的 URL。通过使用 add_rewrite_rule() 和 add_rewrite_tag()，可以轻松地添加自定义规则和标签。记得在修改规则后刷新重写规则，以确保新规则生效。

  • WordPress 源码解析【1】

    <?php
/**
 * Front to the WordPress application. This file doesn't do anything, but loads
 * wp-blog-header.php which does and tells WordPress to load the theme.
 *
 * @package WordPress
 */

/**
 * Tells WordPress to load the WordPress theme and output it.
 *
 * @var bool
 */
define( 'WP_USE_THEMES', true ); // 定义常量 WP_USE_THEMES 为 true，表示启用主题支持

/** Loads the WordPress Environment and Template */
require __DIR__ . '/wp-blog-header.php'; // 引入 wp-blog-header.php 文件，加载 WordPress 环境和模板

    逐行
    解析：

    1. <?php：开始 PHP 代码块。
    2. /** ... */：注释，描述该文件的功能，说明这是 WordPress 应用程序的前端文件。
    3. define( 'WP_USE_THEMES', true );：定义一个常量 WP_USE_THEMES，设置为 true，表示启用主题。
    4. require __DIR__ . '/wp-blog-header.php';：引入 wp-blog-header.php 文件，加载 WordPress 的环境和模板。__DIR__ 是当前文件的目录路径。

    这段代码是 WordPress 的引导文件 wp-load.php，主要用于设置 ABSPATH 常量并加载 wp-config.php 文件。以下是逐行

    解析：

    <?php
/**
 * Bootstrap file for setting the ABSPATH constant
 * and loading the wp-config.php file. The wp-config.php
 * file will then load the wp-settings.php file, which
 * will then set up the WordPress environment.
 *
 * If the wp-config.php file is not found then an error
 * will be displayed asking the visitor to set up the
 * wp-config.php file.
 *
 * Will also search for wp-config.php in WordPress' parent
 * directory to allow the WordPress directory to remain
 * untouched.
 *
 * @package WordPress
 */
    • 这部分是文件的文档注释，描述了文件的功能和用途。
    /** Define ABSPATH as this file's directory */
if ( ! defined( 'ABSPATH' ) ) {
    define( 'ABSPATH', __DIR__ . '/' );
}
    • 检查 ABSPATH 常量是否已定义，如果没有，则将其定义为当前文件的目录。
    /*
 * The error_reporting() function can be disabled in php.ini. On systems where that is the case,
 * it's best to add a dummy function to the wp-config.php file, but as this call to the function
 * is run prior to wp-config.php loading, it is wrapped in a function_exists() check.
 */
if ( function_exists( 'error_reporting' ) ) {
    /*
     * Initialize error reporting to a known set of levels.
     *
     * This will be adapted in wp_debug_mode() located in wp-includes/load.php based on WP_DEBUG.
     * @see https://www.php.net/manual/en/errorfunc.constants.php List of known error levels.
     */
    error_reporting( E_CORE_ERROR | E_CORE_WARNING | E_COMPILE_ERROR | E_ERROR | E_WARNING | E_PARSE | E_USER_ERROR | E_USER_WARNING | E_RECOVERABLE_ERROR );
}
    • 检查 error_reporting 函数是否存在，如果存在，则初始化错误报告级别，以便在开发过程中捕获错误。
    /*
 * If wp-config.php exists in the WordPress root, or if it exists in the root and wp-settings.php
 * doesn't, load wp-config.php. The secondary check for wp-settings.php has the added benefit
 * of avoiding cases where the current directory is a nested installation, e.g. / is WordPress(a)
 * and /blog/ is WordPress(b).
 *
 * If neither set of conditions is true, initiate loading the setup process.
 */
if ( file_exists( ABSPATH . 'wp-config.php' ) ) {

    /** The config file resides in ABSPATH */
    require_once ABSPATH . 'wp-config.php';

} elseif ( @file_exists( dirname( ABSPATH ) . '/wp-config.php' ) && ! @file_exists( dirname( ABSPATH ) . '/wp-settings.php' ) ) {

    /** The config file resides one level above ABSPATH but is not part of another installation */
    require_once dirname( ABSPATH ) . '/wp-config.php';

} else {
    • 检查 wp-config.php 文件是否存在于 WordPress 根目录中。如果存在，则加载该文件。如果不存在，则检查其父目录中是否存在该文件，并且确保 wp-settings.php 不存在，以避免嵌套安装的情况。
        // A config file doesn't exist.

    define( 'WPINC', 'wp-includes' );
    require_once ABSPATH . WPINC . '/version.php';
    require_once ABSPATH . WPINC . '/compat.php';
    require_once ABSPATH . WPINC . '/load.php';

    // Check for the required PHP version and for the MySQL extension or a database drop-in.
    wp_check_php_mysql_versions();

    // Standardize _SERVER variables across setups.     wp_fix_server_vars();      define( 'WP_CONTENT_DIR', ABSPATH . 'wp-content' );     require_once ABSPATH . WPINC . '/functions.php';</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>如果 <code>wp-config.php</code> 文件不存在，则定义 <code>WPINC</code> 常量并加载一些必要的文件，包括版本信息、兼容性文件和加载文件。接着检查 PHP 版本和 MySQL 扩展，并标准化 <code>_SERVER 变量。
    path = wp_guess_url() . '/wp-admin/setup-config.php';      // Redirect to setup-config.php.     if ( ! str_contains(_SERVER['REQUEST_URI'], 'setup-config' ) ) {
        header( 'Location: ' . path );         exit;     }</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>生成 <code>setup-config.php</code> 的路径，并检查当前请求的 URI 是否包含 <code>setup-config</code>，如果没有，则重定向到该路径。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:code --> <pre class="wp-block-code"><code>    wp_load_translations_early();      // Die with an error message.die = '<p>' . sprintf(
        /* translators: %s: wp-config.php */
        __( "There doesn't seem to be a %s file. It is needed before the installation can continue." ),
        '<code>wp-config.php</code>'
    ) . '</p>';
    die .= '' . sprintf(         /* translators: 1: Documentation URL, 2: wp-config.php */         __( 'Need more help? <a href="%1s">Read the support article on %2s</a>.' ),         __( 'https://developer.wordpress.org/advanced-administration/wordpress/wp-config/' ),         '<code>wp-config.php</code>'     ) . '';die .= '<p>' . sprintf(
        /* translators: %s: wp-config.php */
        __( "You can create a %s file through a web interface, but this doesn't work for all server setups. The safest way is to manually create the file." ),
        '<code>wp-config.php</code>'
    ) . '</p>';
    die .= '<a href="' .path . '" class="button button-large">' . __( 'Create a Configuration File' ) . '</a></p>';

    wp_die( die, __( 'WordPress › Error' ) ); }</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>加载翻译文件，并构建一个错误消息，提示用户缺少 <code>wp-config.php</code> 文件。最后调用 <code>wp_die()</code> 函数终止执行并显示错误信息。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:paragraph --> 这段代码的主要目的是确保 WordPress 环境的正确设置，并在缺少必要配置文件时提供用户友好的错误提示。 <!-- /wp:paragraph -->  <!-- wp:separator --> <hr class="wp-block-separator has-alpha-channel-opacity"/> <!-- /wp:separator -->  <!-- wp:paragraph --> 以下是对 <code>wp-includes/user.php</code> 文件中 <code>_wp_get_current_user</code> 函数的逐行解析： <!-- /wp:paragraph -->  <!-- wp:code --> <pre class="wp-block-code"><code>/**  * Retrieves the current user object.  *  * Will set the current user, if the current user is not set. The current user  * will be set to the logged-in person. If no user is logged-in, then it will  * set the current user to 0, which is invalid and won't have any permissions.  *  * This function is used by the pluggable functions wp_get_current_user() and  * get_currentuserinfo(), the latter of which is deprecated but used for backward  * compatibility.  *  * @since 4.5.0  * @access private  *  * @see wp_get_current_user()  * @global WP_Usercurrent_user Checks if the current user is set.
 *
 * @return WP_User Current WP_User instance.
 */
  • 这是函数的文档注释，描述了函数的功能、使用场景和返回值。它说明了如何获取当前用户对象，并在没有用户登录时将其设置为无效值（0）。
function _wp_get_current_user() {
    global current_user;</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>定义了 <code>_wp_get_current_user</code> 函数，并声明使用全局变量 <code>current_user，该变量用于存储当前用户对象。





    if ( ! empty( current_user ) ) {         if (current_user instanceof WP_User ) {
            return current_user;         }</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>检查 <code>current_user 是否不为空。如果不为空且是 WP_User 的实例，则直接返回当前用户对象。





        // Upgrade stdClass to WP_User.
        if ( is_object( current_user ) && isset(current_user->ID ) ) {
            cur_id       =current_user->ID;
            current_user = null;             wp_set_current_user(cur_id );
            return current_user;         }</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>如果 <code>current_user 是一个对象且具有 ID 属性，则将其视为需要升级的对象。保存当前用户的 ID，清空 current_user</code>，然后调用 <code>wp_set_current_user</code> 函数设置当前用户为该 ID，并返回当前用户（此时仍为 null）。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:code --> <pre class="wp-block-code"><code>        //current_user has a junk value. Force to WP_User with ID 0.
        current_user = null;         wp_set_current_user( 0 );         returncurrent_user;
    }





    

  • 如果 current_user</code> 具有无效值，则将其设置为 null，并将当前用户强制设置为 ID 为 0 的用户（无效用户），然后返回当前用户（仍为 null）。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:code --> <pre class="wp-block-code"><code>    if ( defined( 'XMLRPC_REQUEST' ) && XMLRPC_REQUEST ) {         wp_set_current_user( 0 );         returncurrent_user;
    }





    

  • 检查是否为 XML-RPC 请求。如果是，则将当前用户设置为 ID 为 0 的用户，并返回当前用户。
    • 






    /**
     * Filters the current user.
     *
     * The default filters use this to determine the current user from the
     * request's cookies, if available.
     *
     * Returning a value of false will effectively short-circuit setting
     * the current user.
     *
     * @since 3.9.0
     *
     * @param int|false user_id User ID if one has been determined, false otherwise.      */user_id = apply_filters( 'determine_current_user', false );





    

  • 通过 apply_filters 调用 determine_current_user 过滤器，尝试从请求的 cookies 中确定当前用户的 ID。如果没有确定到用户 ID，则返回 false。
    • 






    if ( ! user_id ) {         wp_set_current_user( 0 );         returncurrent_user;
    }





    

  • 如果没有找到用户 ID，则将当前用户设置为 ID 为 0 的用户，并返回当前用户。
    • 






    wp_set_current_user( user_id );</code></pre> <!-- /wp:code -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>如果找到了用户 ID，则调用 <code>wp_set_current_user</code> 函数设置当前用户为该 ID。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:code --> <pre class="wp-block-code"><code>    returncurrent_user;
}





    

  • 最后返回当前用户对象。
    • 






总结





该函数的主要功能是获取当前用户对象，并在必要时设置当前用户。它处理了多种情况，包括用户未登录、用户对象无效以及 XML-RPC 请求等。通过使用过滤器，函数还允许开发者自定义当前用户的确定方式。










在 WordPress 中，过滤器（filter）机制是一种允许开发者修改或处理数据的机制。通过使用过滤器，开发者可以在特定的点插入自定义代码，以改变函数的行为或输出。以下是过滤器机制的详细
解析：






/**
 * Filters the current user.
 *
 * The default filters use this to determine the current user from the
 * request's cookies, if available.
 *
 * Returning a value of false will effectively short-circuit setting
 * the current user.
 *
 * @since 3.9.0
 *
 * @param int|false user_id User ID if one has been determined, false otherwise.  */user_id = apply_filters( 'determine_current_user', false );
if ( ! user_id ) {     wp_set_current_user( 0 );     returncurrent_user;
}





过滤器机制的工作原理





    

  • 定义过滤器：
    • 






    

  • 在代码中，apply_filters 函数用于调用一个名为 'determine_current_user' 的过滤器。这个过滤器的作用是允许其他开发者在这个点插入自定义逻辑，以确定当前用户的 ID。
    • 






    

  • 传递参数：
    • 






    

  • apply_filters 函数的第二个参数是默认值，这里是 false。这意味着如果没有其他代码修改这个值，user_id</code> 将保持为 <code>false</code>。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li><strong>注册过滤器</strong>：</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>开发者可以使用 <code>add_filter</code> 函数来注册一个自定义的过滤器。例如：add_filter( 'determine_current_user', 'my_custom_user_function' );</li> <!-- /wp:list-item -->  <!-- wp:list-item --> <li>在这个例子中，<code><em><strong>my_custom_user_function</strong></em></code> 是一个自定义函数，它会在调用 <code>apply_filters</code> 时被执行。这个函数可以根据请求的 cookies 或其他条件来返回一个用户 ID。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li><strong>返回值</strong>：</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>如果 <code>my_custom_user_function</code> 返回一个有效的用户 ID，<code>user_id 将被设置为该 ID。如果返回 false，则 user_id</code> 仍然是 <code>false</code>。</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li><strong>短路逻辑</strong>：</li> <!-- /wp:list-item --></ul> <!-- /wp:list -->  <!-- wp:list --> <ul class="wp-block-list"><!-- wp:list-item --> <li>如果 <code>user_id 为 false，代码会执行 wp_set_current_user( 0 )，将当前用户设置为无效用户（ID 为 0），并返回当前用户对象。
    • 






总结





过滤器机制使得 WordPress 的功能具有高度的可扩展性和灵活性。开发者可以通过注册自定义过滤器来改变核心功能的行为，而不需要直接修改核心代码。这种设计模式使得 WordPress 能够支持大量的插件和主题，允许开发者根据自己的需求进行定制。
人生梦想 - 关注前沿的计算机技术 acejoy.com 🐾 步子哥の博客 🐾 背多分论坛 🐾 知差（chai）网
快取状态: No
内存使用量: 10.0127 MB
资料库查询次数: 15
页面产生时间: 0.376 (秒)