文档分类

网站配置详解

快速开始 8 次浏览 2025-12-18 02:01

配置文件位置

网站配置文件路径:/config/config.php

完整配置说明

<?php
return [
    // 网站名称
    // 显示在页面标题、邮件等位置
    "site_name" => "您的公司名称",
    
    // 网站地址(重要!)
    // 必须是完整的URL,末尾不要加斜杠
    // 例如:https://www.example.com
    "site_url" => "https://your-domain.com",
    
    // 管理员邮箱
    // 用于接收系统通知等
    "admin_email" => "admin@your-domain.com",
    
    // 调试模式(重要!)
    // 生产环境必须设为 false
    // 开发环境可设为 true 查看详细错误
    "debug" => false,
    
    // 时区设置
    "timezone" => "Asia/Shanghai",
    
    // 默认语言
    "language" => "zh-CN",
];

site_url 配置说明

这是最重要的配置项之一!

正确格式示例

  • https://www.example.com
  • https://example.com
  • http://192.168.1.100(本地开发)
  • http://localhost(本地开发)

错误格式示例

  • https://www.example.com/(末尾多了斜杠)
  • www.example.com(缺少协议)
  • example.com(缺少协议)

配置错误的影响

  • CSS/JS文件无法加载
  • 图片显示不出来
  • 跳转地址错误
  • 登录后跳转异常

调试模式说明

debug = true(开发模式)

  • 显示详细的PHP错误信息
  • 显示SQL查询错误
  • 便于问题排查

debug = false(生产模式)

  • 隐藏错误详情
  • 只显示友好的错误提示
  • 保护敏感信息不泄露
安全警告:生产环境 debug 必须设为 false!否则可能泄露数据库密码、文件路径等敏感信息!

HTTPS配置

强烈建议配置SSL证书,使用HTTPS访问。

宝塔面板配置SSL

  1. 进入网站设置 → SSL
  2. 可选择"Let's Encrypt"免费证书
  3. 点击"申请"
  4. 勾选"强制HTTPS"
  5. 修改 config.php 中的 site_url 为 https://

HTTPS的好处

  • 数据传输加密,更安全
  • 浏览器不显示"不安全"警告
  • 对SEO有利
  • 部分功能(如复制到剪贴板)需要HTTPS环境

多站点/子目录安装

如果安装在子目录(如 example.com/quote/),需要特别注意:

// site_url 需要包含子目录
"site_url" => "https://example.com/quote",

同时需要修改伪静态规则的 RewriteBase:

RewriteBase /quote/