WordPress中Timber默认查询分页失效及dump异常问题求助

1. 分页功能无法正常工作的原因 #

分页失效是多个代码问题叠加导致的：

• 参数拼写与取值错误：查询参数中post_staus为拼写错误，正确参数名是post_status，且该参数对应已发布文章的取值为publish，而非你写的published，该问题会导致查询条件不符合预期。
• 手动设置offset与原生分页逻辑冲突：WordPress 原生分页计算逻辑不会自动兼容手动传入的固定offset值，你固定写死offset=1，会导致分页时偏移量计算完全错误——比如第二页会默认从第2篇开始取，而不是跳过第一页已展示的2篇+单独置顶的1篇最新文，从第4篇开始取。Timber 的分页组件默认依赖 WordPress 原生查询的分页计数结果，自然无法正常渲染。
• 未修正总文章数计数：你单独查询了1篇最新文章做置顶展示，剩余可分页的文章总数是总发布文章数减1，但默认分页逻辑会按全量文章数计算总页数，会出现最后一页空白、分页页码数量不对的问题。

可参考以下修正后的查询逻辑：

<?php
use Timber\Post;
use Timber\Timber;

$post = new Post();
$context = Timber::context();
$context['post'] = $post;

$posts_per_page = 2;
$paged = get_query_var('paged') ? get_query_var('paged') : 1;
// 单独取最新1篇
$context['latest'] = Timber::get_posts([
    'posts_per_page' => 1,
    'offset' => 0,
]);
// 计算剩余文章分页参数
$total_published = wp_count_posts()->publish;
$remaining_total = $total_published - 1;
$page_offset = ($paged - 1) * $posts_per_page + 1;

$args = [
    'post_status' => 'publish',
    'posts_per_page' => $posts_per_page,
    'paged' => $paged,
    'offset' => $page_offset,
    'found_posts' => $remaining_total, // 手动传入修正后的总文章数，供分页计算
];
$context['posts'] = Timber::get_posts($args);

Timber::render('page-home.twig', $context);

2. dump 无输出但文章循环正常运行的原因 #

• Timber::get_posts() 返回的不是普通数组，是实现了迭代器接口的 PostQuery 对象：模板中{% for post in posts %}能正常运行，是因为该对象自带遍历逻辑，可以像数组一样循环取文章内容。
• dump 空白是调试配置与对象特性共同导致的：如果没有开启 Twig 调试模式、或者环境开启了 OPcache 扩展，Twig 自带的 dump 函数无法正常读取这类靠魔术方法实现的对象的内部属性，就会输出空白。可以将打印代码改为{{ dump(posts.toArray) }}，先将对象转为普通数组再打印，即可正常输出调试内容，同时注意要在 wp-config.php 中开启WP_DEBUG与WP_DEBUG_DISPLAY，并在 Timber 配置中开启twig.debug参数。

内容的提问来源于stack exchange，提问作者MMPL1