使用Webklex PHP-IMAP获取指定文件夹已标记邮件失败的问题

我尝试从指定文件夹中获取已标记邮件，先后使用以下查询代码：

$folder->query()->not()->unflagged()->setFetchBody(false)->leaveUnread()->get();

$folder->query()->not()->where([["UNFLAGGED"]])->leaveUnread()->get();

执行后抛出错误：

Too few arguments to function Webklex\PHPIMAP\Query\WhereQuery::where(), 0 passed and at least 1 expected

随后我又尝试：

$folder->query()->flagged('Flagged')->setFetchBody(false)->leaveUnread()->get();

但抛出异常：

Webklex \PHPIMAP\ Exceptions\ImapServerErrorException

而以下几种查询语句均可正常执行：

$aMessage = $folder->query()->seen()->setFetchBody(false)->leaveUnread()->get();
$aMessage = $folder->query()->unseen()->setFetchBody(false)->leaveUnread()->get();
$aMessage = $folder->query()->unflagged()->setFetchBody(false)->leaveUnread()->get();
$aMessage = $folder->query()->whereAll()->setFetchBody(false)->leaveUnread()->get();

请问无法获取已标记邮件的原因是什么？我的代码错误出在哪里？

问题分析与解决方案 #

1. 第一个错误的原因

$folder->query()->not()->unflagged() 的链式调用逻辑有误：not() 方法需要绑定具体的查询条件调用，当前写法中 not() 未接收任何参数，直接触发了参数不足的报错。

2. 第二个错误的原因

flagged('Flagged') 传入的参数不符合框架要求：Webklex PHPIMAP的flagged()方法默认无需传参即可查询已标记邮件；若要显式指定flag，应使用框架提供的常量而非自定义字符串，否则会触发IMAP服务器无法识别的错误。

正确的查询写法

你可以选择以下任一方式实现需求：

方式一：直接调用无参flagged()

$aMessage = $folder->query()->flagged()->setFetchBody(false)->leaveUnread()->get();

方式二：使用Flag常量配合where()

use Webklex\PHPIMAP\Support\Flag;

$aMessage = $folder->query()->where(Flag::FLAGGED)->setFetchBody(false)->leaveUnread()->get();

方式三：正确使用not()->unflagged()（部分版本支持）

若你使用的框架版本支持链式否定调用，可调整为：

$aMessage = $folder->query()->not()->unflagged()->setFetchBody(false)->leaveUnread()->get();

注：若此写法仍报错，优先使用前两种方式，部分旧版本框架的not()链式调用存在逻辑bug

额外提示

• 建议升级Webklex PHPIMAP到最新版本，旧版本可能存在方法调用逻辑的兼容性问题；
• ImapServerErrorException 大多因传入了IMAP服务器无法识别的自定义flag字符串导致，使用框架内置的Flag常量可彻底规避这类问题。

内容的提问来源于stack exchange，提问作者Dospi