php orz函数,get_posts 介绍

get_posts 函数，简单的来讲是 get_post 的复数新形势，但因为是文章多篇提取，所以使用方法上却略有不同，支持众多参数选择需要提取的文章，在 CMS 主题中经常被用到，当然如果你对 WordPress 有更深了解的话，你也有可能是用 WP_Query 来替代该函数，这就是后话了，今天主要介绍一下 get_posts 函数。

get_posts 函数详解

该函数属于 WordPress 的内置函数，用于在 WordPress 中提取多篇指定或随机文章。

越是描述简单的函数，使用起来就越是复杂，后面的需要仔细看咯！

使用方法

$args = array(

'numberposts' => 5,

'offset' => 0,

'category' => ,

'orderby' => 'post_date',

'order' => 'DESC',

'include' => ,

'exclude' => ,

'meta_key' => ,

'meta_value' => ,

'post_type' => 'post',

'post_mime_type' => ,

'post_parent' => ,

'post_status' => 'publish' );

$posts_array = get_posts( $args );

?>

$args = array(

'numberposts' => 5,

'offset' => 0,

'category' => ,

'orderby' => 'post_date',

'order' => 'DESC',

'include' => ,

'exclude' => ,

'meta_key' => ,

'meta_value' => ,

'post_type' => 'post',

'post_mime_type' => ,

'post_parent' => ,

'post_status' => 'publish' );

$posts_array = get_posts( $args );

?>

$args是该函数必要的变量

get_posts( $args )将返回数组型的变量。

变量参数详解

$args = array(

//需要提取的文章数

'numberposts' => 10,

//以第几篇文章为起始位置

'offset' => 0,

//分类的ID，多个用逗号将分类编号隔开，或传递编号数组，可指定多个分类编号。

//大部分 CMS 使用该函数的重点。

'category' => ,

//排序规则(注1)

'orderby' => 'post_date',

//升序、降序 'ASC' —— 升序 (低到高) 'DESC' —— 降序 (高到底)

'order' => 'DESC',

//要显示文章的ID

'include' => ,

//要排除文章的ID

'exclude' => ,

//自定义字段名称

'meta_key' => ,

//自定义字段的值，配合上一个参数，来选择显示符合自定义字段数值的文章。

'meta_value' => ,

//post(日志)——默认，page(页面)，

//attachment(附件)，any —— (所有)

'post_type' => 'post',

//文章的 mime 类型

'post_mime_type' => ,

//要显示文章的父级 ID

'post_parent' => ,

//文章状态

'post_status' => 'publish' );

?>

$args = array(

//需要提取的文章数

'numberposts' => 10,

//以第几篇文章为起始位置

'offset' => 0,

//分类的ID，多个用逗号将分类编号隔开，或传递编号数组，可指定多个分类编号。

//大部分 CMS 使用该函数的重点。

'category' => ,

//排序规则(注1)

'orderby' => 'post_date',

//升序、降序 'ASC' —— 升序 (低到高) 'DESC' —— 降序 (高到底)

'order' => 'DESC',

//要显示文章的ID

'include' => ,

//要排除文章的ID

'exclude' => ,

//自定义字段名称

'meta_key' => ,

//自定义字段的值，配合上一个参数，来选择显示符合自定义字段数值的文章。

'meta_value' => ,

//post(日志)——默认，page(页面)，

//attachment(附件)，any —— (所有)

'post_type' => 'post',

//文章的 mime 类型

'post_mime_type' => ,

//要显示文章的父级 ID

'post_parent' => ,

//文章状态

'post_status' => 'publish' );

?>

注1：

‘author’ —— 按作者数值编号排序

‘category’ —— 按类别数值编号排序

‘content’ —— 按内容排序

‘date’ —— 按创建日期排序

‘ID’ —— 按文章编号排序

‘menu_order’ —— 按菜单顺序排序。仅页面可用。

‘mime_type’ —— 按MIME类型排序。仅附件可用。

‘modified’ —— 按最后修改时间排序。

‘name’ —— 按存根排序。

‘parent’ —— 按父级ID排序

‘password’ —— 按密码排序

‘rand’ —— 任意排序结果

‘status’ —— 按状态排序

‘title’ —— 按标题排序

‘type’ —— 按类型排序

实例

刚我们讲到用数组去传参，当然我们也可以用字符串来给该函数传参，下面给一个简单的例子。

$posts_rand = get_posts('numberposts=3&orderby=rand');

?>

$posts_rand = get_posts('numberposts=3&orderby=rand');

?>

以上代码用于随机在 WordPress 中获取3篇文章。

总结

其实query_posts()和get_posts()函数，接受大部分的参数，使用同样结构的数据库查询语句，并能达到一样的目的，但部分主题作者提示query_posts()有可能会扰乱 WordPress 主循环，所以在这里不推荐使用。

get_posts 使用不难，难在获取文章后怎样在页面中显示，这里就需要有一定的 PHP 知识了。

如果是在文章循环之外想要将查询内容显示出来，可以看一下setup_postdata这个函数，这个函数会给那些用惯了模板标签的童鞋很大的帮助。

文献

WordPress 官方文档 ：《Function Reference/get post》

之前讲过这个函数的单数形式 《get_post() 详解》，在这里也许你会获得更多参考。