YikaiCMS Beginner Guide

从零开始使用 YikaiCMS

给第一次做网站的人:从用易开面板准备 Windows 环境,到后台完成第一个页面、栏目和文章。本文按当前 v1.19.9 后台界面整理,推荐使用易开面板自带的 PHP 8.2。

Step 1

准备环境:Windows 用户安装易开面板

如果你是第一次搭建 PHP 网站,推荐使用易开面板。它是为 Windows 设计的本地 PHP 开发环境,自带 Web 服务器、PHP、MySQL 和数据库管理页面,不需要逐个安装和配置,适合本地练习与上线前测试。

易开面板自带的环境

  • 操作系统:Windows 10/11(64 位)
  • PHP:8.2(默认),另带 8.0 / 8.5
  • Web 服务器:Nginx(默认)或 Apache 2.4.39,可在面板中切换
  • 数据库:MySQL 8.0(默认)/ 5.7,或 SQLite

YikaiCMS 需要的 PHP 扩展

  • PDO、GD、mbstring:面板自带的 PHP 已启用
  • ZipArchive、OpenSSL、cURL:同样已启用
  • 网站目录可写,尤其是 `uploads/` 与 `storage/`
  • 浏览器使用 Edge 或 Chrome
易开面板 · 本地项目Windows 本地开发
Y
yikaicmsyikaicms.yikai · PHP 8.2
D
demodemo.yikai · PHP 8.2
+ 新建 / 接入项目

yikaicmsYikaiCMS

http://yikaicms.yikai:8081/

打开网站打开后台管理数据库启动此项目打开目录伪静态配置
Nginx · 运行PHP 8.2 · 运行MySQL 8.0 · 运行数据库页面 · 运行
图 1:易开面板主界面。左侧是项目列表,右侧是当前项目的操作,底部状态栏显示 Nginx、PHP、MySQL 是否在运行。示意图只保留教程需要的操作关系。

Step 2

用易开面板创建网站

1

下载并安装易开面板

从易开面板官网 panel.yikai.cn 下载 Windows 版。安装目录建议保持默认的 `D:\yikai`,避免路径中出现空格或特殊字符;网站文件默认放在 `D:\yikai\wwwroot`。

2

启动环境

打开易开面板后,会自动启动 Nginx、PHP 8.2 和 MySQL 8.0。底部状态栏显示“运行”就说明环境已就绪;点击状态栏上的某个服务,可以单独启动、停止或重启它。

3

新建 YikaiCMS 项目

点击左下角“新建 / 接入项目”:项目类型选择“YikaiCMS”,本地域名填写 `yikaicms`(面板会自动补成 `yikaicms.yikai`),PHP 选择 8.2,数据库选择 MySQL 8.0。项目目录会自动生成,点击右侧 … 可以更改存放位置。

4

数据库自动创建

点击“创建项目”后,面板会为这个项目单独创建数据库并启动项目,不需要手动建库。数据库名、账号和端口可以在“管理数据库”页面查看;不要把它们发布到公开网页。

5

同步本地域名

点击顶部“同步域名”,面板会把 `yikaicms.yikai` 写入 Windows hosts,系统会请求管理员权限。还没同步时,“打开网站”会使用 `127.0.0.1:端口` 地址,同样可以访问。

面板自带的 YikaiCMS 安装包可能不是官网最新版。想用最新版时,把从官网下载的 ZIP 解压到一个文件夹,新建项目时类型选择“接入已有目录”并选中该文件夹。伪静态规则无需手动配置:Nginx 已内置 YikaiCMS 规则,切换到 Apache 时使用程序自带的 `.htaccess`。

Step 3

安装 YikaiCMS,并完成首次登录

程序文件

用易开面板新建的 YikaiCMS 项目已经放好程序文件,不需要再手动解压。当前教程按后台 `v1.19.9` 编写。

安装向导

在面板中选中项目,点击“打开网站”。首次打开会自动进入安装向导 `/install/`,安装完成后进入 `/admin/`。

1

先访问安装向导

面板自带的 PHP 已启用 YikaiCMS 需要的扩展,环境检查一般可以直接通过。如果提示目录不可写,检查项目是否放在了只读或受保护的位置。

2

确认数据库信息

易开面板会自动填好数据库主机、端口、数据库名、用户名和密码,保持默认即可。在面板里修改过 MySQL root 密码时,这里会自动填入新密码。

3

创建管理员账号

安装表单里预填了示例管理员账号,请改成你自己的管理员用户名和高强度密码。

4

登录后台

点击面板上的“打开后台”,或访问 `http://yikaicms.yikai:端口/admin/`(端口以面板显示为准)。登录后看到“控制台”,就说明 CMS 已经可以使用。

Step 4

先认识控制台:左侧菜单就是工作路线

控制台把常用任务集中在首页卡片中。左侧菜单按工作类型分组,初学者可以先按“基本设置 → 栏目 → 页面/文章 → 网站设计 → 备份”的顺序完成一次闭环。

控制台快速查找页面访问前台admin
后台管理
控制台
文章与资讯
商品与展示
媒体与组件
互动数据
站点设置
外观与扩展
系统设置
网站设计

控制台

网站设计
联系设置
基本设置
数据库备份
栏目管理
单页管理
产品管理
下载管理
图 2:控制台的主要入口。实际页面还会显示最近使用、内容数量和最新表单等信息。
后台分组你会在这里做什么
文章与资讯文章、下载、招聘等内容。
商品与展示产品、案例和产品分类。
媒体与组件媒体库、图库相册、轮播图。
站点设置栏目、单页、基本设置、联系设置、SEO、多语言。
外观与扩展主题、插件、场景预设、扩展字段和 AI 设置。
系统设置管理员、安全、数据库、回收站、定时任务、静态生成、授权和升级。
网站设计首页、易开网页构建器页面、全站头尾、设计系统和模板。

Step 5

基本设置:先把网站身份填完整

进入“站点设置 → 基本设置”。建议第一次登录后先完成这一页,再去创建内容。修改后要点击“保存设置”,并打开前台检查。

站点设置基本设置中文(源)

基本设置

保存设置恢复默认值
图 3:基本设置的字段分组。真实页面还包含站点标识、后台品牌、Logo 上传和语言设置。
字段建议怎么填
站点 URL填写最终访问地址;本地练习可以先填本地域名,上线前改为正式 HTTPS 地址。
站点名称填写公司或项目名称,会影响页面标题和后台识别。
SEO 关键词 / 描述用用户会搜索的词写,不要堆砌无关关键词。描述写成一句完整的话。
站点 Logo / 图标优先使用透明底 PNG 或 SVG;图标使用正方形 PNG 或 ICO。
页头 / 页脚页头放导航和 Logo,页脚放联系方式、版权、隐私政策和服务条款。
保存后点击顶部“访问前台”,确认 Logo、站点名称、导航和页脚已经更新。若看不到变化,先点击后台顶部“缓存”清理缓存。

Step 7

页面、文章与产品:完成第一次发布

A. 用易开网页构建器编辑单页和首页

单页管理用于公司简介、服务流程、联系我们等独立页面;网站设计中的“编辑首页”用于首页。进入页面后选择“使用易开网页构建器编辑”,在画布中添加区块、拖动排序、编辑内容,最后依次保存草稿、预览、发布。

易开网页构建器画布结构设置保存草稿已发布
在这里编辑页面内容选择区块后,在右侧设置文字、图片、颜色、间距和链接
+ 添加区块
图 5:易开网页构建器的基本操作关系:元素库、画布、结构和设置四个区域配合使用。

第一次做页面的顺序

  1. 先选一个简单的区块模板。
  2. 替换标题、正文和图片。
  3. 检查按钮链接是否指向正确页面。
  4. 切换桌面和移动预览。
  5. 保存草稿,确认无误后再发布。

不要忘记的内容

  • 页面标题和摘要
  • 封面图与正文配图
  • 联系方式和表单
  • 英文、日文版本(如果开启多语言)
  • 手机端的换行、按钮、图片比例

B. 发布一篇文章

进入“文章与资讯 → 文章管理 → 添加”。真实后台字段包括:文章标题、URL 别名、文章内容、文章摘要、所属分类、发布状态、发布时间、置顶、推荐、热门、封面图片、作者、来源和标签。

摘要是列表页的一两句话概述,不是正文。留空时系统会从正文自动截取;写完标题和正文后,先保存为草稿检查,再切换为“已发布”。

C. 发布一个产品

进入“商品与展示 → 产品管理”。先在“分类管理”建立产品分类,再添加产品。列表页通常依赖产品名称、分类、封面、摘要和推荐状态;详情页再补齐规格、图片、参数和联系入口。

Step 8

媒体库与联系信息

媒体库

进入“媒体与组件 → 媒体库”。可以按图片、视频、文件筛选,按上传时间或文件大小排序,搜索文件,上传新文件,必要时扫描入库。上传前先压缩图片并使用清楚的英文或拼音文件名。

联系设置

进入“站点设置 → 联系方式”。设置电话、邮箱、地址、二维码、地图和联系卡片;联系表单可被放入文章、单页或易开网页构建器区块中。

图片上传失败时,先检查 `uploads/` 是否可写、PHP 上传大小限制是否足够、文件格式是否受支持。不要为了上传方便给整个网站目录开放完全写入权限。

Step 9

主题与网站设计:先稳定内容,再调整外观

“外观与扩展 → 主题”用于切换 Default、Business、Minimal 等主题;“网站设计”用于管理首页、易开网页构建器单页、网页头、网页尾、弹窗、设计系统和模板库。

1

先选主题

新站先使用 Default 完成内容。需要更强的商务风或极简风时,再切换 Business 或 Minimal。

2

再改全站头尾

在“网站设计”里打开网页头或网页尾,统一调整 Logo、导航、联系方式、版权和政策链接。

3

最后调首页

首页内容由易开网页构建器区块组成。完成桌面和移动端检查后,保存草稿并发布。

切换主题或批量修改首页前,先做数据库备份,并保留自定义主题和插件的副本。主题切换会影响页面外观,不应该成为第一次录入内容时的阻塞点。

Step 10

备份、升级与常见问题

先备份,再升级

  1. 进入“系统设置 → 数据库”,使用默认的 MySQL 5.7 兼容格式做一键备份。
  2. 另外保存 `config.php`、`uploads/`、`storage/` 和自定义主题、插件。
  3. 升级前确认项目使用 PHP 8.2 或更高版本,ZipArchive、OpenSSL、网络下载和目录写入检查均通过。
  4. 升级完成后运行数据库升级,再打开首页、栏目页、文章详情和后台。
在线升级主要覆盖程序文件;配置、上传文件和运行数据应按升级提示保留。直接修改过核心文件的用户要单独留存差异,因为升级可能覆盖这些修改。

小白排错顺序

现象先检查什么
页面 404站点 URL、栏目状态、伪静态规则(易开面板中选中项目点“伪静态配置”;使用 Apache 时检查项目 `.htaccess`);先用后台“访问前台”确认基础地址。
页面 500 或空白项目的 PHP 版本是否为 8.2 或更高(易开面板“项目设置”中查看),再查看 `D:\yikai\logs` 中的运行日志和 CMS 错误日志。
改完前台没变化是否保存并发布、是否打开了正确语言版本、是否需要清理缓存。
图片或文件上传失败检查 `uploads/` 权限、PHP 上传限制(易开面板“工具 → 配置文件”中修改 php.ini 的 upload_max_filesize)、文件格式和磁盘空间。
移动端布局错乱在易开网页构建器中切换移动预览,检查长标题、按钮、图片宽度和区块间距。

Before Launch

上线前检查表

逐项打勾后再把本地站点交给客户或绑定正式域名。

  • 站点 URL 已改为正式 HTTPS 地址
  • 管理员初始密码已修改
  • 站点名称、Logo、图标和版权已确认
  • 主导航和底部导航没有空链接
  • 首页、单页、列表页和详情页均能打开
  • 文章摘要、封面图和发布时间正确
  • 产品分类、产品图片和联系入口正确
  • 中英文或日文页面没有未翻译占位
  • 手机端没有横向滚动和文字溢出
  • 联系表单提交后后台能收到记录
  • 数据库、配置、上传目录已经备份
  • 升级和回滚方式已记录

最短练习任务

如果你只想先练一次:创建一个“公司新闻”栏目,发布一篇带封面图的文章,再用易开网页构建器修改“关于我们”页面,最后从前台访问并用手机宽度检查。这条路线能覆盖后台最常用的基本能力。