WordPress：查询字符串转静态URL及htaccess路径配置技术咨询

Hey Nijesh, let's break down your two WordPress URL-related questions with practical solutions:

If you want to convert a URL like http://example.com/payment/?username=nijesh to http://example.com/nijesh and block direct access to /payment/, add these rules to your site's root .htaccess file (make sure to place them before the default WordPress rewrite block):

# Enable rewrite engine
RewriteEngine On

# Block direct access to /payment/ (return 404)
RewriteRule ^payment/$ - [R=404,L]

# Rewrite /payment/?username=xxx to /xxx (301 permanent redirect)
RewriteCond %{QUERY_STRING} ^username=([^&]+)$
RewriteRule ^payment/$ /%1? [R=301,L]

• The R=404 rule ensures anyone trying to visit /payment/ directly gets a "Not Found" error.
• The R=301 rule performs a 301 permanent redirect, which is good for SEO. The trailing ? in the target URL clears the original query string.

Yes, WordPress has a robust built-in rewrite API that's the standard way to handle this kind of URL transformation (better than relying solely on .htaccess, since it integrates with WP's routing system). Here's how to set it up:

Step 1: Register a Rewrite Tag & Rule #

Add this code to your theme's functions.php file (or a custom plugin for better maintainability):

function custom_username_rewrite() {
    // Register a query variable to capture the username
    add_rewrite_tag('%username%', '([^/]+)');
    
    // Add the rewrite rule: map /{username} to ?username={username}
    add_rewrite_rule(
        '^([^/]+)/?$',
        'index.php?username=$matches[1]',
        'top'
    );
}
add_action('init', 'custom_username_rewrite');

Step 2: Flush Rewrite Rules #

After adding the code, you need to flush WordPress's rewrite rules to make the new rule active:

• Go to Settings > Permalinks in your WP admin.
• You don't need to change anything—just click the Save Changes button. This triggers a flush of the rewrite rules.

Step 3: Handle the Query Variable #

Now, you can access the username query variable in your theme templates or custom code to load the relevant content. For example, in your index.php (or a custom template):

$username = get_query_var('username');
if ($username) {
    // Load content for the user with this username
    // e.g., fetch user data, display payment page content, etc.
    echo "Welcome, $username!";
    // You can also redirect to a specific template if needed
    // get_template_part('templates/payment-user');
}

Bonus: Redirect Old Query String URLs #

To ensure old URLs like http://example.com/payment/?username=nijesh redirect to the new static URL, you can add a small function to handle the redirect:

function redirect_old_username_url() {
    if (isset($_GET['username']) && is_page('payment')) {
        $username = sanitize_text_field($_GET['username']);
        wp_redirect(home_url("/$username/"), 301);
        exit;
    }
}
add_action('template_redirect', 'redirect_old_username_url');

This approach is fully WordPress-native, works across different server environments (not just Apache), and integrates seamlessly with WP's permalink system.

内容的提问来源于stack exchange，提问作者Nijesh W