如何使用Webklex/PHPIMAP搜索指定邮件？实例化Query类遇阻

问题核心 #

你不能直接实例化WhereQuery和Message类——这两个类是由库内部通过依赖注入生成的，并非手动new创建。文档示例是基于已获取的查询实例编写，并非从零构建实例。

正确实现方式 #

要直接搜索指定UID的邮件，需先获取目标文件夹（或默认文件夹），再通过文件夹的查询方法调用getMessageByUid，具体如下：

方法1：通过指定文件夹查询（推荐） #

use Webklex\PHPIMAP\ClientManager;

$cm = new ClientManager($options = []);                
$client = $cm->make([
    'host'           => '你的IMAP主机',
    'port'           => 993,
    'encryption'     => 'ssl',
    'validate_cert'  => true,
    'username'       => '你的邮箱账号',
    'password'       => '你的邮箱密码',
    'protocol'       => 'imap',
]);
$client->connect(); 

// 获取目标文件夹（示例为收件箱INBOX）
$folder = $client->getFolder('INBOX');
// 生成查询实例
$query = $folder->query();
// 通过UID获取邮件
$message = $query->getMessageByUid($request->id_msg);

方法2：遍历所有文件夹搜索 #

若不确定邮件所在文件夹，可遍历所有文件夹查询：

use Webklex\PHPIMAP\ClientManager;

$cm = new ClientManager($options = []);                
$client = $cm->make([
    'host'           => '你的IMAP主机',
    'port'           => 993,
    'encryption'     => 'ssl',
    'validate_cert'  => true,
    'username'       => '你的邮箱账号',
    'password'       => '你的邮箱密码',
    'protocol'       => 'imap',
]);
$client->connect(); 

$target_message = null;
// 遍历所有文件夹查找目标邮件
foreach ($client->getFolders() as $folder) {
    $query = $folder->query();
    $found_msg = $query->getMessageByUid($request->id_msg);
    if ($found_msg !== null) {
        $target_message = $found_msg;
        break;
    }
}

关键说明 #

• WhereQuery实例需通过Folder::query()或Client::query()方法生成，无法手动new，因为它依赖IMAP客户端连接等内部资源。
• Message类是查询结果的返回值，无需手动实例化，查询到邮件时会自动生成该类实例。
• 部分版本支持客户端级别的全局查询，可尝试$client->query()->getMessageByUid($request->id_msg)，但IMAP协议本身基于文件夹设计，优先通过文件夹查询更稳定。

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