FamilyBook/config.example.php

<?php
/**
 * FamilyBook · 家书 —— 本地配置模板
 *
 * 使用：复制为 config.php，按注释填写。
 * config.php 已在 .gitignore 中忽略，不会进 Git —— 换机器、换库都靠它。
 *
 * ⚠️ 仓库是公开的：这里不许出现真实域名、真实口令、真实密钥。
 */

declare(strict_types=1);

return [

    // ---------------- 站点 ----------------
    'site_name'  => '家书',
    // 站点对外根地址，末尾不要带斜杠。示例值，请替换成你自己的
    'base_url'   => 'https://example.com',

    // ---------------- 数据库（MySQL）----------------
    'db'         => [
        'host'    => '127.0.0.1',
        'port'    => 3306,
        'name'    => 'familybook',
        'user'    => 'familybook',
        'pass'    => '',
        'charset' => 'utf8mb4',
    ],

    // ---------------- 敏感字段加密密钥 ----------------
    // 用于身份证号、手机号的对称加密（openssl AES-256-CBC）。
    // ⚠️ 开始记录数据之后这个值就不能再改：换掉它，已有数据就解不开了。
    // ⚠️ 请单独备份它。密钥丢失 = 数据永久丢失，比数据库丢了还严重。
    //    生成方式：openssl rand -hex 16
    'app_key'    => '请填写32位随机十六进制串',

    // ---------------- 高德地图（旅程的地址联想 / 逆地理 / 导航）----------------
    // 用户 2026-10-05 第 17 批 第 3 条：「出发地和到达地，都用高德地图的接口，
    // 记录详细地址」。
    //
    // ⚠️ 这里要用到**两把不同的 key**（在高德开放平台控制台分别申请）：
    //    · `key`        —— 既是 **Web 服务** key（服务端逆地理 regeo），
    //                      也是 **JS API** key（前端地址输入联想）。
    //                      若两者分开申请，把 Web 服务的填这里，
    //                      JS API 那把填在 `js_key`（见下）；
    //    · `security_js` —— JS API 的**安全密钥**（2021-12-02 之后申请的 key 都要配）。
    //
    // 不填也不影响使用：地址联想不加载、城市聚合自动回落到**离线解析**
    // （从地址文本里提「XX市」），功能都还在，只是联想与逆地理的准确度差一些。
    'amap'       => [
        'key'         => '',
        'security_js' => '',
        // 高德 URI API 的 `src`（调用来源，只用于统计，任意英数字串都行）
        'nav_src'     => '',
    ],

    // ---------------- 调试 ----------------
    // true 时引导页会打印数据库连接错误的详情。
    // ⚠️ 线上务必保持 false —— 错误详情里可能带数据库账号名。
    'debug'      => false,
];