---
url: https://docs.zblogcn.com/php/dev-examples/magic/post-call.md
description: >-
  通过 Filter_Plugin_Post_Call 接口在 Z-BlogPHP 调用文章对象不存在的方法时返回自定义虚拟方法，为 Post
  对象扩展可带参数的行为。
---

# 文章虚拟方法接口

在 Z-BlogPHP 中调用文章对象上不存在的方法时（例如 `$post->DemoSummary(100)`），会触发 `Filter_Plugin_Post_Call` 接口，插件可借此为 Post 对象扩展「虚拟方法」，让模板和主题代码以对象方法的形式调用插件提供的功能。

## 接口信息

| 接口 | 参数 | 说明 |
| --- | --- | --- |
| `Filter_Plugin_Post_Call` | `&$post, $method, $args` | Post 类的魔术方法接口 |

## 完整案例

下例为文章对象添加虚拟方法 `DemoSummary($len)`，返回按长度截断的纯文本摘要：

```php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Post_Call', 'demoAPP_Post_Call');
}

function demoAPP_Post_Call(&$post, $method, $args)
{
    if ($method == 'DemoSummary') {
        $len = isset($args[0]) ? (int) $args[0] : 100;
        // 动态设置 RETURN 信号，本次调用使用本回调的返回值
        SetPluginSignal('Filter_Plugin_Post_Call', __FUNCTION__, PLUGIN_EXITSIGNAL_RETURN);
        return SubStrUTF8(trim(strip_tags($post->Content)), $len);
    }
}
```

注册后在模板或代码中直接调用即可：

```php
echo $article->DemoSummary(120);
```

## 注意事项

* 只在调用对象上真实不存在的方法时触发，`Save()`、`Del()`、`Time()`、`Thumbs()` 等系统已有方法不会走到本接口。
* `$args` 是索引数组，按调用时的参数顺序排列；只有回调内动态设置 `PLUGIN_EXITSIGNAL_RETURN` 信号后返回值才会生效，否则系统按默认逻辑处理（通常给出方法不存在的警告）。
* 不要在注册时静态传入 `PLUGIN_EXITSIGNAL_RETURN`，否则所有未知方法的调用都会返回本回调的值，掩盖其他错误。
* 回调中不要调用与 `$method` 同名的虚拟方法本身，避免递归死循环。