环境变量配置（.env）

.env 是系统的总配置，改完必须执行：

php artisan config:clear
php artisan cache:clear

否则不生效。

一、基础配置

APP_NAME="协会管理系统"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://xiehui.yourdomain.com

| 键 | 说明 | |---|---| | APP_NAME | 系统名称（后台标题） | | APP_ENV | 生产环境固定 production | | APP_DEBUG | 生产必须 false（true 会暴露报错详情，有安全风险） | | APP_URL | 完整域名，含 https，不要带斜杠 |

二、数据库

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=xiehui
DB_USERNAME=xiehui
DB_PASSWORD=你的密码

三、缓存与队列

CACHE_STORE=database
QUEUE_CONNECTION=database
SESSION_DRIVER=database

队列用 database 驱动，配合定时任务跑 queue:work（见下一篇）。

四、支付配置

微信支付

WECHAT_PAY_MCH_ID=商户号
WECHAT_PAY_APP_ID=公众号AppID
WECHAT_PAY_KEY=API密钥
WECHAT_PAY_CERT_PATH=/www/wwwroot/你的域名/storage/certs/apiclient_cert.pem
WECHAT_PAY_KEY_PATH=/www/wwwroot/你的域名/storage/certs/apiclient_key.pem

支付宝

ALIPAY_APP_ID=支付宝AppID
ALIPAY_PRIVATE_KEY=应用私钥
ALIPAY_PUBLIC_KEY=支付宝公钥

支付开关在后台「系统设置 → 支付设置」里，也可以在后台直接配，不必改 .env。

五、AI 配置（可选）

系统支持多家 AI 服务商，后台「AI 设置」里配：

AI_DEFAULT_PROVIDER=deepseek
AI_DEEPSEEK_KEY=sk-xxxx
AI_DEEPSEEK_MODEL=deepseek-chat

建议在后台配（可随时改），.env 留空也行。

六、邮件（SMTP）

MAIL_MAILER=smtp
MAIL_HOST=smtp.qq.com
MAIL_PORT=465
MAIL_USERNAME=你的邮箱@qq.com
MAIL_PASSWORD=邮箱授权码
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=你的邮箱@qq.com
MAIL_FROM_NAME="协会名称"

QQ 邮箱的密码是授权码不是登录密码，在 QQ 邮箱设置 → 账户 → 开启 SMTP → 生成授权码。

七、文件存储

FILESYSTEM_DISK=public

上传的图片、档案都存在 storage/app/public，通过 public/storage 软链接访问。

必须执行一次：

php artisan storage:link

八、授权码

LICENSE_CODE=XH-2026-XXXX-XXXX
LICENSE_SERVER=https://cy.yunfenxiang.net

授权码在后台「授权状态」里也能看和改。如果系统提示未授权，先检查这两项。

九、改完验证

php artisan config:clear
php artisan cache:clear
php artisan about

php artisan about 会显示当前环境、缓存驱动、数据库连接状态，确认都正常。

下一步：定时任务配置