PHPCMS V9自定义栏目字段从入门到精通实操指南

第一步：扩展数据库表结构

实现PHPCMS自定义栏目功能的第一步是修改数据库结构。PHPCMS V9的栏目信息存储在v9_category数据表中（假设你的表前缀是默认的v9_）。我们需要在该表中手动添加一个字段，用于存储我们需要的新数据。本教程以添加一个常见的“栏目缩略图”字段为例，字段名为cat_thumb。

请登录你的数据库管理工具（如phpMyAdmin），执行以下SQL语句。请务必确认你的表前缀，如果安装时修改了前缀，请将v9_category替换为实际表名。

```sql ALTER TABLE `v9_category` ADD `cat_thumb` VARCHAR( 255 ) NOT NULL DEFAULT ''; ```

这条SQL语句的作用是在v9_category表中添加一个名为cat_thumb的字段，类型为变长字符串，最大长度255，不允许为空，默认值为空字符串。执行成功后，你可以刷新数据库表结构，确认新字段已经存在。

第二步：修改后台添加栏目模板

数据库准备好后，我们需要在后台“添加栏目”的界面中增加一个输入框，以便管理员可以输入或上传缩略图。这需要修改PHPCMS的后台模板文件。

请使用代码编辑器打开文件：phpcms/modules/admin/templates/category_add.tpl.php。

在该文件中找到大约第56行左右，搜索“栏目名称”或者标签闭合的位置。为了方便管理，我们将缩略图字段放在“栏目拼音”字段之后。请找到以下代码段：

```html ```

在上述代码段的下方，直接粘贴以下HTML代码。这段代码调用了PHPCMS封装的图片上传函数form::image，确保上传功能与系统原生保持一致。

```html 栏目缩略图 ```

注意：这里的name="info[cat_thumb]"非常关键，它必须与我们在第一步数据库中添加的字段名保持一致，且必须放在info数组中，这样后台控制器才能自动接收并处理该数据。

第三步：修改后台编辑栏目模板

仅仅修改添加页面是不够的，我们还需要在“编辑栏目”页面也能显示和修改这个字段。请打开文件：phpcms/modules/admin/templates/category_edit.tpl.php。

同样地，找到“栏目名称”或相关表单区域，在合适的位置插入以下代码。与添加页面不同的是，编辑页面的图片上传函数需要多传入一个参数，即当前字段的值$cat['cat_thumb']，以便在编辑时回显已上传的图片。

请在“栏目名称”的下方添加：

```html 栏目缩略图 ```

确保代码中的$cat['cat_thumb']正确获取了当前栏目的数据。如果此时你刷新后台页面并尝试编辑一个栏目，应该能看到“栏目缩略图”的上传框了。

第四步：后台控制器逻辑验证

PHPCMS V9的后台控制器设计非常灵活，对于category_info类的扩展字段，通常不需要修改核心PHP逻辑代码即可自动入库。这是因为系统在处理$_POST['info']数组时，会直接将其映射到数据库更新操作中。

为了确保万无一失，我们可以简单检查一下控制器文件：phpcms/modules/admin/category.php。

查看public function add()和public function edit()两个方法。你会发现代码中使用了$this->db->insert($info)或$this->db->update($info, ...)。只要我们在模板中使用了name="info[cat_thumb]"，$info数组就会自动包含cat_thumb键值对，系统会自动将其写入数据库，无需手动编写SQL语句。这便是PHPCMS框架的便捷之处。

第五步：前台模板调用与显示

完成了后台数据的录入和存储，最后一步是在前台网站中将这个自定义字段显示出来。PHPCMS的前台栏目数据通常通过$CATEGORYS全局变量获取。

在你的前台模板文件（例如header.html、category.html或index.html）中，可以使用以下标签代码来输出栏目缩略图。

```html {loop $CATEGORYS $catid $cat} {/loop} ```

如果你是在当前栏目页内部（category.html），可以直接使用当前栏目ID$catid来调用：

```html ```

重要提示：如果在修改完模板后没有看到图片，请进入PHPCMS后台，点击“设置” -> “系统设置” -> “清除缓存”，或者直接删除caches目录下的缓存文件。因为$CATEGORYS变量通常是缓存的，数据库结构的更新必须清除缓存才能生效。

总结

通过以上五个步骤，我们完成了从数据库底层到前台展示的全链路开发。核心逻辑在于：数据库增加字段、后台模板增加表单控件（注意info数组命名）、利用系统自动机制入库、前台通过$CATEGORYS调用。只要严格按照字段名保持一致，你就可以任意扩展PHPCMS的栏目功能，比如增加SEO标题、栏目Banner图、自定义简介等。