How do I parse a .ics file with sabre/vobject?

Use VObject\Reader::read() to parse the file content. For example, `$vcalendar = VObject\Reader::read(file_get_contents('event.ics'));` lets you access properties easily. Check the iCalendar documentation on sabre.io for more details.

sabre/vobject vs iCalcreator - which is better for PHP?

sabre/vobject is often preferred for its active maintenance, RFC compliance, and SabreDAV integration. iCalcreator is older but functional; choose based on need for modern APIs or specific ecosystem features.

How to handle recurring events in PHP using sabre/vobject?

Use the recurrence rule expansion feature by calling methods like expand() on calendar components. This generates individual instances for date ranges, handling complex patterns as documented.

Does sabre/vobject support vCard 4.0?

Yes, it supports vCard 4.0 per RFC 6350, along with older versions. It can parse, generate, and manipulate vCard 4.0 objects for modern contact data.

What's the performance impact for large .ics files?

Performance is adequate for standard use, but with thousands of events, object creation can slow processing. Optimize by chunking data or using caching if needed.

Can I install sabre/vobject without Composer?

It's possible but not recommended. Manual installation may cause dependency issues; Composer is the standard method, though you can download source and autoload manually.

Open-Awesome

VObject

BSD-3-ClausePHP5.0.0

A PHP library for parsing and manipulating iCalendar and vCard objects with a complete, easy-to-use API.

Visit Website GitHub

600 stars135 forks0 contributors

What is VObject?

sabre/vobject is a PHP library that enables developers to parse, generate, and manipulate iCalendar and vCard objects. It solves the problem of handling standardized calendar and contact data formats in PHP applications, providing tools for reading, writing, validating, and modifying .ics and .vcf files with full RFC compliance.

Target Audience

PHP developers building applications that need to process calendar events (like scheduling systems) or contact information (like CRM or address book tools), particularly those requiring interoperability with other calendar/contact services.

Value Proposition

Developers choose sabre/vobject because it offers a comprehensive, easy-to-use API for a complex domain, with strong adherence to RFC standards, active maintenance, and integration with the broader SabreDAV ecosystem for full CalDAV/CardDAV server capabilities.

Overview

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

Use Cases

Best For

Parsing and generating .ics files for event calendars in web applications
Processing vCard contact data in PHP-based address book or CRM systems
Building CalDAV or CardDAV servers with the SabreDAV ecosystem
Validating and repairing iCalendar/vCard objects from external sources
Handling recurring calendar events with complex rules in PHP
Converting between different versions of vCard or iCalendar formats

Not Ideal For

Applications that only need to read .ics or .vcf files without modification—a lighter parser might suffice.
Projects stuck on very old PHP versions (below 5.3) without upgrade paths, due to limited legacy support.
Real-time systems processing thousands of calendar events per second, as it's not optimized for extreme performance.
Teams wanting all documentation in a single, centralized guide—it's split across separate pages.

Pros & Cons

Pros

Full RFC Compliance

Supports iCalendar (RFC 5545) and vCard (RFC 6350) standards, ensuring interoperability across systems as per the library's goal.

Easy-to-Use API

Provides simplified methods for reading and writing calendar/contact objects, reducing the need for deep protocol knowledge, as highlighted in features.

Comprehensive Feature Set

Includes advanced capabilities like recurrence rule expansion and timezone handling, covering most needs for calendar and contact manipulation.

Validation and Repair

Offers tools to validate objects against specs and fix common issues, essential for dealing with malformed data from external sources.

Cons

PHP Version Constraints

Requires PHP 5.5 or higher, with separate versions for older PHP 5.3/5.4, complicating deployment in fixed-version environments.

Documentation Fragmentation

Documentation is split into separate pages for vCard and iCalendar usage, making it harder to navigate for comprehensive guides.

Performance Overhead

For large datasets, the library's comprehensive nature can introduce overhead, as it's not optimized for high-throughput scenarios.

Ecosystem Dependency

Tightly integrated with SabreDAV, which may add unnecessary complexity for projects not needing CalDAV/CardDAV features.

Frequently Asked Questions

Related Projects

Parsedown

Better Markdown Parser in PHP

Stars15,061

Forks1,137

Last commit5 months ago

PHP Markdown

Parser for Markdown and Markdown Extra derived from the original Markdown.pl by John Gruber.

Stars3,464

Forks519

Last commit1 year ago

CommonMark PHP

Highly-extensible PHP Markdown parser which fully supports the CommonMark and GFM specs.

Stars2,969

Forks214

Last commit10 hours ago

HTML to Markdown

Convert HTML to Markdown with PHP

Stars1,898

Forks215

Last commit1 month ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub