Frappe 中的 common_site_config

Frappe 是一个基于 Python 和 JavaScript 开发的全栈 Web 应用开发平台。在 Frappe 中，common_site_config 是一个非常重要的配置文件，它包含了应用程序的基本设置、数据库连接信息、文件存储设置等等，本文将为你介绍 Frappe 中的 common_site_config。

common_site_config 的作用

common_site_config 是一个 Frappe 应用程序的配置文件，它存储了大量的配置信息，例如：

• 应用程序基本设置
• 数据库连接信息
• 文件存储设置
• 电子邮件设置
• 日志和调试设置
• 安全设置
• 第三方应用程序设置

这些设置信息对于应用程序的正常运行都是非常重要的。

common_site_config 的结构

common_site_config 文件是一个 JSON 格式的文件，它包含了多个键值对，每个键值对代表一个配置项。下面是一个 common_site_config 文件的示例：

{
    "db_name": "frappe",
    "db_password": "password",
    "developer_mode": 1,
    "encryption_key": "encryption_key",
    "error_report_email": "admin@example.com",
    "file_watcher_port": 6787,
    "server_script": "/usr/bin/frappe-bench/frappe-bench/env/bin/gunicorn",
    "socketio_port": 9000,
    "restart_supervisor_on_update": 1,
    "limits": {
        "space_usage": {},
        "daily_api_call": "1000"
    },
    "backup_watcher_port": 6790,
    "retry_failed_emails_after": "300",
    "google_maps_api_key": "",
    "migrate_doctype": "",
    "scheduler_interval": "3600",
    "restart_supervisor_on_update_doctype": ""
}

常见的配置项包括：

• db_name：数据库名称
• db_password：数据库密码
• developer_mode：开发者模式
• encryption_key：加密密钥
• error_report_email：错误报告邮件地址
• file_watcher_port：文件监视器端口号
• server_script：Web 服务器脚本路径
• socketio_port：Socket.IO 端口号
• restart_supervisor_on_update：更新应用程序时重启 Supervisor
• limits：限制项
• backup_watcher_port：备份监视器端口号
• retry_failed_emails_after：邮件发送失败后重试时间（秒）
• google_maps_api_key：Google Maps API 密钥
• migrate_doctype：数据类型迁移
• scheduler_interval：调度时间间隔
• restart_supervisor_on_update_doctype：更新数据类型时重启 Supervisor

编辑 common_site_config

你可以通过编辑 common_site_config 文件来更改应用程序的配置项。但需注意，更改 common_site_config 文件可能会导致应用程序出现错误。

为了编辑 common_site_config 文件，你需要进入到 Frappe 应用程序的安装目录，并找到 config 目录中的 common_site_config.json 文件。通过编辑该文件，你就可以更改应用程序的配置项了。

总结

common_site_config 是 Frappe 应用程序的一个非常重要的配置文件，它包含了应用程序的所有重要设置信息。通过了解和编辑 common_site_config 文件，你可以更好地控制你的应用程序。