Timber 2.0升级指南中的上下文传递文档修正

在Timber 2.0版本升级过程中，开发者需要特别注意上下文(Context)传递方式的变更。近期发现官方升级指南中存在一个需要修正的代码示例，这可能会影响开发者的升级体验。

问题背景

Timber是一个优秀的WordPress模板引擎，在2.0版本中对许多API进行了改进和优化。其中，上下文传递是模板渲染的核心功能之一。在升级指南中，关于如何直接向上下文传递变量的示例代码存在不准确之处。

正确的上下文传递方式

经过验证，正确的变量传递方式应该是直接将查询参数数组赋值给上下文变量，而不需要额外的"query"包装层：

$context['posts'] = Timber::get_posts([
    'post_type' => 'book',
    'posts_per_page' => -1,
    'post_status' => 'publish',
]);

这种方式更加简洁直接，与Timber 2.0文档中其他部分的示例保持一致。

原文档中的不准确示例

升级指南中原先展示的代码示例使用了不必要的嵌套结构：

$context['posts'] = Timber::get_posts([
    'query' => [
        'post_type' => 'book',
        'posts_per_page' => -1,
        'post_status' => 'publish',
    ],
]);

这种写法虽然在某些情况下可能不会导致错误，但不是推荐的做法，也与Timber 2.0的设计理念不符。

对开发者的影响

对于正在从Timber 1.x升级到2.0的开发者来说，遵循正确的上下文传递方式非常重要：

1. 代码更加简洁易读
2. 与其他Timber API保持一致性
3. 减少潜在的兼容性问题
4. 提高代码执行效率

最佳实践建议

在Timber 2.0中使用上下文传递时，建议开发者：

1. 直接传递查询参数数组，无需额外包装
2. 保持参数结构与WordPress原生查询一致
3. 对于复杂查询，考虑使用查询构建器
4. 始终参考最新官方文档中的示例

总结

Timber团队已经确认了这个文档问题并发布了修正。开发者在使用Timber 2.0时，应该采用直接传递查询参数的方式来处理上下文数据，这不仅能确保功能正常，也能使代码更加清晰和易于维护。