get_comment()

💡 云策文档标注

概述

get_comment() 函数用于根据评论 ID 或评论对象检索评论数据。它支持多种输入类型和输出格式，并包含缓存和过滤机制。

关键要点

函数接受 $comment 参数，可以是 WP_Comment 对象、字符串或整数，用于指定要检索的评论；若为空，则使用全局 $comment 变量。
通过 $output 参数控制返回类型，可选 OBJECT（默认，返回 WP_Comment 对象）、ARRAY_A（关联数组）或 ARRAY_N（数字数组）。
内部处理包括：检查全局变量、实例化 WP_Comment 对象、应用 get_comment 过滤器，并根据 $output 返回相应格式的数据。
返回值为 WP_Comment 对象、数组或 null（如果评论不存在）。

代码示例

// 获取评论 ID 为 7 的评论作者名称
$comment = get_comment( 7 );
if ( $comment ) {
    echo $comment->comment_author;
}

// 使用 ARRAY_A 输出格式
$comment_array = get_comment( 7, ARRAY_A );
if ( $comment_array ) {
    echo $comment_array['comment_author'];
}

注意事项

函数在检索评论后会触发 get_comment 过滤器，允许开发者修改返回的评论数据。
如果评论不存在，函数返回 null，调用时应进行空值检查以避免错误。
相关函数包括 WP_Comment::get_instance() 和 apply_filters()，用于内部实例化和过滤操作。

📄 原文内容

Retrieves comment data given a comment ID or comment object.

Description

If an object is passed then the comment data will be cached and then returned after being passed through a filter. If the comment is empty, then the global comment variable will be used, if it is set.

Parameters

$commentWP_Comment|string|intoptional: Comment to retrieve.

Default:null
$outputstringoptional: The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which correspond to a WP_Comment object, an associative array, or a numeric array, respectively.

Default:OBJECT

Return

WP_Comment|array|null Depends on $output value.

Source

function get_comment( $comment = null, $output = OBJECT ) {
	if ( empty( $comment ) && isset( $GLOBALS['comment'] ) ) {
		$comment = $GLOBALS['comment'];
	}

	if ( $comment instanceof WP_Comment ) {
		$_comment = $comment;
	} elseif ( is_object( $comment ) ) {
		$_comment = new WP_Comment( $comment );
	} else {
		$_comment = WP_Comment::get_instance( $comment );
	}

	if ( ! $_comment ) {
		return null;
	}

	/**
	 * Fires after a comment is retrieved.
	 *
	 * @since 2.3.0
	 *
	 * @param WP_Comment $_comment Comment data.
	 */
	$_comment = apply_filters( 'get_comment', $_comment );

	if ( OBJECT === $output ) {
		return $_comment;
	} elseif ( ARRAY_A === $output ) {
		return $_comment->to_array();
	} elseif ( ARRAY_N === $output ) {
		return array_values( $_comment->to_array() );
	}
	return $_comment;
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘get_comment’, WP_Comment $_comment ): Fires after a comment is retrieved.

Uses	Description
WP_Comment::__construct()`wp-includes/class-wp-comment.php`	Constructor.
WP_Comment::get_instance()`wp-includes/class-wp-comment.php`	Retrieves a WP_Comment instance.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Used by	Description
_get_comment_reply_id()`wp-includes/comment-template.php`	Gets the comment’s reply to ID from the $_GET[‘replytocom’].
wp_get_unapproved_comment_author_email()`wp-includes/comment.php`	Gets unapproved comment author’s email.
get_object_subtype()`wp-includes/meta.php`	Returns the object subtype for a given object ID of a specific type.
WP_REST_Comments_Controller::get_comment()`wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php`	Get the comment, if the ID is valid.
WP_REST_Comments_Controller::update_item()`wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php`	Updates a comment.
WP_REST_Comments_Controller::delete_item()`wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php`	Deletes a comment.
WP_REST_Comments_Controller::create_item()`wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php`	Creates a comment.
WP_Comment_Query::fill_descendants()`wp-includes/class-wp-comment-query.php`	Fetch descendants for located comments.
wp_handle_comment_submission()`wp-includes/comment.php`	Handles the submission of a comment, usually posted to wp-comments-post.php via a comment form.
wp_new_comment_notify_moderator()`wp-includes/comment.php`	Sends a comment moderation notification to the comment moderator.
wp_new_comment_notify_postauthor()`wp-includes/comment.php`	Sends a notification of a new comment to the post author.
WP_Comments_List_Table::floated_admin_avatar()`wp-admin/includes/class-wp-comments-list-table.php`	Adds avatars to comment author names.
WP_Comment_Query::get_comments()`wp-includes/class-wp-comment-query.php`	Get a list of comments matching the query vars.
get_avatar_data()`wp-includes/link-template.php`	Retrieves default data about the avatar.
touch_time()`wp-admin/includes/template.php`	Prints out HTML form date elements for editing post or comment publish date.
_wp_ajax_delete_comment_response()`wp-admin/includes/ajax-actions.php`	Sends back current comment total and new page links if they need to be updated.
wp_ajax_delete_comment()`wp-admin/includes/ajax-actions.php`	Handles deleting a comment via AJAX.
wp_ajax_dim_comment()`wp-admin/includes/ajax-actions.php`	Handles dimming a comment via AJAX.
wp_ajax_get_comments()`wp-admin/includes/ajax-actions.php`	Handles getting comments via AJAX.
wp_ajax_replyto_comment()`wp-admin/includes/ajax-actions.php`	Handles replying to a comment via AJAX.
wp_ajax_edit_comment()`wp-admin/includes/ajax-actions.php`	Handles editing a comment via AJAX.
WP_Comments_List_Table::column_comment()`wp-admin/includes/class-wp-comments-list-table.php`
get_comment_to_edit()`wp-admin/includes/comment.php`	Returns a WP_Comment object based on comment ID.
floated_admin_avatar()`wp-admin/includes/comment.php`	Adds avatars to relevant places in admin.
map_meta_cap()`wp-includes/capabilities.php`	Maps a capability to the primitive capabilities required of the given user to satisfy the capability being checked.
get_avatar()`wp-includes/pluggable.php`	Retrieves the avatar `<img>` tag for a user, email address, MD5 hash, comment, or post.
wp_notify_postauthor()`wp-includes/pluggable.php`	Notifies an author (and/or others) of a comment/trackback/pingback on a post.
wp_notify_moderator()`wp-includes/pluggable.php`	Notifies the moderator of the site about a new comment that is awaiting approval.
get_commentdata()`wp-includes/deprecated.php`	Retrieve an array of comment data about comment $comment_id.
wp_scheduled_delete()`wp-includes/functions.php`	Permanently deletes comments or posts of any type that have held a status of ‘trash’ for the number of days defined in EMPTY_TRASH_DAYS.
get_edit_comment_link()`wp-includes/link-template.php`	Retrieves the edit comment link.
edit_comment_link()`wp-includes/link-template.php`	Displays the edit comment link with formatting.
get_comment_guid()`wp-includes/feed.php`	Retrieves the feed GUID for the current comment.
wp_xmlrpc_server::wp_deleteComment()`wp-includes/class-wp-xmlrpc-server.php`	Deletes a comment.
wp_xmlrpc_server::wp_editComment()`wp-includes/class-wp-xmlrpc-server.php`	Edits a comment.
wp_xmlrpc_server::wp_getComment()`wp-includes/class-wp-xmlrpc-server.php`	Retrieves a comment.
comment_form_title()`wp-includes/comment-template.php`	Displays text based on comment reply status.
get_comment_reply_link()`wp-includes/comment-template.php`	Retrieves HTML content for reply to comment link.
get_comment_link()`wp-includes/comment-template.php`	Retrieves the link to a given comment.
get_comment_text()`wp-includes/comment-template.php`	Retrieves the text of the current comment.
comment_text()`wp-includes/comment-template.php`	Displays the text of the current comment.
get_comment_time()`wp-includes/comment-template.php`	Retrieves the comment time of the current comment.
get_comment_type()`wp-includes/comment-template.php`	Retrieves the comment type of the current comment.
comment_author_url()`wp-includes/comment-template.php`	Displays the URL of the author of the current comment, not linked.
get_comment_class()`wp-includes/comment-template.php`	Returns the classes for the comment div as an array.
get_comment_date()`wp-includes/comment-template.php`	Retrieves the comment date of the current comment.
get_comment_excerpt()`wp-includes/comment-template.php`	Retrieves the excerpt of the given comment.
comment_excerpt()`wp-includes/comment-template.php`	Displays the excerpt of the current comment.
get_comment_ID()`wp-includes/comment-template.php`	Retrieves the comment ID of the current comment.
get_comment_author()`wp-includes/comment-template.php`	Retrieves the author of the current comment.
comment_author()`wp-includes/comment-template.php`	Displays the author of the current comment.
get_comment_author_email()`wp-includes/comment-template.php`	Retrieves the email of the author of the current comment.
comment_author_email()`wp-includes/comment-template.php`	Displays the email of the author of the current global $comment.
get_comment_author_email_link()`wp-includes/comment-template.php`	Returns the HTML email link to the author of the current comment.
get_comment_author_link()`wp-includes/comment-template.php`	Retrieves the HTML link to the URL of the author of the current comment.
get_comment_author_IP()`wp-includes/comment-template.php`	Retrieves the IP address of the author of the current comment.
get_comment_author_url()`wp-includes/comment-template.php`	Retrieves the URL of the author of the current comment, not linked.
wp_set_comment_status()`wp-includes/comment.php`	Sets the status of a comment.
wp_update_comment()`wp-includes/comment.php`	Updates an existing comment in the database.
wp_spam_comment()`wp-includes/comment.php`	Marks a comment as Spam.
wp_unspam_comment()`wp-includes/comment.php`	Removes a comment from the Spam.
wp_get_comment_status()`wp-includes/comment.php`	Retrieves the status of a comment by comment ID.
wp_insert_comment()`wp-includes/comment.php`	Inserts a comment into the database.
get_page_of_comment()`wp-includes/comment.php`	Calculates what page number a comment will appear on for comment paging.
wp_delete_comment()`wp-includes/comment.php`	Trashes or deletes a comment.
wp_trash_comment()`wp-includes/comment.php`	Moves a comment to the Trash
wp_untrash_comment()`wp-includes/comment.php`	Removes a comment from the Trash

Show 62 more Show less

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Skip to note 4 content

Codex

11 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Example
To get the author’s name of a comment with ID 7:
```
comment_author;
?>
```
Alternatively, specify the $output parameter:
Log in to add feedback
Skip to note 5 content

Codex

11 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Example
To get the author’s name of a comment with ID 7:
```
comment_author;
?>
<pre class="wp-block-code"><code lang="php" class="language-php ">
```
Alternatively, specify the $output parameter:
Log in to add feedback
Skip to note 6 content

edyd

6 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Grab the title and link of the post from the comment
```
comment_post_ID );
$link_post = get_permalink( $comentario->comment_post_ID );
?>
```
Log in to add feedback

云策 WordPress 开发者社区

函数文档