正確的PHPDoc用於帶有對象返回值的switch語句

Question

如果您願意，請看我正在研究的項目（函數api（））。

IDE真正自動完成返回的對象實例的方法的正確方法是什么？ 我現在使用它的方式從所有可能的返回對象返回所有方法。

短; 如何確保IDE能夠識別由switch語句定義的對象的自動完成方法？ 我想知道IDE自動完成此操作的正確方法，以及最佳的PHPDoc策略（它確實具有接口，但是暫時是空的）。

更新1

正如第一條評論所建議的那樣，我嘗試將“電影”的情況調整為測試：

case 'movies':
    return $this->getMovieApi();

並添加

/**
 * @return Api\Movies
 */
private function getMovieApi(){
    return new Api\Movies($this);
}

但這在嘗試調用時無法按預期運行：

$client->api('movies')->[try_autocomplete]

但是，當我將getMovieApi的范圍更改為public並直接將其調用為：

$client->getMovieApi()->[try_autocomplete]

它可以按預期工作，但是我真的更喜歡我的初始方法，因為它看起來更干凈（至少對我來說）。 如果返回值是從switch語句派生的，是否真的不可能獲得正確的自動完成功能？

Answer 1

正確的方法是使用自己的@return創建所有這些get方法： getConfiguration ， getAuthentication等。