php 8.6可以通过webklex php-imap连接已有邮箱,使用tls登录后按页读取收件箱邮件。只展示列表时可关闭正文抓取,减少大邮件带来的等待;分页读取不等于永久增量同步,邮箱内容变化时还需要以uid和uidvalidity管理业务检查点。

官方文档:IMAP按UID查询和分块读取
安装并准备邮箱专用凭据
composer require webklex/php-imap:^6.2 composer check-platform-reqs
服务商必须已开放IMAP。示例使用993端口的隐式TLS,账号和应用专用密码从环境变量读取;OAuth邮箱应改用服务商要求的认证方式,不把账号主密码写进网页源码。

官方文档:IMAP限制结果和页码
连接后按页读取列表
<?php require __DIR__ . '/vendor/autoload.php';
use Webklex\PHPIMAP\ClientManager;
$client = (new ClientManager())->make([
'host' => getenv('IMAP_HOST'),
'port' => 993,
'encryption' => 'ssl',
'validate_cert' => true,
'username' => getenv('IMAP_USER'),
'password' => getenv('IMAP_PASSWORD'),
'protocol' => 'imap',
]);
$client->connect();
try {
$folder = $client->getFolder('INBOX');
$query = $folder->messages()->all();
$query->leaveUnread();
$query->setFetchBody(false);
$messages = $query->limit(20, 1)->get();
foreach ($messages as $message) {
echo json_encode([
'uid' => $message->getUid(),
'subject' => (string) $message->getSubject(),
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
}
} finally {
$client->disconnect();
}
limit(20, 1)读取第一页,第二个参数为2时跳过前20条。不要先all()->get()拉取全部正文,再对内存集合切片;这不能降低远端读取量。leaveUnread()用于避免抓取过程自动标为已读。
正文和附件按需另取
列表中选定UID后再按业务权限读取相应邮件正文或附件。HTML邮件必须在隔离环境中显示,不能直接拼入管理页面;附件文件名仅作显示信息,落盘路径应由服务器重新生成。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
邮箱新增或删除邮件后,按序号分页可能发生位移。需要归档时应保存邮箱标识、UIDVALIDITY与UID,并在确认处理成功后更新检查点;当前分页示例不包含删除、移动或修改邮件操作。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










