---
url: https://docs.zblogcn.com/php/dev-examples/magic/post-prev.md
description: >-
  通过 Filter_Plugin_Post_Prev 接口在 Z-BlogPHP 读取文章 Prev
  属性时自定义上一篇逻辑，如同分类内取上一篇，返回空则走系统默认。
---

# 文章上一篇自定义接口

在 Z-BlogPHP 中读取文章对象的 `Prev` 属性（即上一篇）时会触发 `Filter_Plugin_Post_Prev` 接口，回调返回非空结果即作为上一篇使用，返回空则继续执行系统默认查询，适合实现「同分类上一篇」「同作者上一篇」等自定义逻辑。

## 接口信息

| 接口 | 参数 | 说明 |
| --- | --- | --- |
| `Filter_Plugin_Post_Prev` | `$post` | Post 类的 Prev 接口 |

## 完整案例

下例把「上一篇」改为同分类内按发布时间倒序的上一篇文章：

```php
<?php

RegisterPlugin("demoAPP", "ActivePlugin_demoAPP");

function ActivePlugin_demoAPP()
{
    Add_Filter_Plugin('Filter_Plugin_Post_Prev', 'demoAPP_Post_Prev');
}

function demoAPP_Post_Prev($post)
{
    global $zbp;

    if ($post->Type != 0) {
        return '';
    }

    $articles = $zbp->GetPostList(
        array('*'),
        array(
            array('=', 'log_Type', 0),
            array('=', 'log_Status', 0),
            array('=', 'log_CateID', $post->CateID),
            array('<', 'log_PostTime', $post->PostTime)
        ),
        array('log_PostTime' => 'DESC'),
        array(1),
        null
    );

    if (count($articles) == 1) {
        return $articles[0];
    }

    return '';
}
```

## 注意事项

* 触发时机在读取 `Prev` 属性时；回调返回值只要非空（`!== ''`）就作为上一篇，返回空字符串或 `null` 时系统继续按默认规则查询全站上一篇。
* 无需设置 `PLUGIN_EXITSIGNAL_RETURN` 信号，本接口按「返回值是否为空」判断是否生效。
* 返回的结果会被缓存在当前文章对象内，同一对象重复读取 `Prev` 不会重复触发本接口。
* 自定义查询请保持与系统默认相似的过滤条件（已发布 `log_Status = 0` 等），避免把草稿、审核中的文章泄露到前台。