Support Object[] params

[ciaranmcnulty]

We took out support for @param in favour of type hints, but there are maybe some cases where it could be supported - I'm mostly thinking of Object[] types

/**
 * @param Foo[] $foos
 */
function it_uses_array(array $foos)
{
    $foos[0]->bar()->willReturn(1);
    $foos[1]->bar()->willReturn(2);

    $this->baz($foo)->shouldBe([1,2]);
}

[orklah]

In order to give static analysis tools all the information they need, array<int, Foo> or even list<Foo> should be used when applicable

[drupol]

I would also use array<int, Foo> or list<Foo> over Foo[].