宝塔面板配置

本文以 宝塔面板 + Nginx + PHP 8.2 为例，完整走一遍建站配置。

一、新建站点

1. 宝塔 → 网站 → 添加站点
2. 填写：

| 字段 | 填什么 | |---|---| | 域名 | xiehui.yourdomain.com（你的域名） | | 根目录 | 自动生成，记住它 | | FTP | 不创建 | | 数据库 | 选 MySQL，创建（记下库名/用户名/密码） | | PHP 版本 | 8.2 |

3. 提交后，宝塔会自动建好站点和数据库。

如果域名还没解析，先在域名商处添加 A 记录指向服务器 IP，等生效（一般 10 分钟）。

二、上传源码

见 源码下载与上传。

上传解压后确认：

/www/wwwroot/xiehui.yourdomain.com/
├── public/
├── storage/
├── .env
└── ...

三、设置运行目录

Laravel 的入口在 public 目录：

1. 站点设置 → 网站目录
2. 运行目录选 /public
3. 保存

这一步不做，访问会 403 或列出目录。

四、伪静态

站点设置 → 伪静态 → 选择 laravel5，或手填：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ \.php$ {
    fastcgi_pass unix:/tmp/php-cgi-82.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
}

五、SSL 证书

1. 站点设置 → SSL → Let's Encrypt
2. 勾选域名 → 申请
3. 开启「强制 HTTPS」

微信公众号、小程序、企微回调都要求 HTTPS，必须配。

六、PHP 扩展与函数

见 系统环境要求 第三节。

关键三个：

# 检查扩展是否都在
php -m | grep -E 'fileinfo|gd|zip|mbstring|openssl|pdo_mysql|curl|bcmath'

七、目录权限

cd /www/wwwroot/xiehui.yourdomain.com
chown -R www:www ./
chmod -R 755 ./
chmod -R 775 storage bootstrap/cache

八、验证

访问 https://你的域名，应该看到协会官网首页。

如果出现：

| 现象 | 原因 | |---|---| | 403 Forbidden | 运行目录没设成 /public | | 500 报错 | 看 storage/logs/laravel.log；多半是权限或 .env 没配 | | 白屏 | PHP 扩展缺失 | | ionCube 报错 | 没装 ionCube Loader |

下一步：数据库配置