Почему не работают некоторые подсказки в контроллере ZF2 и как лучше с этим бороться?

Question

[Котик Антон]

В методе контроллера вводим $this->getRequest()-> и не видим в списке подсказок, например, метод getHeader.

Чтобы видеть подсказки, приходится писать так:

namespace Application\Controller;

use Zend\Mvc\Controller\AbstractActionController;

use Zend\Http\PhpEnvironment\Response as HttpResponse;
use Zend\Http\Request as HttpRequest;

/**
 * @method HttpRequest getRequest() Get request object
 * @method HttpResponse getResponse() Get response object
 */
class TestController extends AbstractActionController
{
    public function testAction()
    {
        $this->getRequest()->getHeader('referer'); // подсказки работают
    }
}

Вопроса два:
1. Может есть способ получше?
2. Почему подсказки изначально не видны? Баг документации кода ZF2 или что-то ещё?