LaravelでCollectionを引数に指定するとPhpStormで型エラーがでる

Question

###前提・実現したいこと
フレームワーク「Laravel5.4」、IDE「PhpStorm2017.2」を使ってアプリ開発をしています。
補完したいという理由からCollectionというコメントを入れています。

###発生している問題・エラーメッセージ
PhpStormを使って開発を行っているのですが、補完したいという理由からCollectionというphpDocumentorを入れると、toArray()などの補完は行えるようになる反面、$this->Hoge($userList);の部分に引数の警告が発生してしまいます。

■エラー内容（PhpStormの警告）
Invocation parameter types are not compatible with declared.

PhpStormの設定を変更し警告を消すという方法もあるのですが、それを行ってしまうと引数指定ミスすべてに対してエラーがでなくなってしまうので設定変更に踏み切れずにいます。

Collectionに対するtoArrayなどの予測変換を出すようにしたい、しかしPhpStromの警告は出したくないと思っております。
何かよい方法ありますでしょうか。もしあればご教示いただけると幸いです。

■補足
laravel-ide-helperは入れています

###該当のソースコード

public function getHogeList()
{
   
    $userList = User::query()->where('hoge')->get();

  // コレクションを引数として渡しているつもりが警告が出る
    $hoge = $this->Hoge($userList);
    
}

/**
 * @param Collection $hoge
 * @return mixed
 */
public function Hoge($hoge)
{
    $userList = $hoge->toArray();

    return $userList;
}

Answer 1

Collectionの部分を\Illuminate\Database\Eloquent\Collectionに変えてみてはどうでしょうか？
use文が見えないので分かりませんが、phpdocに書くクラス名はその名前空間にあるクラス名か、useしている必要があるので、この場合はuseするか完全修飾名でクラス名を書く必要があります。

Comments

[yukiusagi]

返答ありがとうございます。

\Illuminate\Database\Eloquent\Collectionに変更したところ警告が消えました。
useへの記載がなかったので教えていただいたように記載したところ無事に問題解決できました。
ありがとうございます。

Answer 2

PHPStorm2017.3EAPでLaravel5.4で同等のコード(Userクラスはデフォルトの物で想定)を試しましたが、特に該当のエラーはでなかったので、

* @param Collection $hoge

の記述に対して、

use Illuminate\Support\Collection;

をしていないのであれば追記すると状況が変わるかもしれません。

警告を消すならば以下の記述も効果があるかもしれません。

/*@var Collection $userList*/
$userList = User::query()->where('hoge')->get();

他にはEditor > Inspections > PHPでコード警告等の詳細が設定できます。
Laravelはマジックメソッドやリフレクション等で構造が複雑なので、他のフレームワークに比べるとPHPStormが思うように補完してくれないこともあります。

Comments

[yukiusagi]

いつもありがとうございます。
確認したところuseの記載漏れが原因でした。
記載したところ無事に解決できました。ありがとうございます。
お二人両方にベストアンサーしたいのですがシステム上できないようですので申し訳ございません。