如何在 PHP 中通过Composer安装 PHP-Ical-Parser 库解析 Outlook 的日程文件-composer-PHP中文网

应改用 eluceo/ical 替代已弃用的 icalevent/icalparser，因其支持 php 7.4+、正确解析 outlook 的 vtimezone/rrule/多时区，并需注意 bom 处理、换行统一及手动展开重复事件。

如何在 php 中通过composer安装 php-ical-parser 库解析 outlook 的日程文件

直接执行 `composer require` 会失败，因为库已弃用且未注册到 Packagist

PHP-Ical-Parser（即 icalevent/icalparser）早在 2018 年就停止维护，其 GitHub 仓库被归档，也从未提交到 Packagist。所以运行 composer require icalevent/icalparser 会报错：Could not find package icalevent/icalparser。这不是你网络或配置的问题，是源头不存在。

改用 `composer require` 安装替代库 `eluceo/ical`

目前最活跃、兼容性好、支持 Outlook 导出的 .ics 文件（含 VTIMEZONE、RRULE、多时区等）的替代方案是 eluceo/ical。它原生支持 PHP 7.4+，无需额外 polyfill，且解析逻辑更健壮。

Outlook Calendar & Microsoft 365

Outlook 日历 / Microsoft 365 日历 SECURE API CLI。当用户需要列出、搜索或读取 Outlook / Microsoft 365 日历事件，以及创建……

下载

安装命令：composer require eluceo/ical
Outlook 导出的 .ics 文件通常带 BEGIN:VCALENDAR 和多个 BEGIN:VEVENT，eluceo/ical 能正确提取 DTSTART、DTEND、SUMMARY、DESCRIPTION、LOCATION 等字段
注意：Outlook 有时导出的时区信息不标准（比如用 UTC+8 而非 Asia/Shanghai），eluceo/ical 默认按 UTC 解析；如需本地化，需手动调用 $event->getStartDateTime()->setTimezone(new DateTimeZone('Asia/Shanghai'))

读取 Outlook 的 .ics 文件时，别跳过 BOM 和换行兼容问题

Outlook 导出的 .ics 文件常以 UTF-8 with BOM 开头，且换行符可能是 \r\n。若直接 file_get_contents() 后传给 ICal::parseFile()，某些版本会因 BOM 导致解析失败（报 Invalid calendar data）。

安全读取方式：

$ics = file_get_contents('outlook.ics');
$ics = mb_convert_encoding($ics, 'UTF-8', 'UTF-8'); // 清理 BOM
$ics = str_replace("\r\n", "\n", $ics); // 统一换行
$calendar = new \Eluceo\iCal\Domain\Entity\Calendar();
$parser = new \Eluceo\iCal\Presentation\Factory\CalendarFactory();
$calendar = $parser->createCalendar($ics);

不要用 ICal::initString()（旧版 API），新版 eluceo/ical v3+ 已移除该方法，必须用 CalendarFactory::createCalendar()

解析后获取事件要注意 `RRULE` 和重复事件的展开逻辑

Outlook 日程里常见的“每周五开会”这类重复事件，原始 .ics 只存一条带 RRULE 的 VEVENT，但 eluceo/ical 默认不自动展开——它只提供原始规则对象（$event->getRecurrenceRule()），你需要自己调用 RecurrenceCalculator 才能得到未来 30 天的具体实例。

展开示例：

$calculator = new \Eluceo\iCal\Domain\Service\RecurrenceCalculator();
$occurrences = $calculator->getOccurrences($event, new \DateTime('today'), new \DateTime('+30 days'));