Doctrine Collections表达式构建器详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00960/article/details/148488339

Doctrine Collections表达式构建器详解

collections Collections Abstraction Library 项目地址: https://gitcode.com/gh_mirrors/co/collections

什么是表达式构建器

Doctrine Collections库中的表达式构建器(Expression Builder)是一个用于构建复杂查询条件的流畅接口(fluent interface)。它允许开发者以面向对象的方式创建各种条件表达式，然后与Criteria类配合使用，对集合进行筛选操作。

表达式构建器的主要优势在于：

提供类型安全的条件构建方式
支持链式调用，代码可读性高
避免手写字符串条件可能带来的错误

基本使用方法

要使用表达式构建器，首先需要通过Criteria类的expr()静态方法获取实例：

use Doctrine\Common\Collections\Criteria;

$expressionBuilder = Criteria::expr();

然后就可以使用这个构建器创建各种条件表达式，并与Criteria配合使用：

$criteria = new Criteria();
$criteria->where($expressionBuilder->eq('name', 'jwage'));
$criteria->orWhere($expressionBuilder->eq('name', 'romanb'));

// 应用到集合
$filteredCollection = $collection->matching($criteria);

逻辑运算符

AND 运算 (andX)

andX方法用于创建多个条件的AND逻辑组合：

$expression = $expressionBuilder->andX(
    $expressionBuilder->eq('foo', 1),
    $expressionBuilder->eq('bar', 1)
);

这相当于SQL中的 foo = 1 AND bar = 1。

OR 运算 (orX)

orX方法用于创建多个条件的OR逻辑组合：

$expression = $expressionBuilder->orX(
    $expressionBuilder->eq('foo', 1),
    $expressionBuilder->eq('bar', 1)
);

这相当于SQL中的 foo = 1 OR bar = 1。

NOT 运算 (not)

not方法用于创建条件的否定：

$expression = $expressionBuilder->not(
    $expressionBuilder->eq('foo', 1)
);

这相当于SQL中的 NOT (foo = 1)。

比较运算符

等于 (eq)

$expression = $expressionBuilder->eq('foo', 1);
// 相当于 foo = 1

不等于 (neq)

$expression = $expressionBuilder->neq('foo', 1);
// 相当于 foo != 1

大于 (gt)

$expression = $expressionBuilder->gt('foo', 1);
// 相当于 foo > 1

小于 (lt)

$expression = $expressionBuilder->lt('foo', 1);
// 相当于 foo < 1

大于等于 (gte)

$expression = $expressionBuilder->gte('foo', 1);
// 相当于 foo >= 1

小于等于 (lte)

$expression = $expressionBuilder->lte('foo', 1);
// 相当于 foo <= 1

特殊条件

空值检查 (isNull)

$expression = $expressionBuilder->isNull('foo');
// 相当于 foo IS NULL

包含于集合 (in)

$expression = $expressionBuilder->in('foo', ['value1', 'value2']);
// 相当于 foo IN ('value1', 'value2')

不包含于集合 (notIn)

$expression = $expressionBuilder->notIn('foo', ['value1', 'value2']);
// 相当于 foo NOT IN ('value1', 'value2')

字符串包含 (contains)

$expression = $expressionBuilder->contains('foo', 'value1');
// 相当于 foo LIKE '%value1%'

成员检查 (memberOf)

$expression = $expressionBuilder->memberOf('foo', ['value1', 'value2']);
// 检查foo是否是给定数组的成员

字符串开头匹配 (startsWith)

$expression = $expressionBuilder->startsWith('foo', 'hello');
// 相当于 foo LIKE 'hello%'

字符串结尾匹配 (endsWith)

$expression = $expressionBuilder->endsWith('foo', 'world');
// 相当于 foo LIKE '%world'

实际应用示例

假设我们有一个用户集合，需要筛选出：

年龄大于18岁且小于30岁
或者名字以"admin"开头
且邮箱不为空的用户

使用表达式构建器可以这样实现：

$expressionBuilder = Criteria::expr();

$ageCondition = $expressionBuilder->andX(
    $expressionBuilder->gt('age', 18),
    $expressionBuilder->lt('age', 30)
);

$nameCondition = $expressionBuilder->startsWith('name', 'admin');

$emailCondition = $expressionBuilder->isNull('email');

$criteria = new Criteria();
$criteria->where(
    $expressionBuilder->orX(
        $ageCondition,
        $nameCondition
    )
);
$criteria->andWhere($expressionBuilder->not($emailCondition));

$filteredUsers = $usersCollection->matching($criteria);