php-recurring-date 库已停止维护且不兼容 PHP 8+，强行安装会导致依赖解析失败或运行时致命错误；推荐改用 recurr（支持 RFC 5545、PHP 8 兼容）或 eluceo/icalendar（处理完整 .ics 文件）。
直接说结论：php-recurring-date 库已停止维护，且不兼容 PHP 8+，强行安装会触发致命错误或解析失败——别用它。
为什么 composer require jakejohns/php-recurring-date 会失败
这个包最后更新是 2016 年，依赖过时的 symfony/event-dispatcher v2.x 和 phpunit v4，Composer 在 PHP 8.1+ 下会拒绝解析其依赖树。常见报错包括：
Could not resolve package jakejohns/php-recurring-dateConclusion: Package jakejohns/php-recurring-date is abandonedRoot composer.json requires jakejohns/php-recurring-date *, it is satisfiable by jakejohns/php-recurring-date[dev-master] but these conflict with your requirements
即使加 --ignore-platform-reqs 强装，运行时也会因 DateTimeZone::__construct() 调用方式不兼容而抛出 Fatal error: Uncaught TypeError。
替代方案：改用 recurr（推荐）或 icalendar
recurr 是目前最活跃、PHP 8 兼容、语法简洁的循环日期计算库，支持 RFC 5545（iCalendar）标准中的 RRULE 解析。
立即学习“PHP免费学习笔记（深入）”；
安装命令：
composer require josegonzalez/php-recurr
基本用法示例：
$rule = new \Recurr\Rule('FREQ=WEEKLY;BYDAY=MO,WE,FR;COUNT=5');
$transformer = new \Recurr\Transformer\ArrayTransformer();
$dates = $transformer->transform($rule, new \DateTime('2024-01-01')); // 返回 DateTime[]
注意点：
-
RRULE字符串必须大写，BYDAY=mo,we,fr会静默失败，得写成BYDAY=MO,WE,FR -
ArrayTransformer默认只生成未来 1 年内的日期，如需更多，传入第三个参数：new \DateInterval('P3Y') - 不支持
EXDATE或RDATE扩展，需手动过滤
如果必须处理 iCalendar 文件（.ics），用 icalevent
当你的输入源是完整日历文件（含多条 VEVENT 和嵌套 RRULE），recurr 就不够用了。此时推荐：
composer require eluceo/icalendar
它能解析 .ics 内容并提取所有重复事件实例：
$calendar = new \Eluceo\ICal\Component\Calendar();
$event = new \Eluceo\ICal\Component\Event();
$event->setRecurrenceRule('FREQ=DAILY;COUNT=3');
$calendar->addEvent($event);
echo $calendar->render(); // 输出标准 .ics 字符串
关键限制：
- 它本身不“展开”重复规则，只是生成或读取；要计算具体日期，仍需搭配
recurr处理getRecurrenceRule()返回值 - 读取现有 .ics 文件时，对非标准字段（如自定义属性）会跳过，不报错也不警告
真正麻烦的不是怎么装，而是判断你实际需要的是「规则解析」还是「日历交换」——前者用 recurr，后者绕不开 eluceo/icalendar 配合手动展开。没人会告诉你 RRULE 的 WKST（周起始日）默认是 MO，但如果你的业务按周日为一周起点，所有 BYDAY 计算都会偏移一天。
