海洋CMS二次开发怎么入手？钩子与函数扩展思路

结论：海洋CMS 没有 WordPress 那种 add_action/add_filter 形式的通用钩子（hook，指核心在固定位置主动回调你写的函数），二次开发的正解不是"找钩子"，而是"自己造注入点"——先建 Git 备份，再用 include 挂载或输出缓冲把自定义代码挂在核心文件之外，能不直接改核心就不改。

海洋CMS 有钩子吗？为什么找不到？

结论：官方版不提供通用 hook API，你能找到的只有"可注入的位置"，没有现成的扩展点。

WordPress 的钩子能成立，是因为核心代码会在渲染、保存、查询这些节点主动调用 do_action() 把控制权交出去。海洋CMS 是轻量级 PHP 程序，核心逻辑是一条线跑到底的：读配置、查数据库、套模板、输出。它不会在某个位置回头喊你的函数，所以网上流传的"海洋CMS 钩子"多半指的是模板标签或者自己打的补丁点。

要确认自己这套源码的包含链，进站点根目录跑：

grep -rn --include="*.php" -E "(require|include)(_once)?\s*\(" . | head -50

输出就是它的加载骨架。入口文件通常在站点根目录（各版本文件名有差异，以你手上的源码为准），公共配置和数据库连接被它第一个包含进来——这两个位置就是最常用的注入点。

二次开发第一步该做什么？

结论：动手前必须先做两件事：文件备份 + Git 版本库，这决定了你后面能不能全身而退。

具体步骤：

cp -a /www/wwwroot/你的站点 /tmp/site_bak_$(date +%F)
cd /www/wwwroot/你的站点 && git init && git add -A && git commit -m "原始版本"
php -v   # 记录 PHP 版本，二次开发最容易踩的坑就是版本不匹配

然后在本地搭一套同样的环境和数据库，在测试环境里开 display_errors=On、error_reporting=E_ALL。线上千万别开——报错信息会把物理路径和 SQL 结构直接吐给访客。

好处很直接：改崩了 git checkout . 一键还原；官方出新版本时，git diff 能告诉你它到底改了什么、有没有修安全漏洞。

不改核心文件，代码往哪挂？三种注入方式

结论：按侵入性从低到高是「入口 include → 输出缓冲 → 改模板」，优先用第一种。

第一种，include 挂载。 在入口文件最顶部加一行：

require_once __DIR__ . '/ext/hook.php';

所有自定义逻辑写进 ext/ 目录。升级时官方文件覆盖了，你只需要重新补这一行，风险最小。

第二种，输出缓冲。 在同一位置写：

ob_start('seacms_ext_filter');
function seacms_ext_filter($html) {
    return str_replace('</body>', '<script>/*统计代码*/</script></body>', $html);
}

它能拦下全站最终输出的 HTML，适合加统计代码、批量换广告位、统一改链接。注意：回调函数里绝对不要查数据库，这个函数每个页面都会执行一次，一次慢查询会把整站拖垮。

第三种，改模板。 见效最快，但模板文件同样属于会被升级覆盖的范围，改动前先复制一份原始模板到 ext/tpl_backup/。

函数扩展怎么放才不撞名？

结论：自定义函数集中在 ext/functions.php，函数名前缀统一加，别往核心文件里塞。

海洋CMS 自身定义了数量可观的全局函数，PHP 里同名函数重复声明会直接抛致命错误、整站白屏。所以：

1. 所有自定义函数加前缀，比如 seacms_ext_get_rank()；
2. 纯函数用 require_once 引入，类用 spl_autoload_register() 注册；
3. 引用第三方组件前先 if (!function_exists('xxx')) 判断；
4. 需要复用核心逻辑时，优先在自定义文件里重写一份，而不是改核心函数——改核心函数的代价是下次升级要逐行合并。

升级后代码被覆盖怎么办？

结论：把自定义代码全部隔离在独立目录，并维护一份改动清单，升级成本能压到"补一行 include"。

如果确实不得不改核心文件，每改一处就在 changes.txt 里记一条：文件名、行号、改动原因、原始代码。升级时先 git diff 新旧版本，把官方修的安全问题挑出来，再对照清单逐条重打补丁。

另外两个小提醒：改前确认模板和文件的编码（GBK 与 UTF-8 混用会出现中文乱码和"空白页"两种典型症状）；改完模板记得清一下程序自己生成的缓存文件，否则你改了源码看到的还是旧页面。

总的来说，海洋CMS 二次开发的核心思路就一句：它没有钩子，所以注入点要自己选；选完就要把自定义代码和核心代码物理隔离，用 Git 兜底，用清单管理改动。做到这三点，你的补丁就能跟着官方版本一路活下去。