函数返回类型提示PHP7中的对象数组

Question

我对PHP 7中的新功能非常满意.但我对如何在PHP 7中返回一个对象数组感到困惑.

例如,我们有一个类Item,我们想从函数返回这个类的对象数组:

function getItems() : Item[] {
}

但它不会这样.

Answer 1

我实际上明白你的意思,但不幸的是答案是你不能这样做.PHP7缺乏那种表现力,所以你可以声明你的函数返回"数组"(一个通用数组),或者你必须创建一个新类ItemArray,这是一个Item数组(但这意味着你必须自己编写代码) ).

目前无法表达"我想要一个项目数组"实例.

编辑:作为一个额外的参考,这里是您想要做的"阵列"RFC,由于各种原因它已被拒绝.

Answer 2

这被称为泛型,遗憾的是我们不会很快看到这个功能.您可以使用docblocks以这种方式键入提示.

像PhpStorm这样的PHP编辑器(IDE)非常支持这一点,并且在迭代这样的数组时将正确地解析类.

/**
 * @return YourClass[]
 */
public function getObjects(): iterable

PHPStorm还支持嵌套数组:

/**
 * @return YourClass[][]
 */
public function getObjects(): iterable

Answer 3

当前版本的PHP不支持对象数组的内置类型提示,因为没有像"对象数组"这样的数据类型.类名可以在某些上下文中被解释为类型array,但是一次不能同时解释为两种类型.

实际上你可以通过创建一个基于ArrayAccess接口的类来实现这种严格的类型提示,例如:

class Item
{
    protected $value;

    public function __construct($value)
    {
        $this->value = $value;
    }
}

class ItemsArray implements ArrayAccess
{
    private $container = [];

    public function offsetSet($offset, $value)
    {
        if (!$value instanceof Item) {
            throw new Exception('value must be an instance of Item');
        }

        if (is_null($offset)) {
            $this->container[] = $value;
        } else {
            $this->container[$offset] = $value;
        }
    }

    public function offsetExists($offset)
    {
        return isset($this->container[$offset]);
    }

    public function offsetUnset($offset)
    {
        unset($this->container[$offset]);
    }

    public function offsetGet($offset)
    {
        return isset($this->container[$offset]) ? $this->container[$offset] : null;
    }
}


function getItems() : ItemsArray
{
    $items = new ItemsArray();
    $items[0] = new Item(0);
    $items[1] = new Item(2);
    return $items;
}

var_dump((array)getItems());

产量

array(2) {
  ["ItemsArrayitems"]=>
  array(0) {
  }
  ["container"]=>
  array(2) {
    [0]=>
    object(Item)#2 (1) {
      ["value":protected]=>
      int(0)
    }
    [1]=>
    object(Item)#3 (1) {
      ["value":protected]=>
      int(2)
    }
  }
}