php - 如果我使用 use 导入类，我应该在 PHPDoc 中使用 FQN 吗？

Question

假设我有一个 UserController 类，我正在使用 use 导入 App\User 类。在内部，有一个 show() 方法接收 User 的实例。

namespace App\Http\Controllers;

use App\User;

class UserController extends Controller
{
    /**
     * Show user info
     * 
     * @param  User $user
     * @return Illuminate\Http\JsonResponse
     */
    public function show(User $user)
    {
        // Do something...
    }
}

是否建议在 PHPDoc 中添加 User 的完全限定名称，即使我正在使用 use 导入类？

Answer 1

如果没有 use 语句，则使用 FQN，因为它将被识别为不同的类，在您的情况下为未导入的 \JsonResponse。

对于User类，使用简称。

用use语句导入类，在docblock中写短名称更方便。

也可以使用类别名，例如:

namespace App\Http\Controllers;

use App\User;
use Illuminate\Http\JsonResponse as Response;

class UserController extends Controller
{
    /**
     * Show user info
     * 
     * @param  User $user
     * @return Response
     */
    public function show(User $user)
    {
        // Do something...
    }

}