做帝国CMS模板开发的人，几乎没人能绕开e:loop这个标签。它在模板里的地位，相当于内容循环的“发动机”：首页推荐、栏目列表、相关文章、滚动图文、热门排行……这些看起来简单的区块，背后基本都是它在干活。而真正把e:loop用熟的标志，不是会写基础调用，而是能不能熟练用好第五个和第六个参数——附加SQL条件和排序参数。这两个参数用好了，一个标签能顶好几个循环，甚至能省掉单独写查询函数的功夫。

这篇文章不打算复述官方手册，而是从我实际做模板、改模板、排查模板报错的经验出发，把这两个参数从语法、用法、坑点到性能习惯完整捋一遍。适合刚接触帝国CMS模板的人，也适合做了几年还在靠复制粘贴调e:loop的朋友。看完之后你会明白：所谓“高级调用”，其实就是在正确的位置把条件写对、把排序写准。

1.e:loop标签的结构与参数逐项拆解

1.1 标准语法与七个参数的含义

e:loop的标准写法长这样：

[e:loop={栏目ID/专题ID,显示条数,操作类型,是否只显示有标题图片,附加SQL条件,排序参数,缓存时间}] 循环体内容 [/e:loop]

七个参数逐一说清楚，我直接整理成了表格，方便对照：

重点说一下参数6。很多人第一次写的时候会纠结：排序参数到底要不要写ORDER BY？答案是——不用写。系统在拼接 SQL 时会把ORDER BY自动补上。同理，参数5也只需要写条件本体，比如isgood=1，没必要写WHERE isgood=1。当然，就算你手滑把WHERE或ORDER BY写上去了，系统拼接时通常也能识别处理，大部分版本能跑，但既然默认会自动补齐，就别给自己留隐患，统一不带关键字写最稳。

循环体里面能用的变量主要是两个：$bqr是当前记录所有字段组成的数组，$bno是循环次数（从1开始）。取标题用<?=$bqr['title']?>，取发布时间需要格式化时间戳，写成<?=date('Y-m-d',$bqr['newstime'])?>，取链接用<?=$bqr['titleurl']?>，取缩略图用<?=$bqr['titlepic']?>。除此之外，id、classid、smalltext、onclick、isgood、isfirst、ishot这些字段都是可以直接在循环体里取的。

1.2 第五、第六参数在整条查询SQL中的位置

想要把附加SQL条件和排序参数用明白，最好先在脑子里建立起一条完整SQL的图景。以新闻表为例，表前缀用phome_，第一参数指定栏目5、显示8条、附加条件isgood=1、排序onclick DESC时，系统最终执行的查询大致是：

SELECT * FROM phome_ecms_news WHERE (classid=5) AND isgood=1 ORDER BY onclick DESC LIMIT 0,8

classid=5是第一参数指定栏目后系统自动加的，isgood=1来自第五参数，onclick DESC来自第六参数。如果把第一参数改成0，系统就不做栏目限制，整条SQL可能是：

SELECT * FROM phome_ecms_news WHERE isgood=1 ORDER BY newstime DESC LIMIT 0,10

理解了这个拼接关系，很多“奇怪”的现象就解释得通了。比如第一参数已经指定了栏目5，附加条件里又写classid=8，那查出来的数据必然是空的——因为两个条件用 AND 拼接后，要求一条记录既属于栏目5又属于栏目8，根本不存在。

提示：第五参数内部不要出现英文逗号。e:loop的参数靠逗号切分解析，条件里如果写了title LIKE '%a,b%'这种带英文逗号的内容，参数会被切错位，轻则条件失效，重则直接报错。

2. 附加SQL条件：从基础筛选到跨场景调用

2.1 基础条件写法与常见误区

实际项目里，第五参数最常见的用法是筛选后台勾选项。几个高频字段我列一下：

• isgood=1：推荐
• isfirst=1：置顶
• ishot=1：头条
• classid<>8：排除某个栏目
• username='admin'：取指定作者的文章
• titlepic<>''：强行要求有标题图片

这些条件可以自由组合，比如isgood=1 AND isfirst=1表示“推荐且置顶”。组合条件用AND连接，偶尔也会用到OR，但OR记得加括号，比如(isgood=1 OR ishot=1) AND classid=3，否则SQL的优先级很容易和你的预期不一致。

这里有个容易踩的误区：第一参数指定栏目之后，很多新手会以为附加条件里的栏目相关字段还能随便用。实际上系统已经在 WHERE 里加了一层栏目限制，附加条件是叠加在它上面的。所以如果你只是想“跨栏目取数据”，正确做法是把第一参数设为0，再用附加条件里的classid in (...)来控制栏目范围，而不是在第一参数已经生效的情况下去改classid。

还顺带提一下审核状态的问题。e:loop在前台直接查询数据表，有朋友遇到过未审核的数据出现在列表里的情况。不同版本对这个字段的自动过滤处理不完全一样，保险起见，如果发现异常，可以在第五参数里显式加上checked=1，一次性堵住这个漏洞。

2.2 时间范围、多栏目与LIKE搜索的进阶写法

第一参数按设计只认一个栏目ID，但实际场景里经常要跨栏目取数据。把第一参数设成0，然后在第五参数里写classid in (3,5,8)，就能实现多栏目联合调用。这是我在做首页“综合信息流”时最常用的写法：

[e:loop={0,12,0,0,'classid in (3,5,8) AND isgood=1','newstime DESC',300}] <li><a href="<?=$bqr['titleurl']?>" target="_blank"><?=$bqr['title']?></a></li> [/e:loop]

时间范围条件也有实用场景。newstime存的是 Unix 时间戳，想取“最近7天发布的文章”，可以写成这样：

newstime >= time()-86400*7

因为e:loop的参数最终是在 PHP 上下文里解析执行的，所以直接调用time()是可以生效的。同理，想控制某段时间之前或之间的内容，也可以用newstime配合AND、OR组合出来。

再来看看模糊搜索。做搜索入口、标签聚合或者专题列表时，标题匹配用LIKE很常见，比如取标题包含“通知”的文章：

[e:loop={0,10,0,0,"title LIKE '%通知%'","newstime DESC",0}]

注意这里的引号层级：条件值本身要包在参数引号里，LIKE后面的匹配值也需要引号，所以我的习惯是外层用双引号包条件，内层用单引号。如果反过来外层用单引号，内层的单引号就会把参数提前截断，轻则报错，重则白屏。

重要提醒：如果关键词本身带英文逗号，这套写法也会翻车，参数切分无法识别逗号在引号内。遇到这种极端情况，我建议直接放弃e:loop，改成模板内嵌 PHP 查询，或者把条件拆到后台数据源里处理。

3. 排序参数实战：让列表顺序听话

3.1 常用排序规则与写法

第六参数决定的是一条列表的“出场顺序”，实际项目里基本逃不出下面这些规则：

注意一个容易混淆的点：多字段排序写法里是有英文逗号的，比如isgood DESC, newstime DESC。这跟第五参数“不能出现英文逗号”不是一回事。第五参数的逗号会破坏参数切分，而第六参数整体会被当成一段完整的排序内容拼到ORDER BY后面，所以里面的逗号是语法的一部分，放心用。

多字段排序的场景非常多。典型的是：置顶文章永远排在前面，其余文章按时间倒序。这个需求用isfirst DESC, newstime DESC一组排序就解决了，不需要先去查一遍置顶列表再查一遍普通列表。

3.2 指定ID顺序与随机排序的实现

排序参数最大的价值在于可以组合，同一套循环体换不同排序参数就能输出不同区块。我做过一个首页三栏推荐模块，数据源都来自同一个栏目，三个标签分别用不同排序：

// 栏1：最新 [e:loop={5,6,0,0,'','newstime DESC',60}] // 栏2：热门 [e:loop={5,6,0,0,'','onclick DESC',60}] // 栏3：推荐 [e:loop={5,6,0,0,'isgood=1','newstime DESC',60}]

循环体结构完全一样，只是第五、第六参数不同，代码非常干净。这种写法比复制三个几乎一样的大标签段要省心得多，也方便后期统一改样式。

还有一个进阶技巧可能有人需要：按指定的ID顺序输出。比如编辑手动排了一组 ID：5、9、3、7，希望列表严格按这个顺序展示，排序参数可以写成：

field(id,5,9,3,7)

MySQL 的FIELD()函数支持这种手工排序，配合附加条件id in (5,9,3,7)一起用，就能实现“编辑推荐位”的效果。这个技巧适合内容更新不频繁的固定推荐模块，缺点是ID写死在模板里，运营调整顺序就得改代码，所以我会建议在后台用一个排序字段来管理，而不是经常改模板。

随机排序rand()虽然写起来最简单，但数据库要逐条扫全表做随机，数据上万之后性能下滑很明显。我的建议是：几千条数据的小站可以用，中大型站别碰。非要随机展示，可以取一个较大的条数范围，前端JS再打乱，或者按ID取余数配合分页切换，效果接近但压力小很多。

4. 常见问题与排查记录

4.1 白屏与SQL错误的定位思路

e:loop写错最常见的表现就是整个页面白屏，或者页面上某个区块直接消失。我踩过几次坑之后，总结出一条排查路径：先数参数对不对，再看字段名有没有拼错，最后查引号包裹。

参数数量不对是最冤的。七个参数一个都不能少，少了某个参数，后面的值就会整体错位。比如把缓存时间漏了，系统会把第六参数错当成第七参数处理，排序参数被吞掉，列表顺序变得莫名其妙。所以我习惯把所有参数都写全，哪怕不用的位置也写空字符串''，避免错位。

字段名拼错时，数据库返回的报错通常是Unknown column 'xxx' in 'where clause'，定位已经非常明确了，去后台数据表里核对字段名即可。但这里有一个隐蔽的坑：帝国CMS的模型里，部分自定义字段存储在附加数据表，比如新闻模型的自定义字段可能在phome_ecms_news_data_1这类表里，而e:loop默认查询的是主表，直接用自定义字段做条件或排序，就可能报字段不存在。遇到这种情况，要么换成主表里的系统字段，要么改用自定义SQL，或者到后台数据源里单独配置。

4.2 引号切分、缓存不更新与静态化叠加问题

引号切分问题前面反复强调过，这里再给一个完整的判定规则：第五参数里有英文逗号，十有八九会被切错位；有中文引号、中文逗号一般没事，因为参数切分只认英文逗号和引号配对。

缓存不更新则是另一个非常隐蔽的坑。第七参数设了缓存时间（比如60），数据更新后列表还在展示旧内容，很多人第一反应是SQL写错了，其实只是缓存没到时间。排查方法很简单：把第七参数改成0，刷新看是否恢复正常。如果恢复正常，就是缓存问题。帝国CMS后台有数据缓存清理入口，可以手动清掉标签缓存，但生产环境更合理的做法是：更新频率高的区块缓存时间设短一点，或者干脆不缓存。

还有一个容易忽略的点：模板开启了静态化之后，页面可能是生成的静态HTML，修改了循环体样式或SQL条件，刷新页面看不到变化，是因为静态页还没重新生成。e:loop的标签缓存和站点的静态化机制是两层东西，排查的时候别混在一起，不然会白白折腾半天。

我把这几类高频问题整理成一张速查表：

5. 性能优化与几条实操心得

5.1 让附加条件和排序都走索引

第五参数写条件时，能用主表索引字段（classid、isgood、isfirst、newstime）就用这些字段，查询效率有保障。反过来，在title这类长文本字段上做LIKE '%关键词%'，MySQL没办法走索引，数据量一大就会拖慢页面。做后台“相关文章定位、搜索聚合”这类需求时，优先考虑用栏目、推荐、时间这些可索引字段去卡范围，尽量减少对内容字段的模糊匹配。

排序参数对性能的影响也常被低估。ORDER BY newstime DESC和ORDER BY onclick DESC在数据量大、字段没索引时会产生 filesort，导致查询明显变慢。如果某个区块加载速度不对劲，先检查排序字段是不是有索引，再到MySQL命令行里用EXPLAIN看一眼执行计划。这个习惯能帮你少走很多弯路。

缓存参数是性能的另一半。像首页这种访问量高的区块，第七参数给个60到300秒的缓存收益很明显；但凡是登录后可见、数据实时性要求高的内容，缓存务必设成0，宁可不缓存也别让用户看到过期数据。

5.2 我在实际项目里的几条固定用法

做了几年模板开发，我对e:loop攒了一套自己的“规矩”，分享出来供参考。

第一，凡是后台勾选就能控制的数据（推荐、置顶、头条），我优先用后台字段做附加条件，而不是在模板里写死ID或写死时间范围。这样运营调整内容不需要动模板，项目交接时也省心。第二，多栏目调用的需求统一用classid in (...)解决，尽量不让第一参数承担跨栏目职责——第一参数保持0，把栏目控制全部收拢到附加条件里，语义更清晰。第三，缓存参数永远最后调，先保证功能正确、SQL高效，再根据内容更新频率决定缓存秒数，顺序不能反。

还有一条经验：项目里能用一个e:loop解决的，就别写两个。我曾经接手过一个站点，首页四个区块各写了一个几乎重复的e:loop，区别只有排序参数。后来统一切换到共用循环体，模板维护量立刻降了下来。模板代码变短，出错概率自然就小。

最后分享一个细节技巧：循环体里要给每条记录加序号时，直接输出$bno就行，这是从1开始的。如果页面设计要求序号从0开始（比如配合CSS的nth-child或JS数组索引），可以在循环体里自己算：<?php $t = $bno - 1; ?>，然后再用$t输出。这种小处理能省掉不少样式微调的时间，也说明e:loop的循环体本质上就是一段PHP脚本，灵活度比你想象中要高。