# =============================================================
# YwxApp 环境变量模板 (.env.example)
# -------------------------------------------------------------
# 用法：cp `config.example` `.env` 后填写真实值。
# .env 已被 .gitignore 忽略，不会入库。
# 注意：等号两侧不要留空格（`KEY=value`，不能是 `KEY= value` 或 `KEY =value`）。
#      注释行以 `#` 起始；空值表示「使用代码内默认值」（详见各键说明）。
# 章节：① 部署相关 ② 应用基础 ③ 数据库 ④ Redis 缓存 ⑤ 文件存储
#       ⑥ 多语言 ⑦ JWT/鉴权 ⑧ 邮件 ⑨ 数据同步 ⑩ 支付
#       ⑪ 应用市场 / 插件密钥 ⑫ 第三方插件（短信等可选）
# =============================================================

# ==================== ① 部署相关 ====================
# 用于将打包产物（scripts/package_*.php 生成）通过 FTP 推送到生产服务器。
# 该变量是「部署者专用钩子」，不依赖项目内任何脚本——
# 部署脚本（如 PowerShell / Bash 等）由部署方自行维护，scripts/ 内不存在此脚本。
# 部署脚本读取建议：优先环境变量 $env:WXAPP_FTP_PASS / $WXAPP_FTP_PASS，其次本文件。
# 仅用于部署发布，与运行期无关；不需要可留空。
WXAPP_FTP_PASS=

# ==================== ② 应用基础 ====================
# 读取：config/app.php — app_debug / app_host
APP_DEBUG=true
# APP_DEBUG=true  → 显示错误、SQL 日志、关闭模板缓存（仅本地/调试用）
# APP_DEBUG=false → 生产环境务必设为 false
APP_HOST=

# 官方 API 地址：用于框架在线升级、远程市场同步
# 读取：config/ywxapp.php — api_url（env('APP_API_URL', 'https://www.ywxapp.cn')）
# 中心站模式留空或指向本机；客户机模式指向中心站域名。
APP_API_URL=https://www.ywxapp.cn

# 市场角色（控制 is_market_client()）：center / client / auto
# 读取：config/ywxapp.php — market_mode（env('APP_MARKET_MODE', 'auto')）
#   center → 显式锁定本机为中心站（本地开发推荐，不再依赖 api_url 推断）
#   client → 显式锁定本机为客户机（应用市场公开入口会主动 404）
#   auto   → api_url 为空/本机时为中心站，否则为客户机（默认，受 api_url 影响）
# 显式声明优于 auto，避免后续误改 APP_API_URL 时角色被翻转。
APP_MARKET_MODE=auto

# ==================== ③ 数据库（ThinkPHP 标准键） ====================
# 读取：config/database.php
# 安装向导（public/install/Installer.php）会重新写入这些键。
DB_DRIVER=mysql       # default 连接驱动（一般无需修改）
DB_TYPE=mysql         # connections.mysql.type
DB_HOST=127.0.0.1
DB_NAME=ywxapp
DB_USER=root
DB_PASS=
DB_PORT=3306
DB_CHARSET=utf8mb4    # 建议 utf8mb4（emoji/中文兼容）
DB_PREFIX=wxapp_      # 表前缀，安装时由 Installer 统一写入
DB_PERSISTENT=true    # 是否启用长连接（高并发场景视 MySQL 配置决定）

# ==================== ④ Redis 缓存（ThinkPHP 标准键） ====================
# 读取：config/cache.php
REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0

# ==================== ⑤ 文件存储 ====================
# 读取：config/storage.php — default + drivers.{alioss,qcos}
# 取值：local（默认）/ alioss / qcos（其它驱动需在 drivers 中添加）
FILE_STORAGE_DRIVER=local

# ---- 阿里云 OSS（FILE_STORAGE_DRIVER=alioss 时必填）----
ALIOSS_ACCESS_KEY=
ALIOSS_SECRET_KEY=
ALIOSS_ENDPOINT=        # 如 oss-cn-hangzhou.aliyuncs.com
ALIOSS_BUCKET=
ALIOSS_CDN_DOMAIN=      # 可选：启用 CDN 加速域名

# ---- 腾讯云 COS（FILE_STORAGE_DRIVER=qcos 时必填）----
QCOS_REGION=            # 如 ap-guangzhou
QCOS_SECRET_ID=
QCOS_SECRET_KEY=
QCOS_BUCKET=

# ==================== ⑥ 多语言 ====================
# 读取：config/lang.php — default_lang
# 取值：zh-cn / en-us / 自定义语种（需配套语言包）
DEFAULT_LANG=zh-cn

# ==================== ⑦ JWT / 鉴权 ====================
# 后台 / 会员 JWT 鉴权密钥
# 读取：config/jwt.php — secret（默认值仅为占位，生产务必替换）
# HS256 要求 ≥ 256 bits(32 字节)。建议用 `openssl rand -base64 48` 生成。
JWT_SECRET=replace_with_48_byte_base64_strong_random_secret_key_xxxxx

# ==================== ⑧ 邮件 ====================
# 读取：config/mail.php
# 留空时发信功能不会启用；建议使用 SMTP 协议 + SSL。
MAIL_HOST=smtp.example.com
MAIL_PORT=465
MAIL_SECURE=ssl         # ssl / tls / 空
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_FROM=
MAIL_FROM_NAME=YwxApp 应用市场

# ==================== ⑨ 数据同步 ====================
# 读取：config/sync.php — isEnable / baseUrl / key
# 用于「主框架 ↔ 业务后台」数据同步通道（开关、目标地址、共享密钥）。
SYNC_IS_ENABLE=false
SYNC_BASE_URL=https://sync.example.com
SYNC_KEY=your-256-bit-secret-key-here

# ==================== ⑩ 支付 ====================
# 读取：config/pay.php
# 三重防御（已就位）：
#   1) 本键默认关闭（防御性默认，避免默认值泄露）；
#   2) Installer.writeEnv() 会强制把 PAY_MOCK=false 写入 .env；
#   3) MarketService / Market 在生产（APP_DEBUG=false）拒绝执行 mock。
# 本地调试：显式设 PAY_MOCK=true（须与 APP_DEBUG=true 配对）。
PAY_MOCK=false

# 说明：真实的下单 / 验签 / 回调已收拢到支付中心插件 addon/paycenter（见其 README）。
# 下面的 PAY_ALIPAY_* / PAY_WECHAT_* 仍是密钥的唯一来源（不进数据库），插件与核心共用。
# 自检：php think paycenter:check --ping（--channel=alipay|wechat|all）

# ---- 支付宝（证书模式，Yansongda Pay v3.7 的硬性要求）----
# 普通公钥模式在该版本已不被识别，必须在开放平台「接口加签方式」切换为证书并下载三份证书。
# 私钥可填 PEM 全文、单行 base64，或文件路径；三份证书放 runtime/cert/ 下即可（路径可以是相对路径，
# 配 config/pay.php 会按项目根目录解析成绝对路径，避免 Web 入口 CWD 在 public/ 时读不到）。
# 文件名随意，只要与下面三个 *_PATH 对得上：官方下载名分别是
#   appCertPublicKey_*.crt（应用公钥证书）/ alipayCertPublicKey_*.crt（支付宝公钥证书）/ alipayRootCert.crt（根证书）
PAY_ALIPAY_MODE=0                 # 整数：0=正式 1=沙箱 2=服务商（见 Yansongda\Pay\Pay::MODE_*）
PAY_ALIPAY_APP_ID=
PAY_ALIPAY_APP_SECRET_CERT=       # 应用私钥（或填私钥文件路径）
PAY_ALIPAY_APP_PUBLIC_CERT_PATH=runtime/cert/appCertPublicKey.crt
PAY_ALIPAY_PUBLIC_CERT_PATH=runtime/cert/alipayCertPublicKey.crt
PAY_ALIPAY_ROOT_CERT_PATH=runtime/cert/alipayRootCert.crt
# 仅 Windows/未配 curl.cainfo 的 PHP 需要：连网关报 cURL error 60（SSL certificate problem）时，
# 下载 https://curl.se/ca/cacert.pem 放本地并在这里指向它；正常服务器留空即可
PAY_HTTP_CA=

# ---- 微信支付（v3；微信已无官方沙箱，mode 恒为 0，只能真实小额支付后退款）----
# 商户平台 → API 安全：设置 APIv3 密钥、下载 API 证书（apiclient_cert.pem）与私钥（apiclient_key.pem）
PAY_WECHAT_MCH_ID=
PAY_WECHAT_APP_ID=                # 未单独配置时 mp/mini 也用它
PAY_WECHAT_MP_APP_ID=             # 公众号 JSAPI（可选，默认取 APP_ID）
PAY_WECHAT_MINI_APP_ID=           # 小程序（可选，默认取 APP_ID）
PAY_WECHAT_SECRET_KEY=            # APIv3 密钥
PAY_WECHAT_SECRET_CERT=           # 商户 API 私钥（PEM / 单行 base64 / 文件路径）
PAY_WECHAT_PUBLIC_CERT_PATH=runtime/cert/apiclient_cert.pem
# 平台证书（回调验签用）留空即可：SDK 会凭 APIv3 密钥自动下载；
# 生产环境建议 php think paycenter:check 触发一次后落到 runtime/cert/wechat/ 并配置 wechat_public_cert_path。

# ==================== ⑪ 应用市场 / 插件密钥 ====================

# ---- 开发者令牌：后台「发布到官方市场」与 appmall 插件开发者中心共用 ----
# 读取：
#   config/appmall.php              → config('appmall.developer_token')
#   config/ywxapp.php               → config('ywxapp.developer_token')（已与 appmall 同源）
#   app/backend/controller/Addons.php::submitOfficial() 实际取的是上面这个值
# 留空则后台操作时会提示「未配置开发者令牌：请在 .env 设置 APPMARKET_DEV_TOKEN」。
APPMARKET_DEV_TOKEN=

# 开发者账号名（可选，仅用于显示）
APPMARKET_DEV_NAME=

# 远程市场共享密钥：仅当本机作「客户机」连接中心站时需要
# 读取：config/appmall.php → config('appmall.remote_token')
# 单站点中心站模式留空即可；客户机必须与中心站 APPMARKET_REMOTE_TOKEN 一致。
APPMARKET_REMOTE_TOKEN=

# 连接远程市场时是否校验 SSL 证书（生产建议 true）
APPMARKET_SSL_VERIFY=true

# 平台抽成比例（0~1）：插件市场成交时平台分账比例，默认 0.2（20%）
APPMARKET_COMMISSION_RATE=0.2

# 发布前 PHP 语法 + 高危函数扫描（生产建议 true）
APPMARKET_SECURITY_SCAN=true

# ---- 插件签名 / 下载校验密钥（中心站与客户机共享）----
# 读取：config/ywxapp.php — addon_secret
# 生产务必替换为强随机值；中心站与所有客户机必须一致。
ADDON_SECRET=change_me_to_a_strong_addon_secret

# 是否允许未知来源插件（离线包）安装：true 时跳过远程授权校验
# 读取：config/ywxapp.php — unknownsources（仅当 APP_DEBUG=true 时生效）
ADDON_UNKNOWN_SOURCES=false

# 开发者模式开关：开启后后台「插件」出现「设计插件」入口
# 读取：config/ywxapp.php — addon_developer
# 生产务必保持 false（与 APP_DEBUG 解耦的独立开关）。
ADDON_DEVELOPER=false

# ==================== ⑫ 第三方插件（按需启用） ====================
# 短信插件 addon/smssend 需配置网关（由插件自身 config 维护，不一定走 .env）；
# 其他插件的配置项请参考各插件 addon/<name>/README.md。

# =============================================================
# 提示：以下为「代码硬编码、未走 env()」的项目，仅作备忘。
#   config/ywxapp.php: addon_license_check=false  （运行期授权巡检开关，写死 false；
#       如需开启，请直接编辑该文件或后续 PR 改造为 env() 控制）
# =============================================================