函数原型
get_attachment_taxonomies( int|array|object $attachment, string $output = ‘names’ ): string[]|WP_Taxonomy[]
函数描述
Retrieves taxonomies attached to given the attachment.
是否弃用
未弃用
函数参数
-
$attachment
int|array|object
Required - Attachment ID, data array, or data object.
-
$output
string
Optional - Output type.
'names'to return an array of taxonomy names, or'objects'to return an array of taxonomy objects.
Default is'names'.Default:
'names'
函数返回值
string[]|WP_Taxonomy[] List of taxonomies or taxonomy names. Empty array on failure.
函数位置
File: wp-includes/media.php.
函数源码
function get_attachment_taxonomies( $attachment, $output = 'names' ) {
if ( is_int( $attachment ) ) {
$attachment = get_post( $attachment );
} elseif ( is_array( $attachment ) ) {
$attachment = (object) $attachment;
}
if ( ! is_object( $attachment ) ) {
return array();
}
$file = get_attached_file( $attachment->ID );
$filename = wp_basename( $file );
$objects = array( 'attachment' );
if ( false !== strpos( $filename, '.' ) ) {
$objects[] = 'attachment:' . substr( $filename, strrpos( $filename, '.' ) + 1 );
}
if ( ! empty( $attachment->post_mime_type ) ) {
$objects[] = 'attachment:' . $attachment->post_mime_type;
if ( false !== strpos( $attachment->post_mime_type, '/' ) ) {
foreach ( explode( '/', $attachment->post_mime_type ) as $token ) {
if ( ! empty( $token ) ) {
$objects[] = "attachment:$token";
}
}
}
}
$taxonomies = array();
foreach ( $objects as $object ) {
$taxes = get_object_taxonomies( $object, $output );
if ( $taxes ) {
$taxonomies = array_merge( $taxonomies, $taxes );
}
}
if ( 'names' === $output ) {
$taxonomies = array_unique( $taxonomies );
}
return $taxonomies;
}
源码链接
变更日志
| Version | Description |
|---|---|
| 4.7.0 | Introduced the $output parameter. |
| 2.5.0 | Introduced. |

