SYNCER

SYNCER

taxonomy_exists() - タクソノミーが存在するか確認する

公開日:

taxonomy_exists()は、指定した名前のタクソノミーが存在するか否かを取得する関数です。主に独自のタクソノミーを管理する時に有用です。

構文

bool taxonomy_exists( string $taxonomy )

パラメータ

$taxonomy

タクソノミーの名前。カテゴリならcategory、タグならpost_tag。

返り値

bool

タクソノミーが存在する場合はtrue、存在しない場合はfalseが返る。

関数

この関数内で利用している、別のWordPress関数です。

サンプルコード

カテゴリ

カテゴリ(category)というタクソノミーが存在するか確認します。

php

<?php
	// 実行
	$result = taxonomy_exists( "category" ) ;

	// 結果
	var_dump( $result ) ;

結果 (出力内容) - PHP7.0.13

bool(true)

タグ

タグ(post_tag)というタクソノミーが存在するか確認します。

php

<?php
	// 実行
	$result = taxonomy_exists( "post_tag" ) ;

	// 結果
	var_dump( $result ) ;

結果 (出力内容) - PHP7.0.13

bool(true)

存在しないタクソノミー

hogeというタクソノミーが存在するか確認します。これはデフォルトでは存在しないため、独自タクソノミーとして追加していない場合はfalseが返るはずです。

php

<?php
	// 実行
	$result = taxonomy_exists( "hoge" ) ;

	// 結果
	var_dump( $result ) ;

結果 (出力内容) - PHP7.0.13

bool(false)

ソースコード

wp-includes/taxonomy.php

/**
 * Checks that the taxonomy name exists.
 *
 * Formerly is_taxonomy(), introduced in 2.3.0.
 *
 * @since 3.0.0
 *
 * @global array $wp_taxonomies The registered taxonomies.
 *
 * @param string $taxonomy Name of taxonomy object.
 * @return bool Whether the taxonomy exists.
 */
function taxonomy_exists( $taxonomy ) {
	global $wp_taxonomies;

	return isset( $wp_taxonomies[$taxonomy] );
}

参考リンク