get_taxonomies( array $args = array(), string $output = 'names', string $operator = 'and' ): string[]|WP_Taxonomy[]

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Parameters

$argsarrayoptional

An array of key => value arguments to match against the taxonomy objects.
Default empty array.Default: array()

$outputstringoptional

The type of output to return in the array. Either 'names' or 'objects'. Default 'names'.Default: 'names'

$operatorstringoptional

The logical operation to perform. Accepts 'and' or 'or'. 'or' means only one element from the array needs to match; 'and' means all elements must match.
Default 'and'.Default: 'and'

Return value

string[]|WP_Taxonomy[]

An array of taxonomy names or objects.

Performance profile

How much work a call to get_taxonomies() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Trivial

Touches nothing outside its own arguments.

Scaling

Constant

No loop in the body: the same number of instructions runs whatever you pass in.

Instructions

15–16

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 17.

Plugin surface

None

Nothing here hands control to plugin code.

Called by

22

22 places in core call this, so the cost is paid more often than your own code shows.

What one call costs · 1 distinct outcome

One number would be a lie: the work depends on which branch runs. These are every distinct cost get_taxonomies() can have, taken from its control-flow graph on PHP 8.5.

Uses · 1

• wp_filter_object_list()Filters a list of objects, based on a set of key => value arguments.

Used by · 22

• WP::parse_request()Parses the request to find the correct WordPress query.
• WP_Customize_Nav_Menus::available_item_types()Returns an array of all the available item types.
• WP_Customize_Nav_Menus::search_available_items_query()Performs post queries for available-item searching.
• WP_Query::parse_tax_query()Parses various taxonomy related query vars.
• WP_REST_Taxonomies_Controller::get_items()Retrieves all public taxonomies.
• WP_REST_Taxonomies_Controller::get_items_permissions_check()Checks whether a given request has permission to read taxonomies.
• WP_REST_Term_Search_Handler::__construct()Constructor.
• WP_Sitemaps_Taxonomies::get_object_subtypes()Returns all public, registered taxonomies.
• WP_Widget_Tag_Cloud::form()Outputs the Tag Cloud widget settings form.
• _build_block_template_result_from_post()Builds a unified template object based a post Object.
• block_core_navigation_link_build_variations()Returns an array of variations for the navigation link block.
• block_core_post_terms_build_variations()Returns the available variations for the `core/post-terms` block.

Source code

View on Trac ↗View on GitHub ↗

282function get_taxonomies( $args = array(), $output = 'names', $operator = 'and' ) {283	global $wp_taxonomies;284 285	$field = ( 'names' === $output ) ? 'name' : false;286 287	return wp_filter_object_list( $wp_taxonomies, $args, $operator, $field );288}

Changelog

Introduced in 3.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/taxonomy.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.