如何填写 .env 配置文件 - prinsss/blessing-skin-server GitHub Wiki

🤔 什么是 .env？

.env 是一个文件（请不要惊讶为什么文件名可以像这样），其中保存了 Blessing Skin 最基础的配置信息（数据库信息、密码安全、邮件发送配置 etc.）。想要 Blessing Skin 正常工作，你必须正确填写该文件中的配置项。

刚下载的 Blessing Skin 安装包并不默认包含 .env 文件，您必须手动创建它。

🙄 如何创建 .env 文件？

安装包中默认包含了一个 .env.example 配置模板文件，直接把它重命名为 .env 即可。

如果看不到 .env.example 这个文件，请打开你文件浏览器的「显示隐藏文件（以 . 开头的文件）」的选项。

重命名之前你也可以创建一个副本作为备份。

对于 Windows 用户，请遵循如下步骤：

  1. 右键 .env.example 文件并点击「重命名」；
  2. 在输入框中将该文件重命名为 .env.（注意，最后有一个点符号 .）；
  3. 按下回车确认，文件名最后的 . 将会自动消失；
  4. 你已完成重命名操作（是的，Windows 就是这么神秘）。

Linux / macOS 用户直接 cp .env.example .env 就好了，不用我多说吧。

😉 配置文件字段详解

为了支持国际化，我把 .env 的注释换成通用的英文了，但是似乎很多用户都云里雾里的，所以下面介绍一下各个字段的含义。

👉 调试开关

请务必在生产环境（线上环境）下关闭 APP_DEBUG（即设置为 false），不然你的数据库信息可能被泄露。 相反，如果遇到什么错误要报告的话请开启这个选项以获得报错的详细堆栈信息。

👉 数据库相关

  1. DB_HOST MySQL 数据库主机，一般为 localhost
  2. DB_PORT MySQL 数据库端口，一般为 3306
  3. DB_DATABASE 数据库名，自行修改
  4. DB_USERNAME 数据库用户名
  5. DB_PASSWORD 数据库用户密码
  6. DB_PREFIX 数据表前缀，当你有在一个数据库中安装多个皮肤站的需求时，请为每个皮肤站设置不同的数据表前缀

👉 安全相关

  1. PWD_METHOD 用户密码加密方式，可选的值有：
    • PHP_PASSWORD_HASH（默认的，也是安全性最高的）
    • MD5
    • SALTED2MD5（加盐与不加的区别，下同）
    • SHA256
    • SALTED2SHA256
    • SHA512
    • SALTED2SHA512
  2. SALT 盐用于 Token 和密码加密，请更改为任意随机字符串
  3. APP_KEY 用于框架内各种东西的加密，格式为 "base64:".base64_encode(random_bytes(32))

SALT 和 APP_KEY 都可以选择在安装时自动随机生成。

👉 邮件相关

邮件配置主要用用户邮箱验证与发送密码重置邮件。

如果你使用 SMTP，请添加以下字段（内容自行修改）：

MAIL_DRIVER = smtp
# 邮件主机地址
MAIL_HOST = smtp.example.com
# 邮件主机端口
MAIL_PORT = 465
# 邮件发送人（填完整邮箱地址）
MAIL_USERNAME = [email protected]
# 密码
MAIL_PASSWORD = secret
# 加密方式，一般为 tls 或者 ssl
MAIL_ENCRYPTION = tls

如果你使用 Mailgun，请添加以下字段：

MAIL_DRIVER = mailgun
MAIL_USERNAME = [email protected]
MAILGUN_DOMAIN = example.com
MAILGUN_SECRET = api-key

如果你使用 sendmail，请添加以下字段：

MAIL_DRIVER = sendmail
SENDMAIL_COMMAND = '/usr/sbin/sendmail -bs' #注意用引号包起来

将 MAIL_DRIVER 设置为空即可停用所有邮件相关的功能。

嗯？你说还有其他字段没提到？

那些的话，你看的懂就自己改，看不懂的话就别瞎折腾。