赞片CMS.env文件

学完这篇，你能独立找到并改对赞片CMS的 .env 文件，让网站连上数据库、切换调试模式，出问题时也能自己排查。

第一步：先搞清楚 .env 文件在哪、是干什么的

.env 是赞片CMS（基于 ThinkPHP 框架）在项目根目录下的一个纯文本配置文件，用来存放数据库账号密码、调试开关这类"每个站点都不一样"的参数。它的作用是：让你改配置时不用去动 config/database.php 这类框架代码文件，升级程序也不会把配置覆盖掉。

定位路径：假设你的站点根目录是 /www/wwwroot/zp.com，那文件就在 /www/wwwroot/zp.com/.env，和 application、public、think 这些是同级的。

用宝塔面板操作的话：进入「文件」→ 左侧点开 /www/wwwroot/zp.com → 右上角「设置」旁边勾选 显示隐藏文件，因为以点开头的文件默认是隐藏的，不勾根本看不见。

注意：有些赞片CMS版本根目录里给的是 .env.example 或 env.txt，需要你先把它重命名成 .env（前面那个点别丢）。没有这个文件时，程序会回落到 config/ 目录下的默认配置，这时候你改 .env 是不生效的。

第二步：看懂里面每一行长什么样

用「编辑」打开后，内容基本是 键 = 值 的形式，一行一个，# 开头的是注释。典型结构：

APP_DEBUG = false

[database]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = zanpian
USERNAME = zanpian
PASSWORD = 你的数据库密码
HOSTPORT = 3306
PREFIX = zp_

[database] 这种方括号是分组，同一组里的键才归到一起。APP_DEBUG = false 是全局的，没在分组里。

第三步：改数据库连接

这一步的目标是让程序能从 .env 读到正确的库名和账号。需要你去宝塔「数据库」页面查到对应的信息，然后填进去：

• HOSTNAME：数据库和网站同一台服务器就填 127.0.0.1，别填 localhost，某些环境下会走 socket 解析失败。
• DATABASE：数据库名，比如 zanpian。
• USERNAME / PASSWORD：宝塔数据库页里那个用户名和密码，直接复制，别手打。
• HOSTPORT：默认 3306，如果你改过 MySQL 端口就同步改。
• PREFIX：表前缀，安装时填的是什么就写什么，写错了程序会提示"表不存在"。

注意：值的前后不要加引号。ThinkPHP 的 .env 解析会把引号当成值的一部分，PASSWORD = "abc123" 实际读到的密码就是 "abc123"，连不上数据库。密码里如果有 #，要写成 \# 或者换一个不含 # 的密码。

第四步：切换调试模式并清缓存

上线后 APP_DEBUG 保持 false；本地调试或排查报错时改成 true，页面会显示详细错误堆栈，定位问题快很多。

改完保存后必须清缓存，否则新配置不生效：

rm -rf /www/wwwroot/zp.com/runtime/*

或者用宝塔文件管理器进到 runtime 目录，全选删除里面的内容（目录本身留着）。

注意：APP_DEBUG = true 时网站对外开放，报错页会泄露数据库账号等信息，排查完立刻改回 false 再清一次缓存。

第五步：验证是否生效

刷新网站首页和后台登录页。能正常打开、能登录后台，说明数据库配置读对了。如果报"数据库连接失败"，按这个顺序查：.env 文件名是否真的是 .env（不是 .env.txt）→ 数据库账号密码能否在 phpMyAdmin 里登录 → 是否已删 runtime 缓存 → 文件编码是否为 UTF-8 无 BOM。

注意：用 Windows 记事本另存时容易带上 BOM 头，会导致配置解析整体错位。建议用宝塔自带的编辑器或者 Notepad++，编码选「UTF-8」，不要选「UTF-8-BOM」。

小结

• .env 在站点根目录，宝塔文件管理器要勾选「显示隐藏文件」才看得见。
• 格式是 键 = 值，方括号 [database] 是分组，井号是注释。
• 值不要加引号，密码里的 # 要转义。
• 改完必须删 runtime 目录下的缓存文件才生效。
• 调试开关 APP_DEBUG 排查完记得改回 false。
• 文件编码必须是 UTF-8 无 BOM。