php theexcerpt,WordPress获取文章摘要函数the_excerpt、get_the_excerpt

重要：本文最后更新于2018-12-25 09:10:21，某些文章具有时效性，若有错误或已失效，请在下方留言或联系代码狗。

文章摘要不仅对于网站的SEO是非常重要，而且对网页的排版提升用户体验也很重要。WordPress给我们提供了两个获取文章摘要的函数the_excerpt与get_the_excerpt，可以让我们轻易的得到文章摘要数据。如果不使用摘要，试想如果的文章列表将整篇文章显示出来，用户得翻多久才能看到下一篇文章呢？下面是WordPress获取摘要函数的构成使用详解。

函数描述

the_excerpt：显示文章摘要。

get_the_excerpt：检索文章摘要。

函数原型

the_excerpt与get_the_excerpt函数都位于wp-includes/post-template.php文件中。

function the_excerpt() {

/**

* Filters the displayed post excerpt.

*

* @since 0.71

*

* @see get_the_excerpt()

*

* @param string $post_excerpt The post excerpt.

*/

echo apply_filters( 'the_excerpt', get_the_excerpt() );

}

不用说，从函数构成上可以看出，the_excerpt函数是用get_the_excerpt函数构成的，下面是get_the_excerpt函数的源码。

function get_the_excerpt( $post = null ) {

if ( is_bool( $post ) ) {

_deprecated_argument( __FUNCTION__, '2.3.0' );

}

$post = get_post( $post );

if ( empty( $post ) ) {

return '';

}

if ( post_password_required( $post ) ) {

return __( 'There is no excerpt because this is a protected post.' );

}

/**

* Filters the retrieved post excerpt.

*

* @since 1.2.0

* @since 4.5.0 Introduced the `$post` parameter.

*

* @param string $post_excerpt The post excerpt.

* @param WP_Post $post Post object.

*/

return apply_filters( 'get_the_excerpt', $post->post_excerpt, $post );

}

从上面代码中可以看出，get_the_excerpt函数直接取出了从数据库查到的文章数据。

参数

the_excerpt函数只能使用在WordPress主循环中，不需要参数。

get_the_excerpt函数参数是文章id，可以通过文章id获取到文章的摘要数据，可以不填，不填时与the_excerpt一样，不在文章主循环可能会出现错误，带参数可以在主循环外使用。

函数使用方法

注意，这个函数获取的文章摘要将会以[…]结尾，如代码狗博客的文章列表摘要，如果你不喜欢，可以使用字符串替换函数替换掉。

如果你对截取的字符数不满意，可以使用PHP字符串截取函数自行截取摘要字数，太简单了就不说了。