NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4788 most downloaded on Packagist
Simple iCal parser
Latest stable
v5.0.1
Last release 1 months ago
21 Oct 2026
Release timing varies
gaps range from 3 weeks to 13 months
Nearly every release is documented
notes for 38 of 40 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
40 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
`shell composer require om/icalparser:^5.0.1 `
composer require om/icalparser:^5.0.1
RECURRENCE-ID and RANGE), only the one with the highest SEQUENCE is used, the later one when they are equal. All of them were returned as occurrences before, so an updated instance appeared twice. This applies to occurrences and Item::overrides() of the new API, also to overrides without their recurring item, and to IcalParser::getEvents(), which compares the RECURRENCE-ID as written together with its TZID (#115)Full changelog: https://github.com/OzzyCzech/icalparser/compare/v5.0.0...v5.0.1
RECURRENCE-ID and RANGE), only the one with the
highest SEQUENCE is used, the later one when they are equal, also without the recurring item; all of them were
returned as occurrences (IcalParser compares the RECURRENCE-ID as written with its TZID,
Item::overrides() returns the current revisions) (#115)Your coding agent can read these notes before it upgrades. Set up the MCP server →
…ParserOptions) with the shape of its data, now deprecated and to be removed in 5.5 at the latest. Both use a new recurrence engine and content line pa…
composer require om/icalparser:^5.0
Documentation: https://ozzyczech.github.io/icalparser/
Version 5 adds a new, layered API (om\ICal) for reading and creating calendars and keeps the array based API of
version 4 (IcalParser, EventsList, Freq, Recurrence, ParserOptions) with the shape of its data, now deprecated
and to be removed in 5.5 at the latest. Both use a new recurrence engine and content line parser, which fixes many bugs;
the results of affected calendars differ from 4.x.
See UPGRADING.md. The fixes of 4.1.4 (#37, #88) are included.
ICal::parse(), ICal::parseFile(), ICal::stream() and the configurable ICal::parser() with
ParserMode::Strict / Permissive, ParseLimits, RecurrenceLimits and a ParseResult with structured warningsContentLine, Parameters, LineReader (streams in chunks), TokenizerComponent / Property keeping unknown and X- properties; typed facades Calendar, Event,
Todo, Journal, FreeBusy, Alarm, TimezoneDefinitionDateTimeValue keeps DATE, floating, UTC and zoned times apart; floating times need an explicit timezoneValueParser for all RFC 5545 value typesRANGE=THISANDFUTURE instances, lazy occurrencesBetween()
and occurrences(limit)Validator with severities, Serializer with UTF-8 safe foldingENCODING=QUOTED-PRINTABLE text values are decoded (with a warning), as by IcalParserSyntaxException, InvalidValueException,
InvalidRecurrenceRuleException, TimezoneResolutionException, ResourceLimitException, ValidationException)examples/IMAGE, CONFERENCE, SOURCE, LINK and
CONCEPT are URIs, REFRESH-INTERVAL is a DURATION, ACKNOWLEDGED is a DATE-TIME (the Validator reports a
non-UTC value); VALUE=UID and VALUE=XML-REFERENCE of RFC 9253 (#91)color() and images() (Image) of calendars and items, Calendar::source(),
Calendar::refreshInterval() and Item::conferences() (Conference); of RFC 9253: Item::links() (Link) and
Item::relatedTo() (Relation with RELTYPE and GAP); of RFC 9073: Item::locations() (Location of
VLOCATION components, kept inside their event or task also when their END is missing); of RFC 9074:
Alarm::uid() and Alarm::acknowledged() (#92)Calendar::create() with name, description, color, method,
events, todos, journals, components and properties (backward compatible), Event::new(),
Todo::new(), Journal::new(), Location::new(), Alarm::display(), audio() and email(),
CalAddress::create(); values are formatted and escaped, invalid combinations are rejected, a VTIMEZONE is
generated for every TZID used (VTimezoneBuilder), Calendar::writeFile(); Status, Classification and
Transparency enums (#108)om\RRule\Rule and om\RRule\Expander with all rule parts: BYSETPOS, BYSECOND,
SECONDLY, negative BYWEEKNO and BYYEARDAY, WKST for weekly intervals, date-only UNTILRSCALE and SKIP=OMIT|BACKWARD|FORWARD for RSCALE=GREGORIAN; other calendar systems and leap months
are not expanded as Gregorian (recurrence.unsupported-rscale) (#90)IcalParser::__construct() accepts ParserOptions; untilInterval and shiftEventDates now work and new
options are now (reproducible results), maxOccurrences and strictDTEND of events and instances is derived from DURATION; all-day events without DTEND last one dayIcalParser::parseDuration() for DURATION valuesgetTodos() and getJournals(); DUE and COMPLETED are parsed as datesRDATE;VALUE=PERIOD values (represented by their start)EXDATE;VALUE=DATE removes the occurrence of that day:, ; or , (e.g. CN="Doe, John", ALTREP="http://…")om\TimezoneResolver (TZID resolution with a cache)BEGIN => VCALENDAR and 0 => null entries created by blank or invalid lines_RECURRENCE_IDS is grouped by UID: [uid][recurrence-id] => eventORGANIZER-CN, attendee parameters)END:VALARM) belong to the parent component;
properties of unknown and X- components are stored under the component nameCATEGORIES items are trimmed and escaped commas no longer split themRRULE is ignored (the event keeps DTSTART and RDATE); with strict: true it throws
InvalidArgumentExceptionEXDATE but no RRULE or RDATE get RECURRENCES as well; an empty recurrence set produces no eventDTSTART and DTEND of recurring instances are copies, changing them does not modify the parsed dataparseString() receives property rows only (not BEGIN:VCALENDAR) and counter 0 for calendar
propertiesparseFile() throws RuntimeException when the file cannot be read; invalid input keeps previously parsed dataIcalParser::$timezone is reset for every calendar that is not appendedFreq is an adapter over the new engine: invalid rules throw InvalidArgumentException, maxOccurrences limits
the expansion, Freq::$debug has no effect, lastOccurrence() returns false for an empty set and
previousOccurrence() returns false when there is no earlier occurrence (4.x returned DTSTART)UNTIL are compared in UTC: definitions east of UTC whose daylight saving time ended
(e.g. Europe/Moscow before 2011) are resolved again, west of UTC no transition after UNTIL is kept (#110)RDATE without RRULE no longer fails with TypeError and adds no yearly occurrences (#37, also in 4.1.4)RDATE values are always part of the recurrence set (one was lost together with COUNT)RECURRENCE-ID replaces only the matching instance of the same UID, compared as an instant in any timezone
(4.x compared strings for all events, so it could hide instances of other events or a wrong instance)DTSTARTCOUNT reaching beyond the 3 year horizon are complete (4.x failed with TypeError)BYDAY=-2MO returned
every third Monday), BYHOUR combined with BYMINUTE (minutes were lost) and INTERVAL of weekly rules
(worked around in the parser only partially); Freq with a string rule no longer loops foreverUTC is Etc/UTC, Pacific Standard Time (Mexico) is
America/Tijuana, 40 new names); Outlook display names are kept in a separate fileCompared with 4.1.3 on the sample calendars: expanding recurring events is about 4x faster, parsing a 27 MB calendar with 50 000 events is about 20 % faster with lower peak memory, and sorting 50 000 events is about 13x faster. The new API parses the same 27 MB calendar in 1.1 s with value checks (0.95 s without, 226 MB), streams it in 0.5 s with 2 MB of memory, and converts values lazily.
An event with RDATE and no RRULE no longer throws a TypeError; its occurrences are DTSTART and the RDATE values
RDATE and no RRULE no longer throws a TypeError; its occurrences are DTSTART and the RDATE values (#37)BYMONTHDAY, BYMONTH, …) are compared as integers (#88, thanks @bensynapse)BYMONTH and BYMONTHDAY (for example every January 1st) generate only the first occurrence (#59). This is fixed by the new recurrence engine of the upcoming version 5.0 and will not be fixed in 4.x.Full changelog: https://github.com/OzzyCzech/icalparser/compare/v4.1.3...v4.1.4
Upgrade actions/checkout from v6 to v7 in GitHub Actions workflows
actions/checkout from v6 to v7 in GitHub Actions workflowsnette/tester dev dependency to ^2.6.1Full changelog: https://github.com/OzzyCzech/icalparser/compare/v4.1.2...v4.1.3
Prevent timezone leakage during recurrence parsing
.gitattributes to minimize dist size (#83)Full changelog: https://github.com/OzzyCzech/icalparser/compare/v4.1.1...v4.1.2
Normalize 'Z' timezone to 'UTC' for recurring events
'Z' timezone to 'UTC' for recurring events (#82)fix(IcalParser): Handle multi-segment IANA timezones like America/Argentina/Buenos_Aires and America/Indiana/Indianapolis (fixes #72)
America/Argentina/Buenos_Aires and America/Indiana/Indianapolis (fixes #72)Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.2.1...v4.0.0
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.2.1...v4.0.0
Add php8.6 to experimental test by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/79
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.2.0...v3.2.1
Add PHP 8.5 to test; enable dependabot to update Github Actions by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/77
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.1.1...v3.2.0
chore(docs): remove redundant type by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/76
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.1.0...v3.1.1
Nothing published for this version
Update readme.md by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/70
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.5...v3.0.6
Fix badge image url by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/69
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.4...v3.0.5
Extract CN parameter of ORGANIZER by @cracksalad in https://github.com/OzzyCzech/icalparser/pull/65
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.3...v3.0.4
Multiple ATTENDEE support incl. attendee parameters by @cracksalad in https://github.com/OzzyCzech/icalparser/pull/64
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.2...v3.0.3
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.1...v3.0.2
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.1...v3.0.2
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.0...v3.0.1
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v3.0.0...v3.0.1
Two methods getSortedEvents() and getReverseSortedEvents() are now deprecated in favor of getEvents()->sorted() and getEvents()->reversed() see EventL…
There are some BC breaks getEvents() return EventList ArrayObject instead of plain array.
Two methods getSortedEvents() and getReverseSortedEvents() are now deprecated in favor of getEvents()->sorted() and getEvents()->reversed() see EventList code for more details.
All PHP tests have been rewritten and refactored into a new modern form.
Update WindowsTimezones.php by @lfirewall1243 in https://github.com/OzzyCzech/icalparser/pull/58
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v2.0.0...v2.0.1
ede9e4c7ec567f0646871080ed2afd334ded47b1 - migrate to min php 7.4
Thank's for @Rotzbua for
Nothing published for this version
There can be multiple categories comma separated or in multiple lines
There can be multiple categories comma separated or in multiple lines
CATEGORIES:Anruf
CATEGORIES:Besondere Gelegenheit
CATEGORIES:Feiertag
CATEGORIES:Online
CATEGORIES:Suppliers
or
CATEGORIES:Anruf, Besondere Gelegenheit, Feiertag, Online, Suppliers
BC break: from this version CATEGORIES are always array
Fix #51
Fix for recurring events without end date.
Fix for recurring events without end date.
Will also solve #28
thanks @lokonli for PR
This release contains follow pull requests #45, #46, #47, #48 , #49
This release contains follow pull requests #45, #46, #47, #48 , #49
thanks @Rotzbua
Add non standard timezone 'W. Europe Standard Time 1' by @lokonli in https://github.com/OzzyCzech/icalparser/pull/44
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.6...v0.2.7
Fixes #38 by @tm1000 in https://github.com/OzzyCzech/icalparser/pull/39
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.5...v0.2.6
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.4...v0.2.5
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.4...v0.2.5
fix #22 not working properly by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/26
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.3...v0.2.4
add missing phpdoc by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/25
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.2...v0.2.3
fix use strict compare by @Rotzbua in https://github.com/OzzyCzech/icalparser/pull/24
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.2.1...v0.2.2
Hotfixes and so on Merge * #17 Deal with poorly made ical files * #18 Fix quoted printable encoding credits @cyberbeat @tm1000
Hotfixes and so on
Merge
credits @cyberbeat @tm1000
add support for recurring event closes #16
BC: getEvents(), getReverseSortedEvents() and getSortedEvents() functions now return also RECURRENCES in events
Add support for multiple attachments #14 thanks @drewpc for PR
Now catch exception if event date are in a wrong format (thx @mvachette for PR)
Now catch exception if event date are in a wrong format (thx @mvachette for PR)
Remove timezone prefixes that can be in some ical files thx @mvachette for PR
Remove timezone prefixes that can be in some ical files thx @mvachette for PR
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.0.3...v0.0.4
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.0.3...v0.0.4
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.0.2...v0.0.3
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.0.2...v0.0.3
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.0.1...v0.0.2
Full Changelog: https://github.com/OzzyCzech/icalparser/compare/v0.0.1...v0.0.2
Full Changelog: https://github.com/OzzyCzech/icalparser/commits/v0.0.1
Full Changelog: https://github.com/OzzyCzech/icalparser/commits/v0.0.1
One column per quarter.