FOSSBilling 配置文件

FOSSBilling 的配置文件

配置文件可以在 /config.php。您可以根据您的偏好调整配置文件。您还可以在这里找到带有一些文档的示例配置文件。

配置参数

以下配置参数可用于自定义 FOSSBilling：

安全选项

这些配置选项允许您在 FOSSBilling 内部配置安全选项。建议使用默认值，除非它们导致问题。

  • security.mode: 设置安全模式。可用选项是严格的（默认）或 regular.
  • security.force_https: 确定是否强制 HTTPS 连接。设置为 true 强制 HTTPS（推荐）或 false 允许 HTTP 连接。
  • security.cookie_lifespan: 在几秒钟内设置会话 cookie 的寿命。默认值是 7200 (2  小时)。

Salt

  • salt: 当 FOSSBilling 需要执行可逆加密时，此密钥实际上被用作加密密钥。

安装 URL

  • url: 设置安装 FOSSBilling 的完整 URL，包括尾随斜杠。

管理区 URL 前缀

  • admin_area_prefix: 设置 URL 前缀以访问 FOSSBilling 管理区域。例如，将其设置为 /admin for https://example.com/admin。

调试

  • debug: 启用或禁用显示高级调试消息。建议将此禁用 (false) 除非你在调试问题。

自动更新程序

  • update_branch: 为自动更新程序配置更新分支。目前可接受的选项是 "release" 或 "preview"。

Stacktrace 配置

  • log_stacktrace: 抛出异常时启用或禁用堆栈跟踪（需要启用 debug）。
  • stacktrace_length: 指定堆栈跟踪的最大长度。

维护模式

  • maintenance_mode.enabled: 启用或禁用系统维护模式。启用后，它会阻止公众访问您的网站，除允许的端点外，API端点将无法工作。
  • maintenance_mode.allowed_urls: 指定维护期间未被阻止的URL。支持通配符匹配。
  • maintenance_mode.allowed_ips: 指定维护期间未被阻止的IP/子网地址。

自动 Cron 执行

  • disable_auto_cron: 登录管理面板时禁用回退自动 cron 执行。

默认本地化

这些配置选项允许您配置默认本地化设置。

  • i18n.locale: 设置默认区域设置。默认值是 en_US。
  • i18n.timezone: 设置默认时区。默认值是 UTC。
  • i18n.date_format: 设置默认日期格式。可用的选项是 none, short, medium, 和 long。
  • i18n.time_format: 设置默认时间格式。可用的选项是 none, short, medium, 和 long。
  • i18n.datetime_pattern: 指定格式化日期和时间的自定义模式。

数据存储和日志记录

  • path_data: 设置存储敏感数据的位置。
  • path_logs: 设置应用程序日志文件的路径。（整个应用程序没有正确尊重该参数）
  • log_to_db: 启用或禁用对数据库的登录。

数据库配置

  • db.type: 指定数据库类型。默认值是 mysql。
  • db.host: 指定数据库主机名。 (通常 127.0.0.1 或 localhost)。
  • db.name: 指定 FOSSBilling 的数据库名称。
  • db.user: 指定数据库用户名。
  • db.password: 指定数据库密码。
  • db.port: 指定数据库端口。默认值是 3306。

Twig 配置

  • twig.debug: 启用或禁用 Twig 调试。设置为 true 启用 Twig 调试模式。
  • twig.auto_reload: 启用或禁用  Twig 自动重新加载模板。
  • twig.cache: 为 Twig 模板设置缓存目录。

API 配置

  • api.require_referrer_header: 确定向 API 提出的所有请求是否必须具有与 FOSSBilling 安装相同的 URL 的引用请求头。
  • api.allowed_ips: 指定允许访问API的IP 地址。一个空数组允许所有IP。
  • api.rate_span: 设置速率限制的时间跨度（以秒为单位）。
  • api.rate_limit: 设置每个时间跨度允许的最大请求数。
  • api.throttle_delay: 指定达到速率限制时以秒为单位的节流延迟。
  • api.rate_span_login: 以秒为单位设置速率限制登录请求的时间跨度。
  • api.rate_limit_login: 设置每个时间跨度允许的最大登录请求数。
  • api.CSRFPrevention: 启用或禁用令牌的使用，以保护系统免受CSRF攻击。