ドキュメント

Document

自分のための備忘録です。

リンク構造

Ref

WordPress Prettyパーマリンクのリライトルール

リライトの流れ

設定 > パーマリンクで設定を変更
上記設定によって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発行

Webサイト表示の場合HTTPリクエストを受け取って起動したWordPressは、HTTPリクエストに含まれるクエリ文字列またはURLの一部をWordPressのリクエスト変数として解釈し、WordPressクエリ文字列を実行します。HTTPリクエストに含めることができるクエリ変数をパブリッククエリ変数といいます。

O'Reilly 詳解WordPress プライム・ストラテジー株式会社 p95

パブリック変数は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-setting.phpの中に、WordPressによるURLの解釈、リライトのために重要な2つのオブジェクト、$wp_queryと$wp_rewriteが初期化されます。

Rewrite APIその1 「Rewriteとパーマリンク」（WordPressプラグイン開発のバイブルのボツ原稿から）

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

DBテーブル

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

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

リライトルールを追加

add_rewrite_rule
flush_rewrite_rules
- リライトルールはflush_rewrite_ruleをコードで呼び出すか、管理画面のパーマリンク画面を開くと自動で反映される

プラグインによるリライトルールの追加時に、WordPressのデータベースにtransientキャッシュとして登録されているリライトルールを変更する処理を加えなければなりません。

Rewrite APIその1 「Rewriteとパーマリンク」（WordPressプラグイン開発のバイブルのボツ原稿から）

備考

wp_rewrite