如何使用php-tmdb API wrapper处理TMDb搜索结果？

嘿，我之前也踩过这个坑！这个php-tmdb/api库的Model API设计就是靠Getter方法来访问属性的，而不是直接去碰那些私有/受保护的属性——这是它的面向对象封装规范，刚开始确实容易懵，尤其是文档没把这个点突出的时候。

核心思路：用Getter方法替代直接访问属性 #

这个库的所有模型类（包括ResultCollection、Tv、Genre这些）都为私有/受保护属性提供了对应的Getter方法，命名规则很统一：属性名驼峰式，Getter就是get+属性名首字母大写的格式。

具体操作示例 #

把你的代码改成下面这样，就能正常访问所有需要的数据了：

$token = new \Tmdb\ApiToken(TMDB_API_KEY);
$client = new \Tmdb\Client($token);
$search = new \Tmdb\Repository\SearchRepository($client);
$query = new \Tmdb\Model\Search\SearchQuery\TvSearchQuery();
$query->page($page);

// 执行搜索获取结果集合
$resultCollection = $search->searchTv('breaking bad', $query);

// 访问集合的元数据（页码、总页数等）
echo "当前页码：" . $resultCollection->getPage() . "\n";
echo "总页数：" . $resultCollection->getTotalPages() . "\n";
echo "总结果数：" . $resultCollection->getTotalResults() . "\n";

// 遍历所有搜索到的TV节目
// ResultCollection实现了迭代器接口，可以直接用foreach循环
foreach ($resultCollection as $tvShow) {
    // 访问TV节目的基础属性
    echo "节目ID：" . $tvShow->getId() . "\n";
    echo "节目名称：" . $tvShow->getName() . "\n";
    
    // 处理日期类型的属性（返回DateTime对象，可直接调用format方法）
    if ($firstAirDate = $tvShow->getFirstAirDate()) {
        echo "首播日期：" . $firstAirDate->format('Y-m-d') . "\n";
    }
    
    // 访问嵌套的类型集合
    $genres = $tvShow->getGenres();
    foreach ($genres as $genre) {
        echo "类型：" . $genre->getName() . "（ID：" . $genre->getId() . "）\n";
    }
}

额外提示 #

• 如果想直接拿到所有TV模型的数组，可以调用$resultCollection->getResults()方法
• 所有模型的Getter方法都可以在库的源码里找到（比如查看ResultCollection.php、Tv.php文件），如果不确定某个属性对应的Getter，直接看源码是最靠谱的办法

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