這篇文章主要介紹了WordPress開發中用于獲取近期文章的PHP函數使用解析,即對wp_get_recent_posts函數的使用方法介紹,需要的朋友可以參考下。

wp_get_recent_posts 函數在 WordPress 中是一個可以獲取近期文章數組的函數，相較于其他的文章獲取方式， wp_get_recent_posts 返回的將是一個數組而不是對象，所以在使用中對于一些新手或者是懶人，可能會更方便一些，下面我們就實例講解一下這個函數。

描述

wp_get_recent_posts

英文解釋很短，就不貼了，中文大概意思是：獲取最新文章的函數。

實際上這是一個 get_posts函數的再使用。

描述的再好也木用，下面看使用。

使用/用法

1. <?php  
2.  wp_get_recent_posts( $args )  
3. ?> 

參數默認值

1. <?php $args = array( 
2. //獲取的文章數量 
3.   'numberposts' => 10, 
4. //從第幾篇開始獲取 
5.   'offset' => 0, 
6. //分類的ID，如果不設置則顯示全部分類 
7.   'category' => 0, 
8. //排序規則 （注1，下詳） 
9.   'orderby' => 'post_date', 
10. //升、降序排列 
11.   'order' => 'DESC', 
12. //包括的文章ID 
13.   'include' => , 
14. //排除的文章ID 
15.   'exclude' => , 
16. //自定義字段名稱 
17.   'meta_key' => , 
18. //自定義字段的值，配合上一個參數，來選擇顯示符合自定義字段數值的文章。 
19.   'meta_value' =>, 
20. //文章類型：文章或頁面 
21.   'post_type' => 'post', 
22. //文章狀態：草稿、已發布、隱藏文章等.... 
23.   'post_status' => 'draft, publish, future, pending, private', 
24. //這個木研究 
25.   'suppress_filters' => true );  
26. ?> 

實例

因為跟 get_posts 的使用方法實在是很相似，所以就不給什么高深的例子了，簡單的給一個官方的例子。

1. <h2>Recent Posts</h2> 
2. <ul> 
3. <?php 
4.  //獲取最新文章 
5.  $recent_posts = wp_get_recent_posts(); 
6.  //遍歷出每一篇文章。 
7.  foreach( $recent_posts as $recent ){ 
8.  echo '<li><a href="' . get_permalink($recent["ID"]) . '" title="Look '.esc_attr($recent["post_title"]).'" >' .  $recent["post_title"].'</a> </li> '; 
9.  } 
10. ?> 
11. </ul> 

總結

注意：因為wp_get_recent_posts函數的返回值是一個數組，setup_postdata 函數理論上只能接受對象類型的變量，所以按照官方文檔的解釋是不能使用setup_postdata函數，裝載到循環中使用的。

因為用的不多，所以我也就沒有去試，有興趣的同學可以試一試看能否成功。

所以說，如果使用 setup_postdata 函數的話，wp_get_recent_posts 函數不如 get_posts 函數使用起來方便。

注：

1. ‘author' —— 按作者數值編號排序 
2. ‘category' —— 按類別數值編號排序 
3. ‘content' —— 按內容排序 
4. ‘date' —— 按創建日期排序 
5. ‘ID' —— 按文章編號排序 
6. ‘menu_order' —— 按菜單順序排序。僅頁面可用。 
7. ‘mime_type' —— 按MIME類型排序。僅附件可用。 
8. ‘modified' —— 按最后修改時間排序。 
9. ‘name' —— 按存根排序。 
10. ‘parent' —— 按父級ID排序 
11. ‘password' —— 按密碼排序 
12. ‘rand' —— 任意排序結果 
13. ‘status' —— 按狀態排序 
14. ‘title' —— 按標題排序 
15. ‘type' —— 按類型排序