get_category() の使い方｜説明・引数・注意点

説明

基本構文

get_category( int|object $category, string $output = OBJECT, string $filter = 'raw' ): object|array|WP_Error|null

引数

• $category：カテゴリーIDまたはオブジェクト
• $output：返却形式
• $filter：フィルター種別

戻り値

カテゴリーのオブジェクト。

使い方（サンプル）

$c = get_category( 5 );
if ( $c && ! is_wp_error( $c ) ) {
	var_dump( $c->name );
}

注意点

• 存在しないIDでは null や WP_Error が返ります。

実務での使いどころ

• カテゴリーのIDから、カテゴリーの情報（名前、スラッグ、説明）を取得するとき。

よくあるミスと対処

• スラッグで探したいのに、これを使っている。引数は、カテゴリーのIDまたはオブジェクト。スラッグでは、get_category_by_slug() を使う。
• 存在しないIDでは null、エラー時は WP_Error が返る。確認せずに使う。

NG例

$cat = get_category( 'news' ); // スラッグでは取得できない

OK例

$cat = get_category( 5 );
if ( $cat && ! is_wp_error( $cat ) ) {
	echo esc_html( $cat->name );
}

使い分け早見表

関連項目

get_categories()、get_term()

公式リファレンス：get_category() | Function | WordPress Developer Resources