正文

帝国CMS执行SQL实战，手把手从零搭建自定义内容模块

机房老炮
机房老炮 V管理员 /892阅读/3评论
0807
文章最后更新时间2026年08月07日，若文章内容或图片失效，请留言反馈！

刚接触帝国CMS、想在不改核心文件的前提下扩展网站功能的新手站长；对SQL只有基本概念、但想安全使用后台“执行SQL”功能的朋友；以及正在折腾自定义模型、数据调用但总是报错的同学，本文不涉及复杂安全设置,只讲最稳的实操路径。

帝国CMS执行SQL实战，手把手从零搭建自定义内容模块

帝国CMS执行SQL实战，手把手从零搭建自定义内容模块

在帝国CMS后台，“执行SQL”是一个既能提升效率、又容易误伤数据库的工具，很多新手一看到“SQL”就发怵，其实掌握几个固定套路，你完全可以用它来搭建一个属于自己的功能模块，比如一个招聘信息列表、一个客户案例展示、甚至一个简单的预约系统，下面我们就以“招聘信息管理”为例，完整走一遍“建表—填数据—前端调用”的全过程。

第一步：安装帝国CMS并进入后台

如果你还没装好帝国CMS，先下载最新版（本文以7.5版本为例），将upload目录里的所有文件上传到服务器根目录，访问域名，按向导填写数据库信息完成安装，安装完成后，用管理员账号登录后台，默认地址是/e/admin/。

进入后台后，左侧菜单依次找到“系统设置” -> “备份与恢复” -> “执行SQL”，这就是我们今天的主角，注意，不是“系统设置”里的“SQL执行”吗？不同版本位置略有差异，但功能都一样，如果找不到，直接看后台导航里有没有“扩展菜单”,有时候会被收起来。

第二步：用执行SQL创建自定义数据表

我们假设要做一个“招聘信息”模块，需要一张独立的数据表，存储职位名称、部门、人数、发布时间，打开执行SQL的文本框，输入以下语句（注意前缀，默认是phome_，如果你安装时改了前缀，请把下面语句中的phome_替换成你的前缀）：

CREATE TABLE `phome_jobs` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT '招聘ID',
  `jobname` varchar(100) NOT NULL COMMENT '职位名称',
  `department` varchar(100) NOT NULL COMMENT '招聘部门',
  `num` tinyint(4) NOT NULL DEFAULT '0' COMMENT '招聘人数',
  `addtime` int(10) NOT NULL DEFAULT '0' COMMENT '发布时间',
  PRIMARY KEY (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COMMENT='招聘信息表';

点击“执行”按钮，如果执行成功，页面会提示“成功”或没有任何报错，此时你可以在数据库管理工具（如phpMyAdmin）里看到这张表已经建好了。

配置要点：建表时务必使用ENGINE=MyISAM或InnoDB，但统一就好，别混用，字符集一定要和帝国CMS的字符集一致，绝大多数情况是utf8，如果你安装时选了gbk，这里就要写gbk，否则中文会乱码，字段类型tinyint足够存人数，别用int浪费空间。

第三步：往表里插入一条测试数据

还是在这个执行SQL页面,输入：

INSERT INTO `phome_jobs` (`jobname`, `department`, `num`, `addtime`) VALUES ('前端开发工程师', '技术部', 2, 1715000000);

这里addtime存的是时间戳，不要直接写日期，后面调用时再格式化，执行成功后，这张表就有了一条数据,你可以用这条数据验证后面的调用是否成功。

第四步：在前端页面调用这张表的数据

现在数据表有了，但帝国CMS默认不会自动读取它，我们需要在模板中写PHP代码，或者使用帝国的自定义函数，为了简单，我们直接在模板的合适位置（比如首页中间）放进这个PHP片段：

<?php
require_once("../class/connect.php");
require_once("../class/db_sql.php");
include("../class/db.php");
$sql=$empire->query("SELECT * FROM phome_jobs ORDER BY id DESC LIMIT 5");
while($r=$empire->fetch($sql)){
    echo "<div>".$r['jobname']." - ".$r['department']." - 招".$r['num']."人</div>";
}
?>

但注意，直接写死路径在模板里并不是最佳实践，更好的方式是写成一个函数，或者用帝国CMS的标签机制，新手学习阶段，把这个片段放到“首页模板”的对应位置，刷新首页,看到数据出来就算成功。

配置要点：调用时一定记得包含帝国CMS的核心文件，路径要写对，如果你把这段代码放在自定义页面模板里，require的路径要根据实际位置调整，千万不要在公共模板里直接使用echo输出，容易导致布局错乱，最好用<?php ... ?>包裹并控制HTML结构。

常见踩坑提醒

  1. 执行SQL时误操作导致数据丢失：在执行任何UPDATE或DELETE语句前，一定要先备份数据库，帝国CMS后台自带“备份数据库”功能，建议每次操作前点击“备份”按钮，尤其是DROP TABLE这种语句，一旦执行表格就没了,没有任何确认弹窗。

  2. 前缀错误：很多人从网上复制SQL语句，但那些语句通常以phome_开头，如果你安装时改了前缀，比如用了mycms_，那么执行会报错“表不存在”，检查方法：在后台“系统设置”->“数据库设置”里可以看到数据库前缀。

  3. 字符集不统一导致乱码：如果你在SQL里写CHARSET=utf8，但帝国CMS的数据表是utf8mb4，而页面声明是gbk，那么中文显示出来就会是“???”，解决办法：建表前先查看帝国CMS原表的字符集，用SHOW CREATE TABLE phome_ecms_news;查看,然后照抄。

  4. 执行SQL后页面没有变化：可能是缓存问题，帝国CMS后台有“系统缓存”和“模板缓存”，执行完SQL后，如果改了模板，需要到“系统设置”->“系统缓存”->“更新缓存”里清空缓存,否则前端看到的还是旧数据。

  5. 用root数据库账号执行危险语句：有些虚拟主机只给了普通账号，不要硬用DROP DATABASE等操作，帝国CMS执行SQL功能使用的是系统配置里的数据库账号，如果该账号权限过大，一旦手滑，整站数据全没,建议在本地测试环境练习熟练后再到生产环境操作。

  6. 不知道SQL语句是否执行成功：执行后页面会显示当前版本信息，这并不代表成功，真正判断方法是看顶部或者页脚有没有错误提示，或者到数据库表列表里刷新看看表是否存在，更稳妥的方法，在执行语句前先用SELECT * FROM 表名 LIMIT 1;测试一下表是否存在。

  7. 时间戳显示成数字：我们在前面插入数据的addtime是时间戳，模板里直接输出会显示一串数字，调用时要格式化，例如echo date('Y-m-d', $r['addtime']);，新手常忽略这一步,以为数据写错了。

进阶：用执行SQL批量更新数据

当你搭建完模块，想快速批量修改数据，比如将所有技术部职位人数加1,可以写：

UPDATE phome_jobs SET num = num + 1 WHERE department = '技术部';

这个操作在生产环境进行前，一定要先SELECT确认影响范围：

SELECT id, jobname, num FROM phome_jobs WHERE department = '技术部';

看到返回结果后，再执行UPDATE,这就是安全习惯。

帝国CMS的执行SQL功能是一个非常强大的工具，它让我们能绕过系统自带模型，直接操作底层数据，通过“建表—插数据—前端调用”这三步，你已经可以搭建一个自定义内容模块了，记住四个关键点：备份、前缀、字符集、缓存，只要遵循本文的步骤和提醒，你就能安全地利用SQL来扩展帝国CMS的功能，再也不怕“执行SQL”了。

打开你的帝国CMS后台，试着执行一条SELECT 1;，感受一下这个功能——然后动手创建你的第一张自定义表吧。