パーマリンク構造 WordPress

WordPressの表示フローは概ね以下のようになる。

パーマリンク生成

設定 > パーマリンクからリライトルールを設定
WordPressはパーマリンクを作成
- 新規投稿時や記事/アーカイブ表示時にget_permalink()関数で、1で設定したリライトルールに沿ってprettyパーマリンクを生成

投稿表示

WordPressは↑のprettyパーマリンクを、リライトルールに応じてuglyパーマリンクに変換
uglyパーマリンクのquery_varsに応じて対象を抽出して表示する

Ref

概要

WordPressのパーマリンクは大きく2つに分けられる。

デフォルト：Uglyパーマリンク（例: https://example.com/index.php?p=12345&cat=123）
mod_rewrite：Prettyパーマリンク（例: https://example.com/sample/12345）

本記事ではPrettyパーマリンクがUglyパーマリンクに変換されるフローを記載する。

※ Prettyパーマリンクの構造は、基本的に設定 > パーマリンクから指定する。 ※ 個々の投稿のパーマリンク文字列自体はDBに保存されていない。permalink_structureの設定と投稿データ（post_nameなど）から、リクエストのたびに動的に組み立てられる。

リライトの流れ

設定 > パーマリンクで設定を変更
上記設定によってwp_options.option_nameのrewrite_rules（WP_Rewrite::rules）が決まる

アクセス

Prettyパーマリンクでアクセス（例: https://example.com/category-sample/1）
PrettyパーマリンクをWP_Rewrite::rulesをもとにUglyパーマリンクに変換（例: https://example.com?p=1&category-name=category-sample&page=）
Uglyパーマリンクのパブリッククエリをもとに、投稿抽出クエリの条件であるWP_Query::query_varsが設定され、投稿抽出SQLが発行される

サイト表示時、HTTPリクエストを受け取って起動したWordPressは、リクエストに含まれるクエリ文字列やURLの一部を「パブリッククエリ変数」として解釈し、それをもとにWordPressクエリを組み立てて実行する（参考: プライム・ストラテジー株式会社『詳解WordPress』p.95付近の解説を要約）。

パブリック変数はwp-includes/class-wp.phpで定義されている。

<?php
/**
 * WordPress environment setup class.
 *
 * @package WordPress
 * @since 2.0.0
 */
class WP {
	/**
	 * Public query variables.
	 *
	 * Long list of public query variables.
	 *
	 * @since 2.0.0
	 * @var string[]
	 */
	public $public_query_vars = array( 'm', 'p', 'posts', 'w', 'cat', 'withcomments', 'withoutcomments', 's', 'search', 'exact', 'sentence', 'calendar', 'page', 'paged', 'more', 'tb', 'pb', 'author', 'order', 'orderby', 'year', 'monthnum', 'day', 'hour', 'minute', 'second', 'name', 'category_name', 'tag', 'feed', 'author_name', 'pagename', 'page_id', 'error', 'attachment', 'attachment_id', 'subpost', 'subpost_id', 'preview', 'robots', 'favicon', 'taxonomy', 'term', 'cpage', 'post_type', 'embed' );

リライトルール

パブリッククエリをリライトルールに沿って解釈し、問い合わせ（SQL）を発行して投稿を取得する。

アクセス時のパブリッククエリはWP_Query::query_varsに格納される。

wp-settings.phpの中で、WordPressによるURLの解釈・リライトのために重要な2つのオブジェクト、$wp_queryと$wp_rewriteが初期化される（参考: Rewrite APIその1「Rewriteとパーマリンク」）。

WordPressのリライトルールは、グローバル変数$wp_rewriteに格納されている。

DBテーブル

リライト関連の情報はwp_optionsに格納されている。以下に代表的なレコードを記載する。

option_name	option_value
permalink_structure	`/%category%/%post_id%`
rewrite_rules	マッチ規則の正規表現がシリアライズされて保存

リライトルールを追加

参考: WordPress パーマリンクリライトルール

add_rewrite_rule
add_rewrite_tag
pre_post_link（get_permalink()の中でapplyされる）
add_permastruct
rewrite_rules_arrayフィルター
flush_rewrite_rules()
- リライトルールは、コードでflush_rewrite_rules()を呼び出すか、管理画面のパーマリンク設定画面を開いて保存すると自動で反映される

プラグインでリライトルールを追加した際は、WordPressのデータベースにtransientキャッシュとして登録されているリライトルールを更新（flush_rewrite_rules()）する処理を忘れずに加える必要がある（参考: Rewrite APIその1「Rewriteとパーマリンク」）。

備考

$wp_rewrite

参考: WordPress パーマリンクリライトルール

// カスタム投稿タイプmanualのrewriteルールを追加
add_filter( 'rewrite_rules_array', function ( $rules ) {
    $new_rules = array(
        'manual/([0-9]+)/?$' => 'index.php?post_type=manual&p=$matches[1]',
    );

    return $new_rules + $rules;
});

add_filter( 'pre_post_link', function ( $permalink, $post, $leavename ) {
    // 投稿スラッグ（post_name）が数値のみの場合はカテゴリー付きの構造に切り替える例
    if ( is_numeric( $post->post_name ) ) {
        return '/%category%/%postname%';
    }
    // $permalink をカスタマイズ
    return $permalink;
}, 10, 3 );

add_filter( 'rewrite_rules_array', function ( $rules ) {
    $new_rules = array(
        'info/.+/([0-9a-zA-Z-_]+)$' => 'index.php?name=$matches[1]',
    );

    return $rules + $new_rules;
});

※ 元のコードには2点誤りがあった。

pre_post_linkフィルターの条件$post->ID !== $post->post_nameは、intとstringを厳密比較（!==）しているため常に真になり意味を成さない。スラッグが数値のみかどうかを判定するis_numeric( $post->post_name )に修正した。
3つ目のrewrite_rules_arrayの例で、'index.php?name=matches[1]'のmatches[1]の前に$が抜けており、実際には置換されない不具合があったため$matches[1]に修正した。