企业官网建设流程全解析

1. 从首页入口说起：home模块到底管什么

很多人第一次翻Discuz源码，看到home这个目录会下意识以为它只管个人空间，其实这个判断只对了一半。home模块在Discuz的架构里承担的是"用户中心+社交关系+动态聚合"这一整块业务，它既包含个人主页的展示逻辑，也包含好友、打招呼、记录、日志、相册、分享这些社交组件的入口调度。换句话说，论坛主体（forum）负责"内容生产与消费"，而home负责"人跟人之间的关系沉淀"。

我当初接手一个老站迁移任务时，就是因为没搞清楚这个边界，把个人空间里的日志评论当成论坛帖子去处理，结果数据表关联全错，白白多花了两天。所以第一篇解析，我打算先把home模块的入口结构、路由分发、核心文件职责讲透，后面再逐层拆它的数据表和模板机制。

这篇文章适合三类人看：一是刚接触Discuz二次开发、需要改个人主页的新手；二是要基于Discuz做社交功能扩展的开发者；三是维护老站、需要排查空间页面异常的同学。我会尽量把每个文件的作用、每个参数为什么这么设计讲清楚，而不是只丢一份文件清单给你。

先给一个整体认知：Discuz的模块划分是按"入口文件+类库+模板"三层走的。home.php是入口，source/module/home/下面是各功能的具体实现，template/default/home/下面是模板。你改任何东西之前，先确认自己动的是哪一层，这是避免踩坑的第一步。

2. home.php入口文件的分发逻辑拆解

2.1 入口文件的第一屏代码在做什么

打开home.php，前面一大段是常量定义和公共文件引入，真正核心的是中间那段根据$_GET['mod']和$_GET['do']做分发的逻辑。Discuz的入口文件几乎都是这个套路：先定义CURSCRIPT，再引入common.inc.php，然后根据URL参数决定加载哪个模块文件。

// 简化后的分发逻辑示意 $mod = empty($_GET['mod']) ? 'space' : $_GET['mod']; $do = empty($_GET['do']) ? 'index' : $_GET['do']; // 白名单校验，防止任意文件包含 if(!in_array($mod, array('space', 'spacecp', 'follow', 'invite', 'magic', 'medal', 'task'))) { $mod = 'space'; }

这里有个关键设计：mod参数走白名单校验。为什么？因为如果直接拿$mod去拼接文件路径，攻击者可以构造mod=../../something来包含任意文件。Discuz在这块做了硬编码白名单，这是老版本迭代中补上的安全措施。你在做二次开发新增模块时，一定要记得把自己的模块名加进这个白名单数组，否则访问会直接回落到space。

2.2 mod与do的二维路由关系

mod决定加载哪个大类文件，do决定这个文件里执行哪个方法。比如home.php?mod=space&do=profile，最终会走到source/module/home/space_profile.php这个文件。注意这里的命名规则是{mod}_{do}.php，不是所有组合都存在，不存在的组合会走默认分支。

我整理了一张常用路由对照表，方便你快速定位：

这张表建议你收藏，排查问题时先看URL落在哪个文件，比盲目全局搜索快得多。

2.3 为什么入口层要做权限预判

在分发之前，home.php还会做一次登录态和权限的预判。比如访问spacecp（个人设置中心）时，未登录用户会被直接跳转到登录页。这个判断放在入口层而不是各子文件里，是为了避免每个子文件都重复写一遍登录校验。

注意：如果你新增的模块需要登录才能访问，不要只依赖入口层的判断，子文件里最好再校验一次。因为入口层的判断是基于mod粒度的，某些do可能允许游客访问，粒度不够细。

3. source/module/home目录下的文件职责地图

3.1 space系列文件：个人主页的核心

space_开头的文件是个人空间的主体。space_index.php负责渲染主页框架，它会去查用户的个人资料、统计信息（好友数、日志数、相册数）、最新动态，然后组装给模板。space_profile.php是资料详情页，space_notice.php是通知中心。

这里有个容易混淆的点：space_index.php和space_profile.php都会展示用户信息，但前者是"聚合展示"，后者是"完整资料"。你在改模板时如果发现某个字段在主页不显示，先确认是不是space_index.php根本没查这个字段，而不是模板写错了。

3.2 spacecp系列文件：设置中心的拆分逻辑

spacecp是"space control panel"的缩写，也就是个人设置中心。它被拆成了很多个文件：spacecp_avatar.php管头像，spacecp_profile.php管资料，spacecp_privacy.php管隐私，spacecp_credit.php管积分。

为什么拆这么细？因为设置中心的每个功能模块的权限校验、表单处理、数据验证逻辑都不一样，塞在一个文件里会变成几千行的巨型文件，维护成本极高。这种"一个功能一个文件"的拆分方式，是Discuz模块化设计的一个典型特征，你在做扩展时也应该遵循这个原则。

3.3 follow、invite、task等社交组件

follow是关注/粉丝体系，invite是邀请码体系，task是任务系统，magic是道具系统，medal是勋章系统。这些文件相对独立，各自维护自己的数据表和业务逻辑。

我个人的经验是，这几个组件里follow的耦合度最低，适合拿来练手做二次开发。比如你想加一个"关注的人发帖时给我发通知"的功能，改follow相关文件比改space要安全得多，因为space牵扯的模板和钩子太多了。

4. 个人主页的数据是怎么组装出来的

4.1 从space_index.php看数据查询链路

space_index.php的执行流程大致是：先根据UID拿到用户基本信息，再分别查询好友数、日志数、相册数、动态列表，最后统一assign给模板。这里的数据查询不是一次性join出来的，而是分多次查询。

为什么不用一条大SQL？因为Discuz要考虑不同数据表的存储引擎可能不同，而且分次查询便于做缓存。每个统计数字都可以单独缓存，用户改了日志只清日志数的缓存，不用把整个主页缓存都清掉。

// 示意：分步查询与缓存 $space = getuserbyuid($uid); // 用户基本信息 $friendnum = C::t('home_friend')->fetch_all_friendnum($uid); // 好友数 $blognum = C::t('home_blog')->count_by_uid($uid); // 日志数

4.2 模板变量与钩子机制

数据组装完之后，会通过include template('home/space_index')加载模板。Discuz的模板引擎会把PHP变量替换成模板标签，同时预留了钩子点（hook）供插件插入内容。

钩子机制是Discuz扩展性的核心。你不需要改源码，只要在钩子点挂上自己的代码，就能在主页插入自定义模块。但要注意，钩子执行顺序是按插件安装顺序来的，如果你依赖某个钩子的输出，得确认插件加载顺序。

4.3 缓存策略对主页性能的影响

个人主页是访问频率很高的页面，Discuz对这块做了多层缓存。用户基本信息走内存缓存，统计数据走数据表缓存，动态列表走文件缓存。缓存过期时间在后台可以配置。

我踩过的一个坑：某次改了用户资料字段，前台死活不更新，排查半天发现是缓存没清。后来养成习惯，改完跟用户信息相关的逻辑，先去后台清一次缓存再测试。这个教训分享给你，能省不少时间。

5. 二次开发中最容易踩的三个坑

5.1 直接改源码导致升级覆盖

这是新手最常犯的错。直接改source/module/home/下的文件，下次Discuz升级一覆盖，你的修改全没了。正确做法是做成插件，通过钩子注入，或者把修改点记在文档里，升级后重新打补丁。

我见过一个站，前后改了十几处源码，升级时全丢了，最后只能对着备份一点点比对。所以从第一天起就养成"能走插件就不改源码"的习惯。

5.2 模板文件放错目录

Discuz的模板有优先级：当前风格目录 > default目录。你把模板改在template/default/home/下，但站点用的是自定义风格，那你的修改根本不生效。改模板前先确认站点当前使用的风格目录。

5.3 忽略语言包导致乱码或空白

home模块的很多文字走语言包（source/language/home/）。如果你新增了功能但没加语言包条目，前台可能显示空白或语言键名。加语言包时注意编码要和现有文件一致，否则会出现乱码。

6. 几个实用的调试技巧

调试home模块时，我常用的手段是在入口文件临时打开错误显示，把$_GET和$_G的关键内容打印出来，确认路由走到了预期分支。Discuz自带debug模式，在配置文件里开启后能看到SQL执行记录，排查数据问题时特别有用。

另外，善用C::t()这个数据层入口。Discuz把数据表操作封装在table类里，你通过C::t('home_blog')就能拿到对应表的操作方法，不用自己写SQL。想查某个表有哪些方法，直接去看source/class/table/table_home_blog.php。

最后提醒一句：改任何东西之前先备份，尤其是数据库。我见过太多"改之前好好的，改完整个空间打不开"的案例，有备份就能五分钟回滚，没备份就得熬夜排查。这个模块的解析先到这里，下一篇我会深入讲home模块的数据表结构和字段设计逻辑。