从 BoxBilling 迁移到 FOSSBilling

请注意，一些遗留的BoxBilling功能，尤其是论坛，已在FOSSBilling中删除。虽然论坛帖子和用户信息在迁移后将保留在数据库中，但它们不会在新安装中以任何方式显示。

有关更完整的信息，请参阅更改日志。

对BoxBilling和FOSSBilling之间的区别感兴趣吗？我们的常见问题解答涵盖了为什么存在FOSSBilling，以及两者之间一些更重要的区别。

更新的系统要求

自从BoxBilling分叉以来，FOSSBilling发生了重大变化，作为其中的一部分，系统要求发生了变化。我们建议审查记录在案的系统要求。

迁移说明

在您做任何事情之前，请确保对数据库和当前BoxBilling安装中的所有文件进行完整备份（或两个）。如果出现问题，不这样做将使您无法恢复数据。

上次测试的迁移从BoxBilling版本4.22.1.5到FOSSBilling版本0.5.6。对于更新于0.5.6的FOSSBilling版本，事情应该仍然没有问题，但是如果从早于4.22.1.5的BoxBilling版本进行更新，您应该会遇到问题。如果您正在运行BoxBilling的过时版本，您应该首先创建备份，然后更新到最新版本，以确保事情进展顺利。

由于平稳迁移的重要性，我们建议首先克隆您的BoxBilling实例，并在单独的实例上进行测试迁移。这样做将使您有机会发现该过程的任何潜在问题或误解，以便以最少的停机时间进行实际迁移尽可能顺利。

突破性的变化

请注意，自从BoxBilling进行叉以来，FOSSBilling已经进行了重大更改，如果不先更新，所有自定义主题和模块很可能将不再工作。我们建议阅读更改日志以查看“破坏更改”。

下载最新版本

使用此链接下载最新版本的FOSSBilling：最新稳定版本

准备您现有的安装

为BoxBilling创建的主题将无法在FOSSBilling内部运行，需要手动移植才能与FOSSBilling兼容。

  1. 对您的数据库以及BoxBilling安装中的所有现有文件和文件夹进行完整备份。
  2. 删除“bb-vendor”和“bb-themes”文件夹（如果您使用的是自定义主题，请创建主题的备份）。
  3. 重命名以下文件夹和文件以删除bb-前缀：
    • bb-data -> data
    • bb-library -> library
    • bb-locale -> locale
    • bb-modules -> modules
    • bb-uploads -> uploads
    • bb-config.php -> config.php
  4. 删除以下文件：
    • bb-cron.php (您需要更新您的cron 作业以指向cron.php)
    • bb-di.php
    • bb-load.php
    • rb.php
    • bb-ipn.php
    • bb-update.php
    • 您还应该删除下面的所有文件和文件夹 data/cache

阅读这个: 在更新文件夹结构的过程中，bb-ipn.php已重命名为ipn.php。如果可能的话，您应该创建一个从bb-ipn.php到ipn.phpon您的服务器的虚拟别名。如果您无法做到这一点，您必须创建ipn.php的副本，并将其命名为bb-ipn.php，以便旧订阅继续运行。

上传和提取FOSSBilling文件

在现有BoxBilling安装中的文件上上传和提取预览构建存档的内容，并替换任何现有文件。

删除安装文件夹

删除“安装”文件夹和其中的所有文件。由于您已经安装了BoxBilling，因此您无需再次通过FOSSBilling安装程序。

迁移配置文件和数据库

  1. 编辑您的config.php文件，并将/bb-data/的所有引用更新为/data/。
  2. 导航到example.com/run-patcherto使用FOSSBilling的备份修补方法。这将自动迁移配置文件和数据库，使其与当前版本的FOSSBilling兼容。
  3. 迁移后，您可能需要编辑配置文件并重新配置本地化设置，例如时区，因为FOSSBilling已经改变了这些设置的存储方式。默认值将代替原件。
  4. 您可能需要打开数据库，找到设置表，然后手动将配置的主题更新为huraga。