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 / Maria DB：如果您的数据库是用MySQL 5.7.8 / MariaDB 10.2.1或更早的版本创建的，则很可能使用的是COMPACT行格式。这会导致数据库迁移失败，因为索引大小超过了限制。rcmcarddav 4.3.0版本以来的迁移12将行格式转换为当前默认的DYNAMIC，但需要在MySQL / Maria DB配置中进行一些额外的设置，以提高索引键限制至3072字节。有关这些设置，请参阅INSTALL.md。

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

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