WordPress中查询文章的循环Loop结构及用法分析


Posted in PHP onDecember 17, 2015

WordPress 上获取文章最重要的就是循环(Loop),事实上循环就是去数据库查询到相应的文章,然后暂时储存到全局变量里边,需要的时候一篇一篇的输出出来,WordPress 的循环设计的非常好,完成一次循环需要执行 2000 多行代码,而你在使用循环的时候看到的只是一个简单 while 循环加上几个函数,初学者也很好理解。

<?php
if( have_posts() ):
  while( have_posts() ):
    the_post();
  
  endwhile;
endif;
?>

上边就是一个普通的主循环结构,首先用 have_posts() 函数判断是否有文章,有则用 while 语句循环,在循环体里边调用 the_posts() 函数,the_posts() 函数用来告诉 WordPress 核心的查询类,已经查过一篇文章了,每调用一次 the_posts(),循环中的当前文章就会改变。

当调用几次 the_posts() 之后,文章已经全部循环完毕,就让 have_posts() 函数返回 False 来结束循环,所以,一个普通的循环应该是这样的:

<?php if( have_posts() ): ?>
  <ul>
    <?php while( have_posts() ):the_post();?>
      <li <?php post_class(); ?>>
        <?php the_title( '<h3>', '</h3>' ); ?>
      </li>
    <?php endwhile; ?>
  </ul>
<?php endif; ?>

WP_Query类

循环中所用到的方法都是来自于WP_Query类,这里再对WP_Query类做一下科普:
WP_Query 类的功能包括处理查询条件、去数据库获取文章、整理和储存文章、文章循环、根据文章查询条件判断页面类型。
属性

$query

传入的查询条件。

$query_vars

处理 $query 得到的可以使用的查询条件。

$queried_object

根据查询类型给出的查询归属。比如如果是根据分类查询,那么返回一个包含分类信息的类;如果是标签页则返回包含标签信息的类;作者页等以此类推。

$queried_object_id

返回 $queried_object 的 ID.比如分类就是分类 ID;标签就是标签 ID;以此类推。

$posts

从数据库中查询到的文章和文章信息被以数组的形式储存在这个变量里,每篇文章是一个从 WP_Post 类实例化的对象。

$post_count

当前文章数量,换句话说就是 $posts 变量里存储了几篇文章。

$found_posts

统计如果不启用分页会有多少文章。

$max_num_pages

总页数,当前文章被分成几页。

$current_post

当前文章的索引值。在循环中,开始循环 $current_post 为 ?1,每循环一次则加 1,它表示当前循环到的文章在 $posts 变量(数组)中的索引值。

$post

循环中当前的文章,是一个包含文章和文章信息通过 WP_Post 类实例化的对象。

$is_single, $is_page, $is_archive, $is_preview, $is_date, $is_year, $is_month, $is_time, $is_author, $is_category, $is_tag, $is_tax, $is_search, $is_feed, $is_comment_feed, $is_trackback, $is_home, $is_404, $is_comments_popup, $is_admin, $is_attachment, $is_singular, $is_robots, $is_posts_page, $is_paged

根据查询条件判断当前是什么页面,然后储存在些变量里,详情可以参考 《 WordPress 页面判断函数 》。

方法

init()

初始化对象,所有属性设置为 null、-1、0 或 False,删除一些属性。

parse_query( $query )

解析并保存查询字符串。

parse_query_vars()

在之前的 WordPress 版本中和 parse_query() 一样的功能,现在直接调用 parse_query() 就好了。

get( $query_var )

根据名字获取一个查询条件。

set( $query_var, $value )

设置一个查询条件。

get_posts()

根据现有的查询条件去数据库获取文章,并保存在 $posts 属性里,同时设置好 $post_count 属性。此函数的返回值就是存储文章的 $posts 属性。

next_post()

(循环控制)将 $current_post 加 1,也就是把当前文章向前推进一篇,同时把推进后的当前文章添加到 $post 属性里,然后返回 $post 属性。

the_post()

(循环控制)进入下一篇文章,调用 next_post() 函数,然后把推进后的当前文章导入到全局变量里边。

have_posts()

(循环控制)判断循环是否完成,如果所有文章都循环完毕或者根本就没有文章则返回 False.

rewind_posts()

(循环控制)跳到循环开头。相当于重置 $current_post 属性和 $post 属性。

query( $query )

查询文章,包括调用 init() 方法、parse_query() 方法和 get_posts() 方法,并返回 get_posts() 方法的返回值,用此函数可以完成一个文章查询的完整操作。

get_queried_object()

生成 $queried_object 属性,如果已经存在则直接返回 $queried_object 属性,所以说,因为默认 $queried_object 是不存在的,想要调用 $queried_object 属性一定要直接使用 get_queried_object() 方法。

get_queried_object_id()

生成 $queried_object_id 属性,如果已经存在则直接返回 $queried_object_id 属性。类似 get_queried_object() 方法。

WP_Query( $query = '' ) , __constructor( $query = '' )

WP_Query 类的构造函数,实例化类的时候自己调用,如果你传入一个查询条件,它会自动调用 query() 方法帮你查询文章。

PHP 相关文章推荐
如何正确理解PHP的错误信息
Oct 09 PHP
ob_start(),ob_start('ob_gzhandler')使用
Dec 25 PHP
在服务端进行目录建立、删除,文件上传、删除的过程的php代码
Sep 10 PHP
PHP 一个页面执行时间类代码
Mar 05 PHP
PHP开发中的错误收集,不定期更新。
Feb 03 PHP
php管理nginx虚拟主机shell脚本实例
Nov 19 PHP
php简单定时执行任务的实现方法
Feb 23 PHP
大家在抢红包,程序员在研究红包算法
Aug 31 PHP
php将文件夹打包成zip文件的简单实现方法
Oct 04 PHP
php四种定界符详解
Feb 16 PHP
PHP实现基于图的深度优先遍历输出1,2,3...n的全排列功能
Nov 10 PHP
laravel框架select2多选插件初始化默认选中项操作示例
Feb 18 PHP
WordPress中用于获取文章作者与分类信息的方法整理
Dec 17 #PHP
PHP附件下载中文名称乱码的解决方法
Dec 17 #PHP
WordPress中获取页面链接和标题的相关PHP函数用法解析
Dec 17 #PHP
php提交post数组参数实例分析
Dec 17 #PHP
PHP实现发送邮件的方法(基于简单邮件发送类)
Dec 17 #PHP
PHP响应post请求上传文件的方法
Dec 17 #PHP
CentOS下PHP7的编译安装及MySQL的支持和一些常见问题的解决办法
Dec 17 #PHP
You might like
简单的移动设备检测PHP脚本代码
2011/02/19 PHP
两千行代码的PHP学习笔记汇总
2014/10/05 PHP
PHP实现PDO的mysql数据库操作类
2014/12/12 PHP
PHP中字符串长度的截取用法示例
2017/01/12 PHP
javascript获取浏览器类型和版本的方法(js获取浏览器版本)
2014/03/13 Javascript
javascript实现别踩白块儿小游戏程序
2015/11/22 Javascript
javascript实现九宫格相加数值相等
2020/05/28 Javascript
小程序开发实战:实现九宫格界面的导航的代码实现
2017/01/19 Javascript
Bootstrap Table使用整理(三)
2017/06/09 Javascript
微信小程序地图(map)组件点击(tap)获取经纬度的方法
2019/01/10 Javascript
记一次vue去除#问题处理经过小结
2019/01/24 Javascript
自定义Vue组件打包、发布到npm及使用教程
2019/05/22 Javascript
node使用request请求的方法
2019/12/20 Javascript
Vuex的API文档说明详解
2020/02/05 Javascript
vue项目中使用bpmn-自定义platter的示例代码
2020/05/11 Javascript
vue 限制input只能输入正数的操作
2020/08/05 Javascript
在Python的Django框架下使用django-tagging的教程
2015/05/30 Python
Python数据类型详解(一)字符串
2016/05/08 Python
Django基础之Model操作步骤(介绍)
2017/05/27 Python
Python操作Sql Server 2008数据库的方法详解
2018/05/17 Python
python打包exe开机自动启动的实例(windows)
2019/06/28 Python
使用Python调取任意数字资产钱包余额功能
2019/08/15 Python
python多线程并发及测试框架案例
2019/10/15 Python
python中property和setter装饰器用法
2019/12/19 Python
python读取csv文件指定行的2种方法详解
2020/02/13 Python
使用Keras实现Tensor的相乘和相加代码
2020/06/18 Python
选购国际女性时装设计师品牌:IFCHIC(支持中文)
2018/04/12 全球购物
介绍一下Linux内核的排队自旋锁
2014/01/04 面试题
酒店应聘自荐信
2013/11/09 职场文书
事业单位人员的自我评价范文
2014/09/21 职场文书
2015年财务个人工作总结范文
2015/05/22 职场文书
辩论会主持词
2015/07/03 职场文书
Python OpenCV快速入门教程
2021/04/17 Python
Python IO文件管理的具体使用
2022/03/20 Python
Nginx设置HTTPS的方法步骤 443证书配置方法
2022/03/21 Servers
Lakehouse数据湖并发控制陷阱分析
2022/03/31 Oracle