README

此包提供了创建iCalendar文件的抽象层。通过使用此PHP包，您可以创建*.ics文件，而无需了解底层格式。输出本身将尽可能遵循RFC 5545。

浏览项目

• 📖 阅读文档
• 🐛 报告错误或建议功能
• 🙋 提出问题
• 💬 开始讨论

安装

您可以通过运行以下命令使用Composer安装此包

composer require eluceo/ical

版本 / 升级

最初版本是在2012年发布的。此包的版本2是对包的完全重写，并且与旧版本不兼容。如果您想从版本0.*迁移到2.*，请参阅升级指南。如果您刚开始使用此包，应安装版本2。

文档

访问ical.poerschke.nrw以获取完整文档。

用法

此包中的类分为两个命名空间

• Domain 包含关于事件的信息。
• Presentation 包含将 Domain 转换为 *.ics 文件的过程。

要创建日历，第一步是创建相应的域对象。然后可以将这些对象转换为iCalendar的PHP表示形式，然后将其转换为字符串。

空事件

在这个非常基本的示例中，它将渲染一个空事件。您将了解如何创建事件域对象，如何将其添加到日历中，以及如何将其转换为iCalendar组件。

1. 创建事件域实体

$event = new \Eluceo\iCal\Domain\Entity\Event();

2. 创建日历域实体

$calendar = new \Eluceo\iCal\Domain\Entity\Calendar([$event]);

3. 将日历域对象转换为表示对象

$iCalendarComponent = (new \Eluceo\iCal\Presentation\Factory\CalendarFactory())->createCalendar($calendar);

4. a) 保存到文件

file_put_contents('calendar.ics', (string) $iCalendarComponent);

4. b) 通过HTTP发送

header('Content-Type: text/calendar; charset=utf-8');
header('Content-Disposition: attachment; filename="cal.ics"');

echo $iCalendarComponent;

完整示例

以下示例将创建一个具有摘要和描述的单日事件。更多示例可以在examples/文件夹中找到。

<?php

require_once __DIR__ . '/../vendor/autoload.php';

// 1. Create Event domain entity
$event = (new Eluceo\iCal\Domain\Entity\Event())
    ->setSummary('Christmas Eve')
    ->setDescription('Lorem Ipsum Dolor...')
    ->setOccurrence(
        new Eluceo\iCal\Domain\ValueObject\SingleDay(
            new Eluceo\iCal\Domain\ValueObject\Date(
                \DateTimeImmutable::createFromFormat('Y-m-d', '2030-12-24')
            )
        )
    );

// 2. Create Calendar domain entity
$calendar = new Eluceo\iCal\Domain\Entity\Calendar([$event]);

// 3. Transform domain entity into an iCalendar component
$componentFactory = new Eluceo\iCal\Presentation\Factory\CalendarFactory();
$calendarComponent = $componentFactory->createCalendar($calendar);

// 4. Set headers
header('Content-Type: text/calendar; charset=utf-8');
header('Content-Disposition: attachment; filename="cal.ics"');

// 5. Output
echo $calendarComponent;

许可协议

此包在MIT许可协议下发布。