php 8.6读取带重复规则的ics日程时,可以用sabre/vobject解析文件,再用expand()限定起止时间展开事件。展开结果需接收为新的日历对象,不能只调用方法后继续遍历原对象;这样才能把每周例会、例外日期和单次改期放在同一条处理路径中。

官方文档:重复日程支持的规则
准备库和读取范围
安装sabre/vobject 5.0.0,并确认CLI实际运行PHP 8.6及mbstring。下面处理服务器固定路径的ICS文件,时间窗口使用UTC;不要直接把任意远程地址交给读取器。
composer require sabre/vobject:^5.0 php -v composer check-platform-reqs

官方文档:展开日程返回新对象与时间范围限制
展开一个月的事件
<?php
require __DIR__ . '/vendor/autoload.php';
use Sabre\VObject\Reader;
use Sabre\VObject\Component\VCalendar;
$path = __DIR__ . '/calendar.ics';
if (!is_file($path) || filesize($path) > 2 * 1024 * 1024) {
throw new RuntimeException('日历文件不存在或超过大小限制');
}
$calendar = Reader::read(file_get_contents($path));
if (!$calendar instanceof VCalendar) {
throw new RuntimeException('需要VCALENDAR文件');
}
$expanded = $calendar->expand(
new DateTime('2026-12-01T00:00:00Z'),
new DateTime('2027-01-01T00:00:00Z')
);
foreach ($expanded->VEVENT as $event) {
echo json_encode([
'uid' => (string) $event->UID,
'summary' => (string) $event->SUMMARY,
'start' => $event->DTSTART->getDateTime()->format(DATE_ATOM),
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
}同一重复系列的UID通常保持一致,具体实例可再用RECURRENCE-ID区分。写入业务数据库前,应把系列标识和实例标识共同作为去重依据,不能只凭标题判断是否同一事件。
核对时区和例外实例
用包含RRULE、EXDATE及RECURRENCE-ID的固定样例检查输出:例外日期不应再出现,改期实例应使用修改后的开始时间。跨时区日历应保留DTSTART上的TZID,不把本地时间强行补成Z。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
sabre/vobject支持多种常见重复规则,但并不覆盖RFC5545全部组合。官方特别提醒限制展开范围;对无限重复或极密集日程,应限制文件大小、窗口长度和进程内存,不能一次展开几十年。
立即学习“PHP免费学习笔记(深入)”;


















