Import a *.ics file (provided with WebDAV) into a CalDAV server as calendar events
-
copy files to destination folder
-
run Composer
- e.g.
docker run -it --rm -v `pwd`:/app composer install --ignore-platform-reqs
- e.g.
-
in
configdirectory- rename
config.sample.inc.phptoconfig.inc.phpand adjust according to your needs. Everything in$configis mandadtory (examples are based on a Nextcloud server, having calendar to update and*.icsfile in same account) - maybe set
$config['loglevel'](line 40) to the level of your desire
- rename
-
call
https://example.com/ics2caldav.phporphp ics2caldav.phpand wait for response -
to use docker:
- built it
docker build -t ics2caldav . - run it
docker run --rm -v /path/to/config:/ics2caldav:ro --name ics2caldav ics2caldav - on first run the sample config will get copied into the volume and the container exits
- built it
WARNING: Script will delete content of provided calendar and replace it with events from provided *.ics file.
First test it on your development server, before going to production!
Script supports basic synchronisation: If an event in *.ics file has the same summary (title), start date, end date, location and description as an event on CalDAV server, it is considered the same and thus not processed any further for performance reasons. Keep in mind and extend this to your needs (see include/vevent_hash.php for details).
Script is thought to be run as cronjob, so currently there are no optimizations regarding performance (everything is done sequentially, even though it could be parallelized). As every action is done with one HTTP(S) request, whole process is quite slow. The performance I achieve is roughly 2.6 events per second (delete and create)
I have an *.ics file which regularly gets updated with events. I want to have read access to these events through a Nextcloud calendar. Import using Nextcloud is possible, but only manually.
Using ownCloud there was a community provided script using some (internal PHP) ownCloud API do do that. This API got removed somewhere in development, and so that automatic import didn't work anymore - but I really wanted to have it.
So I thought a bit about that problem and finally decided, I would write my own script doing that - but this time using the public (and more stable) HTTP(S) API that ownCloud/Nextcloud provides: CalDAV and WebDAV. Positive side effect: there are already libraries out there that one can use.
- Sabre\VObject (done with Composer)
allow_url_fopenenabled (if WebDAV used)
- PHP 7.2.13, 7.4.7
- Nextcloud 15.0.4, 15.0.5, 15.0.14
Should be compatible with other CalDAV and WebDAV servers
- validity/error checks and reporting (e.g. don't delete events if
*.icsfile can't be found) - parallelizing the requests for performance (configurable number of workers)
Contributions (code/patches/pull requests) welcome
Sources can be retrieved from these git repositories: