【WordPress×PHP】オブジェクトとクラスの基本を解説

はじめに

【WordPress×PHP】条件分岐タグでページを判定する方法では、ページの種類を調べる条件分岐タグを解説しました。

ここまでの回で、$wp_query->found_postsやSWELL_Theme::get_setting()のように、->（矢印）や::（コロン2つ）を使った書き方が何度か出てきました。今回は、この書き方のもとになっているオブジェクトとクラスの基本を解説します。自分でクラスを作れるようになるところまでは目指さず、WordPressやSWELLのコードを読めるようになることをゴールにします。

このシリーズの全15回の構成は、第1回の記事の冒頭にまとめています。

クラスとオブジェクトとは？

クラスは、データ（値）と、そのデータを使う処理（関数）をひとまとめにした「設計図」です。オブジェクトは、その設計図から作った「実物」です。

クラスの中の値をプロパティ、クラスの中の関数をメソッドと呼びます。

簡単な例で見てみましょう。本の「タイトル」と「価格」を持つBookというクラスです。

class Book {
	public $title;  // プロパティ
	public $price;  // プロパティ

	public function __construct( $title, $price ) {
		$this->title = $title;
		$this->price = $price;
	}

	public function get_label() {  // メソッド
		return $this->title . '（' . $this->price . '円）';
	}
}

$book1 = new Book( 'PHP入門', 2000 );
$book2 = new Book( 'WordPress入門', 2500 );

echo $book1->title;       // PHP入門
echo $book2->get_label(); // WordPress入門（2500円）

実行すると、コメントのとおり「PHP入門」と「WordPress入門（2500円）」が表示されました。

• new Book( … )で、設計図からオブジェクトを作る。1つのクラスから、中身の違うオブジェクトをいくつでも作れる
• __construct()は、newでオブジェクトを作ったときに自動で実行されるメソッド
• $thisは、クラスの中で「このオブジェクト自身」を指す

【PHP】関数の作り方と使い方を解説で解説した関数と、【PHP】配列の基本と使い方を解説で解説した配列を、ひとまとめにしたもの、とイメージすると分かりやすいでしょう。

「->」と「::」の違い

「->」：オブジェクトのプロパティとメソッド

->は、オブジェクトのプロパティやメソッドを使うときの書き方です。

$book1->title;        // プロパティを取り出す
$book2->get_label();  // メソッドを実行する

メソッドには()を付け、プロパティには付けません。

「::」：クラスに直接つながるもの

::は、オブジェクトを作らずに、クラスそのものに用意されているものを使うときの書き方です。主に次の3つがあります。

消費税の計算をするTaxクラスで試してみます。

class Tax {
	const RATE = 0.1;  // クラス定数

	public static function add( $price ) {  // 静的メソッド
		return (int) ( $price * ( 1 + self::RATE ) );
	}
}

echo Tax::RATE;        // 0.1
echo Tax::add( 2000 ); // 2200

実行すると「0.1」と「2200」が表示されました。newでオブジェクトを作らずに使えている点が、->との違いです。staticが付いたメソッドが静的メソッドです。また、クラスの中では、自分のクラスをself::で指します。

見分け方は、左側が変数（$で始まる）なら->、クラス名なら::です。

WordPressのオブジェクトを読む

WordPressでは、記事やカテゴリーのデータが、オブジェクトの形で渡されます。

記事のデータ：WP_Post

get_post()に投稿IDを渡すと、その記事のデータがWP_Postというクラスのオブジェクトで返ってきます。

$post_obj = get_post( 1 );

echo $post_obj->post_title;  // Hello world!
echo $post_obj->post_date;   // 2026-10-06 22:32:42

ローカル環境で調べると、WP_Postのオブジェクトには24個のプロパティがありました。よく使うものは次のとおりです。

そのほかの16個は、次のとおりです。

記事のURLを使いたいときは、guidではなく第5回で紹介したget_permalink()を使います。guidは記事を作った時点の値のまま変わらないため、パーマリンクの設定を変えると実際のURLと一致しなくなります。

SWELLのparts/single/post_head.phpでも、$post_data = get_post( $the_id );で記事のオブジェクトを受け取り、$post_data->post_authorで投稿者のIDを取り出しています。

カテゴリーのデータ：WP_Term

第5回で、get_the_category()は「カテゴリーの情報をまとめた配列」を返すと紹介しました。この配列の中身は、WP_Termというクラスのオブジェクトです。

$cats = get_the_category( 1 );

echo $cats[0]->name;     // 未分類
echo $cats[0]->slug;     // uncategorized
echo $cats[0]->count;    // 1（このカテゴリーの記事数）

$cats[0]で配列の1つ目を取り出し、その中のオブジェクトから->nameで名前を取り出しています。[ ]は配列、->はオブジェクト、と分けて読むのがポイントです。

メインクエリ：WP_Query

第6回の実務サンプルで使った$wp_queryは、WP_Queryというクラスのオブジェクトです。$wp_query->found_postsは、そのプロパティを取り出していたわけです。

実は、ループで使ったhave_posts()も、中で$wp_query->have_posts()というメソッドを呼び出しています。テンプレートタグの多くは、こうしたオブジェクトを使いやすくするための関数なのです。

SWELLのコードを読む

SWELLは、テーマの機能の多くをSWELL_Themeというクラスにまとめていて、::で使っています。ローカル環境で、実際に値を取り出してみました。

また、SWELLのファイルの冒頭には、次のような1行がよく出てきます。

use \SWELL_Theme as SWELL;

これは「このファイルの中では、SWELL_ThemeをSWELLという短い名前で呼びます」という意味です。そのため、SWELL::get_setting()とSWELL_Theme::get_setting()は同じものを指します。

よくあるエラー

オブジェクトの扱いを間違えたときに表示されるエラーを、ローカル環境で確かめました（ファイルの場所は省略しています）。

オブジェクトを配列のように書いた

$post_obj = get_post( 1 );
echo $post_obj['post_title'];

Fatal error: Uncaught Error: Cannot use object of type WP_Post as array

これは「WP_Postのオブジェクトを配列として使うことはできません」という意味です。$post_obj->post_titleと書きます。

存在しない記事のプロパティを取り出した

$post_obj = get_post( 9999 );  // 存在しない投稿ID
echo $post_obj->post_title;

Warning: Attempt to read property "post_title" on null

get_post()は、記事が見つからないとnull（何もない）を返します。nullからプロパティを取り出そうとして、警告が出ました。これは警告なので、処理は止まらずに続きます。取り出す前に、if ( $post_obj )で確認しておきましょう。

存在しないメソッドを呼び出した

Fatal error: Uncaught Error: Call to undefined method WP_Post::get_title()

WP_Postにはget_title()というメソッドはありません。タイトルは->post_title（プロパティ）で取り出します。

WP_Postで、存在しないプロパティ名（たとえば$post_obj->title）を書いても、エラーにはならず、空の文字列が返ってきました。WP_Postには、知らない名前のプロパティを指定されたときに、その名前のカスタムフィールド（第14回で解説します）を探す仕組みがあるためです。エラーが出ないぶん気付きにくいので、プロパティ名は正確に書きましょう。

実務サンプル：記事の文字数と読み終わるまでの目安を表示する

ここまでの内容を使って、記事のタイトルの上に「この記事は約1,200文字です（読み終わるまでの目安：約3分）」と表示してみましょう。

子テーマのfunctions.phpに、次のコードを追加します。

/**
 * 記事の文字数と、読み終わるまでの目安時間をタイトルの上に表示する
 */
add_action( 'swell_before_post_head', function( $post_id ) {
	$post_obj = get_post( $post_id );
	if ( ! $post_obj ) {
		return;
	}

	$text    = wp_strip_all_tags( $post_obj->post_content );
	$text    = preg_replace( '/\s+/u', '', $text );
	$length  = mb_strlen( $text );
	$minutes = max( 1, (int) ceil( $length / 500 ) );

	echo '<p class="kurumico-reading-time">この記事は約' . number_format( $length )
		. '文字です（読み終わるまでの目安：約' . $minutes . '分）</p>';
} );

子テーマのstyle.cssには、次のCSSを追加します。

.kurumico-reading-time {
	margin-bottom: 1.5em;
	font-size: .85em;
	color: #666;
}

本文が1,200文字の記事を開くと、次のように表示されました。

コードのポイントは次のとおりです。

• get_post()で記事のオブジェクト（WP_Post）を受け取り、->post_contentで本文を取り出している
• 記事が見つからなかったとき（null）に備えて、if ( ! $post_obj )で確認してから使っている
• wp_strip_all_tags()でHTMLタグを取り除き、preg_replace()で空白と改行を取り除いてから、mb_strlen()で文字数を数えている
• 1分あたり500文字として、ceil()（小数点以下の切り上げ）で分数を計算している。1,200文字なら2.4分なので、切り上げて3分

500の部分を変えれば、目安の速さを調整できます。

よくある質問・エラー対処

Q. オブジェクトにどんなプロパティがあるか調べたいです

→ ローカル環境で、var_dump( $post_obj );やprint_r( $post_obj );を実行すると、中身がすべて表示されます。WordPressの公式リファレンス（developer.wordpress.org）で、クラス名（WP_Postなど）を調べる方法もあります。

Q. 「?->」という書き方を見かけました

→ PHP 8から使えるようになった書き方（nullsafe演算子）です。$post_obj?->post_titleと書くと、$post_objがnullのときは警告を出さずにnullを返します。ローカル環境でも、存在しない記事に使って警告が出ないことを確認しました。

おわりに（まとめ）

次回は、アクションフック（add_action）について解説予定です。

この記事が、少しでも誰かのお役に立てれば幸いです。

関連記事

• 【WordPress×PHP】条件分岐タグでページを判定する方法
• 【WordPress×PHP】ループの仕組みをSWELLで解説
• 【PHP】関数の作り方と使い方を解説

WordPressテーマ「SWELL（スウェル）」

￥17,600（税込）

シンプルで美しいデザイン＋高速化機能まで最初から全部入り
※1回買えば複数サイトで使い回しOK

公式サイトを見る ▶SWELLの特徴を確認 ▶

当サイトの記事で使用したVBAなどのサンプルをDLできます

この記事のサンプルはありません！

ダウンロードページへは下のカードをクリックすればジャンプできます。
よろしければご利用ください！

サンプルのダウンロードはこちらから

【Excel VBA】記事内サンプルファイルダウンロードのページ 【Excel VBA】の記事内で使ったサンプルファイルを（Zipファイルで）ダウンロードできるようにしました。記事内では細かい部分の解説が不十分ですが、実際にファイルをダウ…