Calendars can be read and written using the ICalendar class
use text\ical\ICalendar;
use util\cmd\Console;
use io\File;
$ical= new ICalendar();
$calendar= $ical->read('BEGIN:VCALENDAR...');
$calendar= $ical->read(Console::$in->stream());
$calendar= $ical->read(new File('meeting.ics'));
$ical->write($calendar, Console::$out->stream());
$ical->write($calendar, new File('meeting.ics'));
Typically a calendar contains one event, though the format allows any number, including none at all.
Using first event, typical use-case:
$event= $calendar->events()->first();
To prevent a lang.ElementNotFoundException
when no event is present, check first:
$events= $calendar->events();
if ($events->present()) {
$event= $events->first();
} else {
// Handle situation when no events are inside calendar
}
Process all events:
foreach ($calendar->events() as $event) {
// ...
}
Calendar instances can be created using a fluent interface
use text\ical\{
Calendar,
Event,
Organizer,
Attendee,
IDate,
Text,
Method,
Role,
PartStat
};
$calendar= Calendar::with()
->method(Method::REQUEST)
->prodid('Microsoft Exchange Server 2010')
->version('2.0')
->events([Event::with()
->organizer(new Organizer('The Organizer', 'MAILTO:organizer@example.com'))
->attendees([
Attendee::with()
->role(Role::CHAIR)
->partstat(PartStat::NEEDS_ACTION)
->rsvp('TRUE')
->cn('The Attendee 1')
->value('MAILTO:attendee2@example.com')
->create()
,
Attendee::with()
->role(Role::REQ_PARTICIPANT)
->partstat(PartStat::NEEDS_ACTION)
->rsvp('TRUE')
->cn('The Attendee 2')
->value('MAILTO:attendee3@example.com')
->create()
])
->dtstart(new IDate(null, '20160524T183000Z'))
->dtend(new IDate(null, '20160524T190000Z'))
->location(new Text('de-DE', 'BS 50 EG 0102'))
->summary(new Text('de-DE', 'Treffen'))
->create()
])
->create()
;