README

需求

RCMCardDAV 5.x需要至少PHP 7.4。依赖关系由composer管理，如果您感兴趣，请查看composer.json文件。

支持的roundcube版本和支持的数据库版本可以在SUPPORTED_ENVIRONMENT.md中找到。

有关（卸）载说明，请参阅INSTALL.md。

有关各种主题的（希望不断增加的）文档可以在doc文件夹中找到。目前以下内容可用

通常（即使是补丁版本），在升级RCMCardDAV时，请在升级前从roundcube注销，并在升级完成后重新登录。在登录过程中，将执行可能必要的数据库模式升级，因此登录步骤对于完成升级很重要。

数据库迁移将自动进行。但是，将地址簿分配给账户使用了一种启发式方法（有关详细信息，请参阅CHANGELOG.md），这可能会为用户创建的账户产生额外的账户。在这种情况下，用户必须手动清理，在设置界面中删除这些账户。
某些配置的插件配置在向后不兼容的方式中更改。请参阅ADMIN-SETTINGS.md以获取新配置选项的完整详细信息。特别关注
- 预设的URL的语义在特殊情况下已更改，即当通过URL直接指定用户地址簿家目录外的地址簿时（用例：未共享到用户命名空间中的共享地址簿）。指定无法发现的地址簿的新方法是使用extra_addressbooks。
- 预设的地址簿的发现URL现在必须通过discovery_url预设属性提供，url在预设中不再可用，并用于额外地址簿的URL。
- 已删除carddav_name_only选项。
- 已删除rediscover_mode选项。现在您可以通过配置新选项rediscover_time来指定地址簿重新发现应执行的时间间隔。

数据库迁移将自动进行。
如果您想比默认日志更详细，现在必须在config.inc.php中配置。请参阅提供的文件config.inc.php.dist中的示例。
对于 MySQL / MariaDB：如果您使用 MySQL 5.7.8 / MariaDB 10.2.1 或更早版本创建了数据库，则可能使用的是 COMPACT 行格式。这会导致数据库迁移失败，因为索引大小超过了限制。自 rcmcarddav 4.3.0 版本以来的迁移 12 将行格式转换为当前默认的 DYNAMIC，但在 MySQL / MariaDB 配置中需要一些额外的设置来增加索引键限制到 3072 字节。有关这些设置，请参阅 INSTALL.md。

从 2.0.x 版本没有支持升级路径。您需要手动删除 RCMCardDAV 2.0.x，从数据库中删除其表，然后从头开始安装。

从 1.0 版本没有升级路径。您需要手动删除 RCMCardDAV 1.0，从数据库中删除其表，然后从头开始安装。