Completamento automatico di PhpStorm nei tratti

Question

Ho un tratto che deve sempre essere miscelato in una sottoclasse di \PHPUnit_Framework_TestCase. PhpStorm non lo sa. C'è qualcosa che posso fare per ottenere il completamento automatico di PhpStorm e "tipografare" cose come assertNull all'interno del tratto?

<?php 
trait MyTestUtils 
{ 
    public function foo() 
    { 
     $this->assertNu // autocomplete? 
    } 
} 

il meglio che potevo venire con finora sta mettendo quanto segue in ogni metodo:

/** @var \PHPUnit_Framework_TestCase|MyTestUtils $this */ 

Ma questo è ripetitivo e non capisce memebers protette. C'è un'opzione migliore?

Answer 1

Direi che questo non è un caso d'uso valido per un tratto PHP. Il tuo tratto, come scritto non è garantito per essere utilizzato solo su classi che estendono \ PHPUnit_Framework_TestCase. Questo introduce un codice molto strettamente accoppiato. La migliore pratica dei Tratti è che siano accoppiati molto liberamente e siano solo consapevoli dei propri contenuti.

vorrei invece consigliare che si sia:

1. creare una sottoclasse di \ PHPUnit_Framework_TestCase che i casi di test che hanno bisogno di questa funzionalità può estendere
2. creare classi affermazione personalizzate. Questi possono essere usati molte volte per fare gruppi di asserzioni personalizzate.

Entrambe le tecniche sono dettagliate qui: http://phpunit.de/manual/4.1/en/extending-phpunit.html

Questi sono i due raccomandato migliori pratiche per dove posizionare i metodi helper come questi.

Answer 2

Oltre a utilizzare il docblock php per documentare $this, l'unico altro modo io sappia, che ha anche, rende senza dubbio il vostro tratto più "sicura" in ogni caso, è quello di definire metodi astratti sul tratto in sé, ad esempio:

trait F { 

    /** 
    * @return string[] 
    */ 
    abstract public function Foo(); 

    /** 
    * @return self 
    */ 
    abstract public function Bar(); 
} 

abstract class Bar { 
    use F; 

    /** 
    * @return bool|string[] 
    */ 
    public function Baz() { 
     if ($this->Bar()) { 
      return $this->Foo(); 
     } 

     return false; 
    } 
} 

Answer 3

UPDATE: Dal PhpStorm 2016/01/02 (build 145.1616) il completamento automatico in tratti funziona out-of-the-box. È abbastanza intelligente da capire quali classi usano il tratto e quindi fornire il completamento automatico. Collegamento alla questione: https://youtrack.jetbrains.com/issue/WI-16368

Precedentemente ha risposto con:

È possibile utilizzare:

@method \PHPUnit_Framework_TestCase assertTrue($condition, $message = '') 

... in docblock del carattere in sé, ma il lato negativo è che si avrebbe bisogno inserire @method per ogni metodo per il quale si desidera eseguire il completamento automatico, il che non è un problema se si utilizza un numero ragionevole di chiamate di metodo nel tratto. Oppure, "documenta" solo i metodi che usi più spesso.