如何安装和配置PbootCMS？

PbootCMS 是一款基于 PHP 的开源内容管理系统，以其轻量、免费商用和易于上手著称。它默认支持 SQLite 数据库（无需配置即可使用），同时也支持 MySQL 数据库。

以下是基于服务器环境（以常见的宝塔面板为例）和虚拟主机环境的完整安装与配置教程。
一、 环境准备

在开始之前，请确保你的服务器或虚拟主机满足以下基本要求：

‌PHP 版本‌：推荐 PHP 7.0 ~ 7.4（最低支持 5.3+，不建议使用 PHP 8.1+，可能存在兼容性问题）。
‌必要扩展‌：确保已开启 curl、gd2、mbstring、openssl、pdo_mysql（若用 MySQL）或 pdo_sqlite（若用 SQLite）。
‌Web 服务器‌：Nginx、Apache 或 IIS，需支持伪静态（URL 重写）。
‌域名解析‌：提前将域名解析到服务器 IP。

二、 快速安装步骤（推荐新手/测试使用 SQLite）

PbootCMS 默认使用 SQLite 数据库，无需创建数据库账号密码，上传即用，最适合快速部署。
1. 下载与上传

前往 PbootCMS 官网下载最新版本的 ZIP 压缩包。
‌不要本地解压‌，直接将压缩包上传至网站根目录（如 /www/wwwroot/yourdomain.com 或虚拟主机的 wwwroot/public_html）。
在服务器文件管理器中在线解压压缩包。
‌关键步骤‌：解压后，将所有文件‌剪切/移动‌到网站根目录下，确保 index.php、admin.php 和 config 文件夹直接位于根目录，而不是在一个子文件夹里。
删除上传的 ZIP 包和解压产生的空文件夹，以节省空间并提高安全性。

2. 获取授权码（必做）

PbootCMS 需要绑定域名才能正常访问前台，否则会出现 404 或提示未授权。

访问 PbootCMS 官方免费授权页面。
输入你的域名（不带 http/https），获取 ‌16位永久免费授权码‌。
复制该授权码备用。

3. 登录后台并配置

浏览器访问：http://你的域名/admin.php
‌默认账号‌：admin
‌默认密码‌：admin
注：部分新版本首次登录可能强制要求修改密码，或验证码需刷新一次才能显示。
登录成功后，进入左侧菜单：‌全局配置‌ -> ‌配置参数‌。
找到底部的 ‌“系统授权码”‌ 输入框，粘贴刚才获取的授权码，点击保存。
进入左侧菜单：‌基础内容‌ -> ‌站点信息‌。
在 ‌“站点域名”‌ 处填写你的完整域名（例如 https://www.example.com），点击保存。

此时刷新网站首页，网站应能正常显示。
三、 进阶安装步骤（生产环境推荐 MySQL）

对于正式运营的企业网站，建议使用 MySQL 数据库以获得更好的性能和并发处理能力。
1. 创建数据库

在服务器面板（如宝塔）或虚拟主机控制面板中，新建一个 MySQL 数据库。
记录以下信息：
数据库名 (dbname)
数据库用户名 (user)
数据库密码 (passwd)
数据库地址 (host，通常为 localhost 或 127.0.0.1)
端口 (port，通常为 3306)

2. 导入初始数据

在 PbootCMS 源码包中找到 /static/backup/sql/ 目录。
使用 phpMyAdmin 或数据库管理工具，将对应的 .sql 文件导入到你新建的空数据库中。

3. 修改数据库配置文件

打开网站根目录下的 /config/database.php 文件。
修改配置数组，示例如下：

php
return array(
‘database’ => array(
‘type’ => ‘mysqli’, // 修改为 mysqli
‘host’ => ‘127.0.0.1’, // 数据库地址
‘user’ => ‘你的数据库用户名’,
‘passwd’ => ‘你的数据库密码’,
‘port’ => ‘3306’,
‘dbname’ => ‘你的数据库名’ // 去掉前面的注释符号 //
)
);

注意：确保 ‘type’ 改为 ‘mysqli’，并且 ‘dbname’ 这一行没有被注释掉（即前面没有 //）。
4. 完成授权与站点配置

后续步骤同“快速安装”中的第 2、3 步，获取授权码并在后台填写授权码及站点域名。
四、 关键配置：伪静态（解决栏目页 404）

如果不配置伪静态，点击网站栏目或文章链接时会出现 404 错误。
1. Nginx 环境（宝塔/Linux 常见）

在网站的 Nginx 配置文件中，添加以下规则（通常在 location / 块中）：

nginx
location / {
if (!-e $request_filename) {
rewrite ^/(.*)$ /index.php/$1 last;
}
}

在宝塔面板中，可以直接在网站设置的“伪静态”选项卡中选择 “pbootcms” 或手动填入上述代码。
2. Apache 环境

在网站根目录下创建或修改 .htaccess 文件，内容如下：

apache
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

3. IIS 环境

需在 web.config 中配置 URL Rewrite 规则，或使用 IIS 管理器导入 Apache 的伪静态规则。
五、 安全与维护建议

‌修改后台入口‌：
安装完成后，建议将根目录下的 admin.php 重命名为其他名称（如 mysecretadmin.php），以防止暴力破解后台。记得以后登录时使用新文件名。
‌修改默认密码‌：
登录后立即在“系统用户”中修改 admin 账号的密码。
‌文件权限‌：
Linux 环境下，建议将网站文件所有者设为 www 或 nginx/apache 用户。
目录权限建议设置为 755，文件权限设置为 644。
runtime、upload、static 等目录需要写入权限。
‌定期备份‌：
如果使用 SQLite，直接备份 apps/database/pbootcms.db 文件。
如果使用 MySQL，定期通过 phpMyAdmin 或命令行导出 SQL 文件。
PbootCMS 后台自带“数据库管理”功能，可进行一键备份。

常见问题排查

‌首页空白/500 错误‌：检查 PHP 版本是否过低或过高，检查 runtime 目录是否有写入权限，查看服务器错误日志。
‌后台登录验证码不显示‌：检查 PHP 是否开启了 gd2 扩展。
‌授权码无效‌：确认申请的域名与当前访问域名完全一致（注意 www 和非 www 的区别，建议在后台站点信息中统一设置）。
‌图片无法上传‌：检查 upload 目录权限，以及 PHP 配置中的 upload_max_filesize 和 post_max_size 限制。