Packagist · #800 most downloaded on Packagist

sabre/vobject

5.0.028M downloads/mosabre-io/vobject ↗New releases in your daily digest, changelog included.

The VObject library for PHP allows you to easily parse and manipulate iCalendar and vCard objects

Last release 2 months ago
07 Jul 2026
Release timing varies
gaps range from 3 weeks to 10 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
99 releases · first in 2012

Release timeline

99 releases since 2012

2012201420162018

Releases

3.3.39 Oct 2014
Support for "Line Islands Standard Time" windows timezone.
#142: CANCEL and REPLY messages now include the DTSTART from the original event.

#143: SCHEDULE-AGENT on the ORGANIZER property is respected.

#144: PARTSTAT=NEEDS-ACTION is now set for new invites, if no PARTSTAT is set to support the inbox feature of iOS.

#147: Bugs related to scheduling all-day events.

#148: Ignore events that have attendees but no organizer.

#149: Avoiding logging errors during timezone detection. This is a workaround for a PHP bug.

Support for "Line Islands Standard Time" windows timezone.

#154: Correctly work around vCard parameters that have a value but no name.
Open source →
3.3.219 Sept 2014
Changed: iTip broker now sets RSVP status to false when replies are received.
Changed: iTip broker now sets RSVP status to false when replies are received.

#118: iTip Message now has a getScheduleStatus() method.

#119: Support for detecting 'significant changes'.

#120: Support for SCHEDULE-FORCE-SEND.

#121: iCal demands parameters containing the + sign to be quoted.

#122: Don't generate REPLY messages for events that have been cancelled.

#123: Added SUMMARY to iTip messages.

#130: Incorrect validation rules for RELATED (should be RELATED-TO).

#128: ATTACH in iCalendar is URI by default, not BINARY.

#131: RRULE that doesn't provide a single valid instance now throws an exception.

#136: Validator rejects all control characters. We were missing a few.

#133: Splitter objects will throw exceptions when receiving incompatible objects.

#127: Attendees who delete recurring event instances events they had already declined earlier will no longer generate another reply.

#125: Send CANCEL messages when ORGANIZER property gets deleted.

One column per quarter.

3.3.118 Aug 2014

Changed: It's now possible to pass DateTime objects when using the magic setters on properties. ($event->DTSTART = new DateTime('now')).

Changed: It's now possible to pass DateTime objects when using the magic setters on properties. ($event->DTSTART = new DateTime('now')).
#111: iTip Broker does not process attendee adding events to EXDATE.
#112: EventIterator now sets TZID on RECURRENCE-ID.
#113: Timezone support during creation of iTip REPLY messages.
#114: VTIMEZONE is retained when generating new REQUEST objects.
#114: Support for 'MAILTO:' style email addresses (in uppercase) in the iTip broker. This improves evolution support.
#115: Using REQUEST-STATUS from REPLY messages and now propagating that into SCHEDULE-STATUS.

Open source →

3.3.07 Aug 2014

We now use PSR-4 for the directory structure. This means that everything that was used to be in the lib/Sabre/VObject directory is now moved to lib/.

We now use PSR-4 for the directory structure. This means that everything that was used to be in the lib/Sabre/VObject directory is now moved to lib/. If you use composer to load this library, you shouldn't have to do anything about that though.
VEVENT now get populated with a DTSTAMP and UID property by default.
BC Break: Removed the 'includes.php' file. Use composer instead.
#103: Added support for processing [iTip][iTip] messages. This allows a user to parse incoming iTip messages and apply the result on existing calendars, or automatically generate invites/replies/cancellations based on changes that a user made on objects.
#75, #58, #18: Fixes related to overriding the first event in recurrences.
Added: VCalendar::getBaseComponent to find the 'master' component in a calendar.
#51: Support for iterating RDATE properties.
Fixed: Issue #101: RecurrenceIterator::nextMonthly() shows events that are excluded events with wrong time

Open source →

3.2.414 Jul 2014

Added: Issue #98. The VCardConverter now takes X-APPLE-OMIT-YEAR into consideration when converting between vCard 3 and 4.

Added: Issue #98. The VCardConverter now takes X-APPLE-OMIT-YEAR into consideration when converting between vCard 3 and 4.
Fixed: Issue #96. Some support for Yahoo's broken vcards.
Fixed: PHP 5.3 support was broken in the cli tool.

Open source →

3.2.312 Jun 2014

Validator now checks if DUE and DTSTART are of the same type in VTODO, and ensures that DUE is always after DTSTART.

Validator now checks if DUE and DTSTART are of the same type in VTODO, and ensures that DUE is always after DTSTART.
Removed documentation from source repository, to http://sabre.io/vobject/
Expanded the vobject cli tool validation output to make it easier to find issues.
Fixed: vobject repair. It was not working for iCalendar objects.

Open source →

3.2.27 May 2014

Minor tweak in unittests to make it run on PHP 5.5.12. Json-prettifying slightly changed which caused the test to fail.

Minor tweak in unittests to make it run on PHP 5.5.12. Json-prettifying slightly changed which caused the test to fail.

Open source →

3.2.13 May 2014

Minor tweak to make the unittests run with the latest hhvm on travis.

Minor tweak to make the unittests run with the latest hhvm on travis.
Updated timezone definitions.
Updated copyright links to point to http://sabre.io/

Open source →

3.2.02 Apr 2014

The validator can now detect a _lot_ more problems. Many rules for both iCalendar and vCard were added.

Now hhvm compatible!
The validator can now detect a lot more problems. Many rules for both iCalendar and vCard were added.
Added: bin/generate_vcards, a utility to generate random vcards for testing purposes. Patches are welcome to add more data.
Updated: Windows timezone mapping to latest version from unicode.org
Changed: The timezone maps are now loaded in from external files, in lib/Sabre/VObject/timezonedata.
Added: Fixing badly encoded URL's from Google contacts vcards.
Fixed: Issue #68. Couldn't decode properties ending in a colon.
Fixed: Issue #72. RecurrenceIterator should respect timezone in the UNTIL clause.
Fixed: Issue #67. BYMONTH limit on DAILY recurrences.
Fixed: Issue #26. Return a more descriptive error when coming across broken BYDAY rules.
Fixed: Issue #28. Incorrect timezone detection for some timezones.
Fixed: Issue #70. Casting a parameter with a null value to string would fail.
Added: Support for rfc6715 and rfc6474.
Added: Support for DateTime objects in the VCard DATE-AND-OR-TIME property.
Added: UUIDUtil, for easily creating unique identifiers.
Fixed: Issue #83. Creating new VALUE=DATE objects using php's DateTime.
Fixed: Issue #86. Don't go into an infinite loop when php errors are disabled and an invalid file is read.

Open source →

3.1.430 Mar 2014

Fixed: Issue #87: Several compatibility fixes related to timezone handling changes in PHP 5.5.10.

Fixed: Issue #87: Several compatibility fixes related to timezone handling changes in PHP 5.5.10.

Open source →

3.1.32 Oct 2013

Fixed: Support from properties from draft-daboo-valarm-extensions-04. Issue

Fixed: Support from properties from draft-daboo-valarm-extensions-04. Issue #56.
Fixed: Issue #54. Parsing a stream of multiple vcards separated by more than one newline. Thanks @Vedmak for the patch.
Fixed: Serializing vcard 2.1 parameters with no name caused a literal '1' to be inserted.
Added: VCardConverter removed properties that are no longer supported in vCard 4.0.
Added: vCards with a minimum number of values (such as N), but don't have that many, are now automatically padded with empty components.
Added: The vCard validator now also checks for a minimum number of components, and has the ability to repair these.
Added: Some support for vCard 2.1 in the VCard converter, to upgrade to vCard 3.0 or 4.0.
Fixed: Issue 60 Use Document::$componentMap when instantiating the top-level VCalendar and VCard components.
Fixed: Issue 62: Parsing iCalendar parameters with no value.
Added: --forgiving option to vobject utility.
Fixed: Compound properties such as ADR were not correctly split up in vCard 2.1 quoted printable-encoded properties.
Fixed: Issue 64: Encoding of binary properties of converted vCards. Thanks @DominikTo for the patch.

Open source →

3.1.213 Aug 2013

Fixed: Setting correct property group on VCard conversion

Fixed: Setting correct property group on VCard conversion

Open source →

3.1.12 Aug 2013

Fixed: Issue #53. A regression in RecurrenceIterator.

Fixed: Issue #53. A regression in RecurrenceIterator.

Open source →

3.1.027 Jul 2013

Added: bad-ass new cli debugging utility (in bin/vobject).

Added: bad-ass new cli debugging utility (in bin/vobject).
Added: jCal and jCard parser.
Fixed: URI properties should not escape ; and ,.
Fixed: VCard 4 documents now correctly use URI as a default value-type for PHOTO and others. BINARY no longer exists in vCard 4.
Added: Utility to convert between 2.1, 3.0 and 4.0 vCards.
Added: You can now add() multiple parameters to a property in one call.
Added: Parameter::has() for easily checking if a parameter value exists.
Added: VCard::preferred() to find a preferred email, phone number, etc. for a contact.
Changed: All $duration properties are now public.
Added: A few validators for iCalendar documents.
Fixed: Issue #50. RecurrenceIterator gives incorrect result when exception events are out of order in the iCalendar file.
Fixed: Issue #48. Overridden events in the recurrence iterator that were past the UNTIL date were ignored.
Added: getDuration for DURATION values such as TRIGGER. Thanks to @SimonSimCity.
Fixed: Issue #52. vCard 2.1 parameters with no name may lose values if there's more than 1. Thanks to @Vedmak.

Open source →

3.0.021 Jun 2013

Fixed: includes.php file was still broken. Our tool to generate it had some bugs.

Fixed: includes.php file was still broken. Our tool to generate it had some bugs.

Open source →

3.0.0-beta421 Jun 2013pre-release

Fixed: includes.php was no longer up to date.

Fixed: includes.php was no longer up to date.

Open source →

3.0.0-beta317 Jun 2013pre-release

Added: OPTION_FORGIVING now also allows slashes in property names.

Added: OPTION_FORGIVING now also allows slashes in property names.
Fixed: DateTimeParser no longer fails on dates with years < 1000 & > 4999
Fixed: Issue 36: Workaround for the recurrenceiterator and caldav events with a missing base event.
Fixed: jCard encoding of TIME properties.
Fixed: jCal encoding of REQUEST-STATUS, GEO and PERIOD values.

Open source →

3.0.0-beta17 Jun 2013pre-release

Added: jsonSerialize() for creating jCal and jCard documents.

Added: jsonSerialize() for creating jCal and jCard documents.
Added: helper method to parse vCard dates and times.
Added: Specialized classes for FLOAT, LANGUAGE-TAG, TIME, TIMESTAMP, DATE-AND-OR-TIME, CAL-ADDRESS, UNKNOWN and UTC-OFFSET properties.
Removed: CommaSeparatedText property. Now included into Text.
Fixed: Multiple parameters with the same name are now correctly encoded.
Fixed: Parameter values containing a comma are now enclosed in double-quotes.
Fixed: Iterating parameter values should now fully work as expected.
Fixed: Support for vCard 2.1 nameless parameters.
Changed: $valueMap, $componentMap and $propertyMap now all use fully-qualified class names, so they are actually overridable.
Fixed: Updating DATE-TIME to DATE values now behaves like expected.

Open source →

3.0.0-alpha431 May 2013pre-release

Added: It's now possible to send parser options to the splitter classes.

Added: It's now possible to send parser options to the splitter classes.
Added: A few tweaks to improve component and property creation.

Open source →

3.0.0-alpha324 May 2013pre-release

Changed: propertyMap, valueMap and componentMap are now static properties.

Changed: propertyMap, valueMap and componentMap are now static properties.
Changed: Component::remove() will throw an exception when trying to a node that's not a child of said component.
Added: Splitter objects are now faster, line numbers are accurately reported and use less memory.
Added: MimeDir parser can now continue parsing with the same stream buffer.
Fixed: vobjectvalidate.php is operational again.
Fixed: \r is properly stripped in text values.
Fixed: QUOTED-PRINTABLE is now correctly encoded as well as encoded, for vCards 2.1.
Fixed: Parser assumes vCard 2.1, if no version was supplied.

Open source →

3.0.0-alpha222 May 2013pre-release

Fixed: vCard URL properties were referencing a non-existent class.

Fixed: vCard URL properties were referencing a non-existent class.

Open source →

3.0.0-alpha121 May 2013pre-release

Fixed: Now correctly dealing with escaping of properties. This solves the problem with double-backslashes where they don't belong.

Fixed: Now correctly dealing with escaping of properties. This solves the problem with double-backslashes where they don't belong.
Added: Easy support for properties with more than one value, using setParts and getParts.
Added: Support for broken 2.1 vCards produced by microsoft.
Added: Automatically decoding quoted-printable values.
Added: Automatically decoding base64 values.
Added: Decoding RFC6868 parameter values (uses ^ as an escape character).
Added: Fancy new MimeDir parser that can also parse streams.
Added: Automatically mapping many, many properties to a property-class with specialized API's.
Added: remove() method for easily removing properties and sub-components components.
Changed: Components, Properties and Parameters can no longer be created with Component::create, Property::create and Parameter::create. They must instead be created through the root component. (A VCalendar or VCard object).
Changed: API for DateTime properties has slightly changed.
Changed: the ->value property is now protected everywhere. Use getParts() and getValue() instead.
BC Break: No support for mac newlines (\r). Never came across these anyway.
Added: add() method to the Property class.
Added: It's now possible to easy set multi-value properties as arrays.
Added: When setting date-time properties you can just pass PHP's DateTime object.
Added: New components automatically get a bunch of default properties, such as VERSION and CALSCALE.
Added: You can add new sub-components much quicker with the magic setters, and add() method.

Open source →

2.1.721 Jan 2015

Fixed: Issue #94, a workaround for bad escaping of ; and , in compound properties. It's not a full solution, but it's an improvement for those stuck i

Fixed: Issue #94, a workaround for bad escaping of ; and , in compound properties. It's not a full solution, but it's an improvement for those stuck in the 2.1 versions.

Open source →

2.1.610 Dec 2014

Fixed: Minor change to make sure that unittests succeed on every PHP version.

Fixed: Minor change to make sure that unittests succeed on every PHP version.

Open source →

2.1.53 Jun 2014

Fixed: #94: Better parameter escaping.

Fixed: #94: Better parameter escaping.
Changed: Documentation cleanups.

Open source →

2.1.430 Mar 2014

Fixed: Issue #87: Several compatibility fixes related to timezone handling changes in PHP 5.5.10.

Fixed: Issue #87: Several compatibility fixes related to timezone handling changes in PHP 5.5.10.

Open source →

2.1.32 Oct 2013

Fixed: Issue #55. \r must be stripped from property values.

Fixed: Issue #55. \r must be stripped from property values.
Fixed: Issue #65. Putting quotes around parameter values that contain a colon.

Open source →

2.1.22 Aug 2013

Fixed: Issue #53. A regression in RecurrenceIterator.

Fixed: Issue #53. A regression in RecurrenceIterator.

Open source →

2.1.127 Jul 2013

Fixed: Issue #50. RecurrenceIterator gives incorrect result when exception events are out of order in the iCalendar file.

Fixed: Issue #50. RecurrenceIterator gives incorrect result when exception events are out of order in the iCalendar file.
Fixed: Issue #48. Overridden events in the recurrence iterator that were past the UNTIL date were ignored.

Open source →

2.1.017 Jun 2013

This version is fully backwards compatible with 2.0.\*. However, it contains a few new API's that mimic the VObject 3 API. This allows it to be used a

This version is fully backwards compatible with 2.0.*. However, it contains a few new API's that mimic the VObject 3 API. This allows it to be used a 'bridge' version. Specifically, this new version exists so SabreDAV 1.7 and 1.8 can run with both the 2 and 3 versions of this library.
Added: Property\DateTime::hasTime().
Added: Property\MultiDateTime::hasTime().
Added: Property::getValue().
Added: Document class.
Added: Document::createComponent and Document::createProperty.
Added: Parameter::getValue().

Open source →

2.0.75 Mar 2013

Fixed: Microsoft re-uses their magic numbers for different timezones, (specifically id 2 for both Sarajevo and Lisbon). A workaround was added to deal

Fixed: Microsoft re-uses their magic numbers for different timezones, (specifically id 2 for both Sarajevo and Lisbon). A workaround was added to deal with this.

Open source →

2.0.617 Feb 2013

Fixed: The reader now properly parses parameters without a value.

Fixed: The reader now properly parses parameters without a value.

Open source →

2.0.55 Nov 2012

Fixed: The FreeBusyGenerator is now properly using the factory methods for creation of components and properties.

Fixed: The FreeBusyGenerator is now properly using the factory methods for creation of components and properties.

Open source →

2.0.42 Nov 2012

Added: Known Lotus Notes / Domino timezone id's.

Added: Known Lotus Notes / Domino timezone id's.

Open source →

2.0.329 Oct 2012

Added: Support for 'GMT+????' format in TZID's.

Added: Support for 'GMT+????' format in TZID's.
Added: Support for formats like SystemV/EST5EDT in TZID's.
Fixed: RecurrenceIterator now repairs recurrence rules where UNTIL < DTSTART.
Added: Support for BYHOUR in FREQ=DAILY (@hollodk).
Added: Support for BYHOUR and BYDAY in FREQ=WEEKLY.

Open source →

2.0.26 Oct 2012

Added: includes.php file, to load the entire library in one go.

Added: includes.php file, to load the entire library in one go.
Fixed: A problem with determining alarm triggers for TODO's.

Open source →

2.0.121 Sept 2012

Removed: Element class. It wasn't used.

Removed: Element class. It wasn't used.
Added: Basic validation and repair methods for broken input data.
Fixed: RecurrenceIterator could infinitely loop when an INTERVAL of 0 was specified.
Added: A cli script that can validate and automatically repair vcards and iCalendar objects.
Added: A new 'Compound' property, that can automatically split up parts for properties such as N, ADR, ORG and CATEGORIES.
Added: Splitter classes, that can split up large objects (such as exports) into individual objects (thanks @DominikTo and @armin-hackmann).
Added: VFREEBUSY component, which allows easily checking whether timeslots are available.
Added: The Reader class now has a 'FORGIVING' option, which allows it to parse properties with incorrect characters in the name (at this time, it just allows underscores).
Added: Also added the 'IGNORE_INVALID_LINES' option, to completely disregard any invalid lines.
Fixed: A bug in Windows timezone-id mappings for times created in Greenlands timezone (sorry Greenlanders! I do care!).
Fixed: DTEND was not generated correctly for VFREEBUSY reports.
Fixed: Parser is at least 25% faster with real-world data.

Open source →

2.0.07 Aug 2012

VObject is now a separate project from SabreDAV. See the SabreDAV changelog for version information before 2.0.

VObject is now a separate project from SabreDAV. See the SabreDAV changelog for version information before 2.0.
New: VObject library now uses PHP 5.3 namespaces.
New: It's possible to specify lists of parameters when constructing properties.
New: made it easier to construct the FreeBusyGenerator.

Open source →

3.0.0beta210 Jun 2013

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →