---
url: https://docs.zblogcn.com/php/dev-examples/magic/category-url.md
description: >-
  通过 Filter_Plugin_Category_Url 接口在 Z-BlogPHP 读取分类 Url
  属性时接管分类地址生成，配合伪静态规则实现自定义分类链接。
---

# 分类地址自定义接口

在 Z-BlogPHP 中读取分类对象的 `Url` 属性（包括模板中的 `{$category.Url}`）时会触发 `Filter_Plugin_Category_Url` 接口，可以接管分类地址的生成逻辑，实现自定义分类链接等场景。

## 接口信息

| 接口 | 参数 | 说明 |
| --- | --- | --- |
| `Filter_Plugin_Category_Url` | `&$this` | 干预 Category 类 Url 方法的接口 |

## 完整案例

下例把全站分类地址统一改为 `cate/{ID}/` 形式，需配合伪静态规则使用：

```php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Category_Url', 'demoAPP_Category_Url', PLUGIN_EXITSIGNAL_RETURN);
}

function demoAPP_Category_Url(&$category)
{
    global $zbp;

    return $zbp->host . 'cate/' . $category->ID . '/';
}
```

## 注意事项

* 仅在读取 `Url` 属性时触发；`Url` 是只读虚拟属性，给 `$category->Url` 赋值不会触发本接口（赋值会被系统忽略）。
* 本例通过 `PLUGIN_EXITSIGNAL_RETURN` 信号无条件使用回调返回值，全站分类地址都会被接管；如只想干预部分分类，可在注册时不设信号，回调内按条件用 `SetPluginSignal` 动态生效。
* `cate/{ID}/` 只是输出的链接形式，必须配合伪静态规则把该形式映射到系统分类列表页，否则前台访问会 404。
* 回调中不要再次读取当前分类的 `Url` 属性，避免递归死循环。