从零跑起来
五分钟装上 aucms,认识后台每个菜单是干什么的,知道遇到问题该翻哪一章。
约 3 分钟
入门
代码块右上角可一键复制
本页目录(3 分钟读完)
这一章只做三件事。
装起来、进后台、发第一篇。
装不上、报 500、白屏 → 看 排错手册。
怎么在本机跑起来#
只用来试玩,别对外用。
- 把项目放到任意目录
- 在项目根目录执行命令
- 浏览器打开
http://127.0.0.1:8080/
php -S 127.0.0.1:8080 server.php打开后会进安装向导。
打不开? → 看 排错手册
怎么装起来#
打开域名,按向导走五步。
- 环境检测:有红项就先停
- 目录权限:
runtime/、data/要可写 - 数据库:选 MySQL 或 SQLite
- 管理员账号:填账号和强密码
- 完成:点「完成」
装完做三步收尾,别跳过。
# 1) 移走安装目录
mv install /root/aucms-install-backup
# 2) 确认密钥在
ls -l data/secret.key
# 3) 环境自检
php aucms env:check装不上? → 看 排错手册
怎么进后台#
- 浏览器打开
/admin - 填刚才的账号
- 填密码和验证码
- 点「登录」
登录后左边是菜单。
进不去? → 看 排错手册
怎么认菜单#
按建站顺序看这张表。
| 菜单 | 干什么 |
|---|---|
| 控制台 | 看今日数据 |
| 文章管理 | 发文章、改文章 |
| 内容模型 | 定义文章有哪些字段 |
| 栏目管理 | 建导航目录 |
| 系统设置 | 改站点配置 |
| 缓存与维护 | 清缓存、重建 |
怎么发第一篇文章#
分四步走,先建模,再建栏,后发文。
第 1 步:确认有文章模型#
- 点「内容」→「内容模型」
- 看有没有「文章」
- 没有就点「新增」
- 标识填
article - 类型选「栏目型」
- 点「保存」
第 2 步:建一个栏目#
- 点「内容」→「栏目管理」
- 点「新增」
- 栏目名称填「新闻中心」
- URL 别名填
news - 所属模型选「文章」
- 点「保存」
第 3 步:发内容#
- 点「内容」→「文章管理」
- 点「发布」
- 填标题、正文
- 栏目选「新闻中心」
- 状态选「发布」
- 点「保存」
第 4 步:看效果#
- 打开
/list/news - 点刚发的文章标题
看不到? → 看 排错手册
怎么用命令行自检#
三条常用命令,复制就能跑。
php aucms env:check
php aucms cache:rebuild
php aucms route:list| 命令 | 什么时候用 |
|---|---|
| env:check | 装完、出问题时 |
| cache:rebuild | 改完模板后 |
| route:list | 404 时 |
接下来看哪一章#
按目标挑一章,不用全看。
没找到答案?
在后台「缓存与维护 → 系统体检」里看环境是否正常;仍无解就打开
server_debug.php 复现一次,页面会直接告诉你异常文件与行号。