om/icalparser

Simple ical parser

, _(*1)

PHP iCal Parser

Internet Calendaring Parser rfc2445 or iCal parser is simple PHP class for parsing format into array., _(*2)

, _(*3)

How to install

The recommended way to is via Composer:, _(*4)

```shell script composer require om/icalparser, <sub>(*5)</sub>

## Usage and example

```php
<?php
use om\IcalParser;
require_once '../vendor/autoload.php';

$cal = new IcalParser();
$results = $cal->parseFile(
    'https://www.google.com/calendar/ical/cs.czech%23holiday%40group.v.calendar.google.com/public/basic.ics'
);

foreach ($cal->getEvents()->sorted() as $event) {
    printf('%s - %s' . PHP_EOL, $event['DTSTART']->format('j.n.Y'), $event['SUMMARY']);

}

Each property of each event is available using the property name (in capital letters) as a key. There are some special cases:, <sub>(*6)</sub>

• multiple attendees with individual parameters: use ATTENDEES as key to get all attendees in the following scheme:

[
    [
        'ROLE' => 'REQ-PARTICIPANT',
        'PARTSTAT' => 'NEEDS-ACTION',
        'CN' => 'John Doe',
        'VALUE' => 'mailto:john.doe@example.org'
    ],
    [
        'ROLE' => 'REQ-PARTICIPANT',
        'PARTSTAT' => 'NEEDS-ACTION',
        'CN' => 'Test Example',
        'VALUE' => 'mailto:test@example.org'
    ]
]

• organizer's name: the CN parameter of the organizer property can be retrieved using the key ORGANIZER-CN

You can run example with PHP Built-in web server as follow:, <sub>(*7)</sub>

php -S localhost:8000 -t example

Requirements

• PHP 8.1+

Run tests

iCal parser using Nette Tester. The tests can be invoked via composer., <sub>(*8)</sub>

shell script composer update composer test, <sub>(*9)</sub>