假设我有一个 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
导入类?
最佳答案
如果没有 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...
}
}
关于php - 如果我使用 use 导入类,我应该在 PHPDoc 中使用 FQN 吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/47512281/