sabreUpgrading SabreDAV
Upgrading a major version? Read the upgrade instructions here:
- 0.8.x to 0.9.x
- 1.0.x to 1.2.x
- 1.2.x to 1.3.x
- 1.3.x to 1.4.x
- 1.4.x to 1.5.x
- 1.5.x to 1.6.x
- 1.6.x to 1.7.x
- 1.7.x to 1.8.x
- 1.8.x to 2.0.x
- 2.0.x to 2.1.x
- 2.1.x to 3.0.x
- 3.0.x to 3.1.x
- 3.1.x to 3.2.x
Support length
After the release of a new major SabreDAV (for example, 1.8.0), we will
promise to support the previous version 1.7.* for at least 12 months.
Currently and previously supported versions:
| SabreDAV version | PHP Version | First stable release | End of support |
|---|---|---|---|
| 1.2 | 5.2 | May 2010 | October 2011 (EOL) |
| 1.3 | 5.2 | October 2010 | June 2012 (EOL) |
| 1.4 | 5.2 | February 2011 | November 2012 (EOL) |
| 1.5 | 5.2 | August 2011 | February 2013 (EOL) |
| 1.6 | 5.3 | February 2012 | November 2013 (EOL) |
| 1.7 | 5.3 | October 2012 | July 2014 (EOL) |
| 1.8 | 5.3 | November 2012 | May 2015 (EOL) |
| 2.0 | 5.4 | May 2014 | December 2015 (EOL) |
| 2.1 | 5.4 | November 2014 | September 2016 (EOL) |
| 3.0 | 5.4 | June 2015 | January 2017 |
| 3.1 | 5.5 | January 2016 | June 2017 |
| 3.2 | 5.5 | June 2016 |
Versioning scheme
SabreDAV uses three digits for versions. x.y.z.
The first part, x, is reserved for major overhauls of SabreDAV.
The y part is also for fairly large releases. We try to have one or two of
these per year, but this fluctuates.
The z is reserved for minor upgrades.
If you are upgrading from a version, to a version that only changes the last digit, it should always be safe to do so.
To do this with composer, just run:
composer update sabre/dav
This should automatically do all the work. This should be 100% risk free, except in cases where we are fixing a major security issue, and we are not able to do so, without breaking backwards compatibility.
This means an upgrade from 2.1.2 to 2.1.3 is always safe. Upgrading from
2.0.6 to 2.1.0 is not.
For versions where we are changing x or y, we almost always want to break
backwards compatibility in some areas. Depending on what features you are
using in SabreDAV you may or may not be affected by this.
Alpha and beta versions
Alpha and beta versions always have the word 'alpha' or 'beta' in them. In alpha versions it is highly likely that we are not done yet, and will still want to make changes.
Beta versions should not get any BC-breaking changes, but they still may.