PHPDoc的 - 在阵列内不同的对象有不同的类

Question

比方说，我有一个用户对象$用户和Car对象$车

function my_function(){ 
    return array(
     new User(), 
     new Car() 
    ); 
} 

我应该使用返回数组$数据的功能我函数文档的@return参数？

Answer 1

我会做这样

/** 
* @return User[]|Car[] 
*/ 

一般|意味着或和SomeType[]意味着有一个阵列SOMETYPE

你肯定的，你不想吗？

/** 
* My Parent Object 
*/ 
class SomeClass { 

    /** 
    * The User 
    * @var User 
    */ 
    public $User; 

    /** 
    * The Car 
    * @var Car 
    */ 
    public $Car; 
} 

关于PHP的好（邪恶）的事情是，你可以混合使用数组类型。用强大的键入语言（出于理性）你不能。这里我们使用接口和类似的东西。我们用PHPDoc尝试的是强类型PHP。所以你应该玩一种强类型语言的规则。