装在哪、需要什么
服务器需要什么、三分钟装好一套站点、安装后该做的第一件事。
运行环境
这是一套 PHP 程序,必须跑在已经装好 PHP 的服务器上。能装它的地方:
- 云服务器 / VPS(自己装 PHP 与 Nginx 或 Apache)
- PHP 虚拟主机 / PHP 空间(主机商提供 PHP 的那种)
- 面板建站环境(宝塔、cPanel、Plesk 之类,建一个 PHP 站点即可)
下面这些地方装不了,选主机时先看清楚:
- 纯静态托管:GitHub Pages、Netlify / Vercel 的静态站、对象存储(OSS / COS)的静态网站功能 —— 它们只发静态文件,不执行 PHP
- 只有 HTML 的免费空间:同理,没有 PHP 就没有这套程序
还有一条同样硬的要求:要能把域名的「网站根目录」指到 wwwroot/ 这个子目录。
主流主机都能设(面板里叫「网站根目录」「运行目录」「Document Root」)。为什么要这样,见「目录结构」那一篇。
服务器要求
- PHP 7.4 及以上(程序按 7.4 语法编写,同时兼容 8.x)
- 扩展:
pdo_sqlite、mbstring、json、gd(图片处理)、fileinfo - 数据库:默认 SQLite,无需单独安装;也支持 MySQL / MariaDB
- 磁盘:程序本体约 6 MB,其余取决于你上传的图片与附件
没有 pdo_sqlite 时程序会直接报错退出,不会静默降级 —— 与其跑出一个行为诡异的站点,不如一开始就说清楚。
安装
- 把程序包解压到站点的目录里(整个包放一起,别把里面的文件拆散)。
- 把域名的 网站根目录指向其中的
wwwroot/—— 对外访问的是这个子目录,网址里不会出现wwwroot。 - 用浏览器访问域名,自动进入安装向导。要填三项:
- 站点类型:正式站或演示站,决定初始内容与配色
- 管理员账号:用户名 3–20 位字母数字下划线,密码至少 6 位
- 数据库:默认用 SQLite,直接下一步即可
也可以走命令行安装 —— 适合脚本化部署、批量建站,或者本机装了 PHP 想先试一遍。
前提是执行命令的那台机器上有 PHP,并且命令指向站点里的 install.php:
php install.php --cli --profile=cms --user=admin --pass=你的密码
安装程序做了什么
- 建表、写入初始内容、生成管理员账号
- 生成
config/config.php,其中包含一份随机密钥 - 把数据库文件放在 站点根目录之外,并随机命名
第三点是刻意的:数据库不在网站目录里,HTTP 无论如何也访问不到;文件名随机,即使有人按常见路径去猜也猜不中。
装完立刻做三件事
- 删除或改名 install.php。程序会拒绝重复安装,但留着没有意义。
- 到 站点设置 填好站点名称、域名、备案号、联系方式。
- 到 用户管理 确认管理员密码足够强,并考虑开启登录二次验证。
权限提醒:如果后续用命令行执行安装或升级,请以站点用户身份执行,不要用 root。
否则数据库与缓存目录会变成 root 所有,网页进程写不进去,
表现出来就是「能打开页面,但一保存就报错」。
