安装与升级

Nomen 最后只需要一份配置文件：config/installed.php。里面有数据库密码和 pepper，不要提交、不要外传。

先确认 web root 是 public/

入口在 public/index.php，nginx / Apache 的 root 必须指到 public/。指到项目根的话，你会看到根目录那个 index.html，它在提醒你改这里。

伪静态

安装页第 1 步会自动检测。也可以直接访问 /__rewrite_probe：返回 ok 就说明伪静态没问题，返回 404 就是没配。

nginx：

location / {
    try_files $uri $uri/ /index.php$is_args$args;
}

Apache 的 public/.htaccess 已经带了规则，确认 mod_rewrite 开了、站点允许 AllowOverride All。

网页向导

1. 把代码放到站点目录（发布 zip 解压即可，vendor/ 和前端产物都在里面）。

2. 浏览器打开站点，没装过会自动跳到 /nomen-install/。

3. 四步：环境检查 → 数据库 → 站点与管理员 → 安装。

4. 装完把 public/nomen-install/ 删掉或改名——留着等于把安装页开放给所有人。

5. 打开站点，用刚建的管理员登录。

命令行

php bin/nomen install

会依次问数据库、站点信息、管理员账号，然后建库、导表、建管理员、写 config/installed.php。已经装过会拒绝，确实要重装加 --force。

数据库

安装器会尽量自己建库，但面板建的数据库账号通常没有建库权限，先建好更省事：

CREATE DATABASE `nomen` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'nomen'@'localhost' IDENTIFIED BY '换成随机密码';
GRANT ALL PRIVILEGES ON `nomen`.* TO 'nomen'@'localhost';
FLUSH PRIVILEGES;

表结构不用手动导，安装器会跑 database/schema.sql（21 张表）。

前端

发布 zip 里已经带好 public/assets/dist/，跳过这步。从源码部署才需要：

cd frontend
npm install
npm run build

邮件

验证码、恢复链接、通知都走 SMTP。装完在 config/installed.php 的 smtp 段里填，或者用 .env 覆盖。

通知邮件是排队发的（notifications.email_sent_at），要有个常驻进程消费：

php scripts/mail-drain.php

用 systemd 或 cron 拉起，同时只能有一个实例（脚本自己用 scripts/mail-drain.lock 加锁）。

升级

git pull
composer install --no-dev
php bin/nomen migrate

migrate 只跑 database/migrations/ 下没跑过的 SQL，记录在 schema_migrations 表。

排错