问答社区

推荐 PivArk 对服务器环境有什么要求？

推荐 PHP 8.1+、MySQL 5.7+/8.0、Nginx 或 Apache，开启 PDO、mbstring、openssl、fileinfo 等常用扩展。首次部署可走 Web 安装向导自动检测，详见 快速开始。

推荐 网站根目录应该指向哪里？

须指向含 index.php 的项目根目录（不是单独的 public 子目录）。根目录错误时常见现象：首页能开、后台 403 或静态资源 404。

推荐 如何用安装向导完成首次部署？

上传安装包后访问站点域名，按向导填写数据库、管理员账号；完成后会写入 data/site.env 与 data/install.lock。

推荐 如何重装？需要删哪些文件？

与其他 CMS 一样，只需删除 data/install.lock 后访问 /install。向导会自动覆盖 site.env、清理 data/runtime 缓存；若数据库里仍有旧表，在最后一步勾选「确认清空并覆盖」。不必手工删 site.env 或日志。

推荐 安装后数据库迁移怎么执行？

安装向导会自动跑初始迁移；后续版本升级可执行 app/database/migrations/ 下脚本或商业版后台一键升级。

推荐 dev / 官网 / 演示站有什么区别？

开发仓用于编码；b.pivark.com 为产品官网（site_theme=www）；demo1 模拟客户装完后的 Community 体验。三者数据库独立，勿共库。

推荐 配置文件放在哪里？

运行态 SSOT 为 data/site.env（数据库、版本标识等），不在 Web 根目录暴露 .env。

推荐 Nginx 伪静态怎么配？

将请求重写到 index.php，并保留 QSA 以便分页参数传递。示例见文档「快速开始」与「URL 重写」。

Apache 需要开哪些模块？

需启用 mod_rewrite，站点根目录放置项目自带 .htaccess。

后台地址是什么？

默认为 /admin（Vue SPA）。须先 pnpm build:app 生成 public/static/admin/dist/ 再访问。

安装后首页空白或 500 怎么办？

查看 data/runtime/log/ 错误日志；常见原因：目录不可写、PHP 扩展缺失、数据库连接失败。

能否在 Windows + IIS 上部署？

可以，需配置 URL 重写与 PHP 处理程序；生产环境更推荐 Linux + Nginx。

Docker 部署支持吗？

社区可自行编写 Dockerfile；官方交付以 zip 安装包 + 安装向导为主，旗舰版可提供驻场部署方案。

多站点能否共用一套代码？

代码可同机多份部署；每个站点须独立数据库与 site.env，授权按域名发放，禁止多站共库。

如何从 Gitee 源码包安装？

下载 Releases 或克隆仓库，composer install 后配置 Web 根目录并跑安装向导。见 下载中心。