Doctrine\ORM\QueryBuilder 源码解析之 where

编程之家收集整理的这篇文章主要介绍了Doctrine\ORM\QueryBuilder 源码解析之 where编程之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

背景

最近有需求实现类似于 QueryBuilder 的谓词语句,就去翻看了它的源码。先看两个例子
例子1

$qb = $em->createQueryBuilder();
$qb->select('*')->from('User','u')->where('u.id = 1');
echo $qb->getDQL();

例子2

$qb = $em->createQueryBuilder();
$qb->select('*')
->from('User','u')
->where('u.id = 1')
->andWhere('u.score >= 90')
->orWhere('u.score <= 100');
echo $qb->getDQL();

是不是有点懵逼,希望看完我的文章,希望你有所收获。
接下来会以例子2讲解,分别解释 whereandWhereorWhere 方法,图文并茂,一步步教你理解上述PHP代码转换为sql语句的原理。

代码不难,建议大家配合源码食用。[相关源码在此]https://github.com/doctrine/orm/blob/master/lib/Doctrine/ORM/QueryBuilder.php(https://github.com/doctrine/orm/blob/master/lib/Doctrine/ORM/QueryBuilder.php
)

添加谓词语句

先看 QueryBuilder::where 方法生成了一个Andx谓词对象 $predicates

public function where($predicates)
{
if ( ! (func_num_args() == 1 && $predicates instanceof Expr\Composite)) {
$predicates = new Expr\Andx(func_get_args());
}

return $this->add('where',$predicates);
}

执行 var_export($predicates) 后查看成员变量如下,separator 是 where 子句条件之间的连接符,有 AND 和 OR。parts 是由条件组成的数组。

// var_export($predicates)的输出
Doctrine\ORM\Query\Expr\Andx::__set_state(array(
'separator' => ' AND ','allowedClasses' => 
array (
0 => 'Doctrine\\ORM\\Query\\Expr\\Comparison',1 => 'Doctrine\\ORM\\Query\\Expr\\Func',2 => 'Doctrine\\ORM\\Query\\Expr\\Orx',3 => 'Doctrine\\ORM\\Query\\Expr\\Andx',),'preSeparator' => '(','postSeparator' => ')','parts' => 
array (
0 => 'u.id = 1',))

接下来执行的return $this->add('where',$predicates);函数很简单,把谓词对象作为QueryBuilder::_dqlParts中的key为where的value,打印QueryBuilder对象如下

// 此函数有删减,完整请看官方源码
// QueryBuilder的add方法
public function add($dqlPartName,$dqlPart,$append = false)
{
$isMultiple = is_array($this->_dqlParts[$dqlPartName])
&& !($dqlPartName == 'join' && !$append);
// $isMultiple 这里的值为 false
$this->_dqlParts[$dqlPartName] = ($isMultiple) ? [$dqlPart] : $dqlPart;
$this->_state = self::STATE_DIRTY;

return $this;
}

// _dqlParts 结构
array (
...
'where' => 
Doctrine\ORM\Query\Expr\Andx::__set_state(array(
'separator' => ' AND ',))
...

接下来具体看 QueryBuilder::andWhere方法
getDQLPart取出的是刚才设置的Andx对象,接着执行Andx的addMultiple方法,最终调用的是Andx::add方法,这个方法最终是把'u.score >= 90'加入到Andx::parts数组中



// QueryBuilder
public function andWhere()
{
$args = func_get_args();
$where = $this->getDQLPart('where');

if ($where instanceof Expr\Andx) {
$where->addMultiple($args);
} else {
array_unshift($args,$where);
$where = new Expr\Andx($args);
}

return $this->add('where',$where);
}

// Andx
public function add($arg)
{
if ( $arg !== null && (!$arg instanceof self || $arg->count() > 0) ) {
// If we decide to keep Expr\Base instances,we can use this check
if ( ! is_string($arg)) {
$class = get_class($arg);

if ( ! in_array($class,$this->allowedClasses)) {
throw new \InvalidArgumentException("Expression of type '$class' not allowed in this context.");
}
}

$this->parts[] = $arg;
}

return $this;
}

所以此时Andx::parts数组中有了两个元素:'u.id = 1''u.score >= 90'

Doctrine\ORM\Query\Expr\Andx::__set_state(array(
'separator' => ' AND ',1 => 'u.score >= 90',))

继续看QueryBuilder::orWhere 方法,取出的 $where 是刚刚andWhere 执行后设置的 Andx 对象,执行 array_unshift($args,$where)语句后,形成的 $args 由一个 Andx 对象和一个字符串 'u.score <= 100'组成。

public function orWhere()
{
$args = func_get_args();
$where = $this->getDQLPart('where');

if ($where instanceof Expr\Orx) {
$where->addMultiple($args);
} else {
array_unshift($args,$where);
$where = new Expr\Orx($args);
}

return $this->add('where',$where);
}

将包含 Andx 对象和字符串 u.score <= 100$args 数组作为 Orx 对象的构造方法,Orx 构造函数的内部实现是 addMultiple方法,最终调用 Orx::add 方法$args 中的元素全部都加到 Orx对象 的 $parts 对象中,最终 Orx 对象的 parts 内容的示意图的阶段 3 所示

image.png


我整理了一下添加逻辑如下所示

image.png

解析谓词语句

谓词对象转换成谓词语句其实就是一句话,

$queryPart = $this->getDQLPart($queryPartName);
echo $queryPart;

不要觉得奇怪,对象也可以当作字符串用,引用PHP手册上的原话

__toString() 方法用于一个类被当成字符串时应怎样回应。

谓词对象的__toString的实现在Doctrine\ORM\Query\Expr\Composite,一起来看看

public function __toString()
{
if ($this->count() === 1) {
return (string) $this->parts[0];
}

$components = [];

foreach ($this->parts as $part) {
$components[] = $this->processQueryPart($part);
}

return implode($this->separator,$components);
}

private function processQueryPart($part)
{
$queryPart = (string) $part;

if (is_object($part) && $part instanceof self && $part->count() > 1) {
return $this->preSeparator . $queryPart . $this->postSeparator;
}

if (stripos($queryPart,' OR ') !== false || stripos($queryPart,' AND ') !== false) {
return $this->preSeparator . $queryPart . $this->postSeparator;
}

return $queryPart;
}

带入之前组合好的 Orx 对象,一起来分析下。Orx 对象parts属性的两个元素分别会被带入processQueryPart执行。
Andx 你先来,走到$queryPart = (string) $part,我们希望$part被当作字符串处理,继续回到__toString,这里是个递归。
Andx对象parts属性的两个字符串元素继续带入processQueryPart执行。这两个字符串经过处理会作为Andx对象的$components的元素,最终经过implode($this->separator,$components)返回字符串 u.id=1 and u.score >= 90 ,此时的值会被返回到 $queryPart

接下来执行到的是 return $this->preSeparator . $queryPart . $this->postSeparator; 到 Orx 对象的 $components的数组中去。

// $part 是 Andx 对象
// Andx 对象 经过字符串化后成了 u.id=1 and u.score >= 90,赋值给 $queryPart
$queryPart = (string) $part;

// 因为Andx对象有两个条件,所以左右两边会被加上括号,最终返回 (u.id = 1 AND u.score >= 90)
if (is_object($part) && $part instanceof self && $part->count() > 1) {
return $this->preSeparator . $queryPart . $this->postSeparator;
}

Orx 对象parts属性的第一个元素已经处理完毕,接下来是第二个元素u.score <= 100,字符串就很简单了,直接返回到 Orx 对象的 $components 中去!
现在来看看Orx 对象的 $components中间有啥了

array (
0 => '(u.id = 1 AND u.score >= 90)',1 => 'u.score <= 100',)

再用implode切割成字符串 结果就是出来了(u.id = 1 AND u.score >= 90) OR u.score <= 100,解析完毕!看不懂的同学看我整理的流程图。

image.png

总结

具体细节大家可以使用 PHPStorm + xdebug 单步调试研究。

总结

以上是编程之家为你收集整理的Doctrine\ORM\QueryBuilder 源码解析之 where全部内容,希望文章能够帮你解决Doctrine\ORM\QueryBuilder 源码解析之 where所遇到的程序开发问题。

如果觉得编程之家网站内容还不错,欢迎将编程之家网站推荐给程序员好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。

小编个人微信号 jb51ccc
喜欢与人分享编程技术与工作经验,欢迎加入编程之家官方交流群!

相关文章

猜你在找的PHP相关文章

PHP中的公共静态方法,如: public static function getParam($input){.......}使用static,表明该公共方法是一个公共的静态方法,可以不用实例化这个类,直接className::functionName()来进行调用;同时,静态方法都是存在缓存里面,运行速度快;而非静态公共方法,需要用new实例化之后,才能使用$class->funct
php中的echo   print  print_r的区别    echo----可以输出一个或多个字符串;没有返回值;用法 echo  或者  echo()    print-----只允许输出一个字符串;不能输出对象或者数组; 返回值总为1;        用法print   或者print()    print-r------可以输出String  Float  Int  Arr
php中的cookie和session的用法与区别区别:        session信息存放在sever端,但session id存放在ckient cookie里面        cookie是完全存放在client端的1、cookie的配置与应用     A、创建cookie:setcookie(string name, string value, int expire,
有的时候我们得在php文件里面引入html代码,或者在php文件的某个位置引入文件html,下面就介绍一下实现的方法。下面是recharge.php的代码:<?php require_once "../../config.php";?> 充值 var serviceChargePoint = ;
用php往数据库插入中文的时候,显示乱码的解决方法,就是在建立与数据库的连接之后,加上这一句话:mysqli_query($this->link,"set names 'utf8'");在php中,建立与数据库的连接的方法如下: /** * 连接数据库 */ private function conn() { //
php中的require   require_once   include   incllude_once的区别1、include、require执行包含文件,不对包含文件进行判断,可能会出现重复包含情况;     include_once、require_once在包含文件的时候,会先判断文件是否已经包含过,如果包含,则不再包含。这样的方式可以节省资        源,避免重复定义的错误
PHP中的函数date_default_timezone_set()的作用是:设定脚本中所有日期时间函数的默认时区格式:bool date_default_timezone_set ( string $timezone_identifier )输入值:$timezone_identifier失去标识符返回值:如果参数$timezone_identifier无效返回false,有效返回t
1、PHP里面的函数mkdir()的作用是:新建目录bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = false [, resource $context ]]] )参数:$pathname---目录的路径          $mode--------默认的mode是0777,意