Suggerimento di tipo variabile in Netbeans (PHP)

Question

Solo curioso se esiste un modo in netbeans per fornire suggerimenti di tipo per variabili regolari, in modo che intellisense lo raccolga. So che puoi farlo per proprietà di classe, parametri di funzione, tipi di ritorno, ecc. Ma non riesco a capire come farlo per variabili regolari. È qualcosa che potrebbe davvero aiutare in situazioni in cui si dispone di un metodo che può restituire diversi tipi di oggetto (come un localizzatore di servizi).

ex qualcosa di simile:

/** 
* @var Some_Service $someService 
*/ 
$someService = ServiceLocator::locate('someService'); 

Dove utilizzando $ someservice dopo, NetBeans fornirebbero tutti i metodi disponibili definiti nella classe di Some_Service.

Answer 1

Una singola linea è tutto ciò che serve:

/* @var $varName Type_Name */ 

si veda questo articolo nel blog di NetBeans PHP: https://blogs.oracle.com/netbeansphp/entry/defining_a_variable_type_in

Answer 2

So che questa è una questione più grande, ma ero alla ricerca di una risposta simile per Eclipse/Zend Studio e questo ha risolto anche questo.

** Nota però che deve essere su una sola riga con l'apertura e la chiusura in modo esplicito in questo stile ...

/* @var $varName Type_Name */ 

Nessun altri formati se ...

/** 
* @var $varName Type_Name 
*/ 

o ...

// @var $varName Type_Name 

sembrava funzionare a tutti. Spero che aiuti qualcuno.

Answer 3

in NetBeans 8.0.2, il vdoc modello che si dà questo:

/* @var $variable type */ 

Netbeans non riconoscerà questo però, e non vi darà l'elenco di completamento automatico corretto per gli oggetti. Invece utilizzare questo, poco prima che la tua dichiarazione di variabile:

/** @var objectType $varName */ 

non ho davvero visto un grande uso per lo stock vdoc Template, in particolare per le variabili di classe che stanno per essere utilizzati come prodotti DOP o PDOStatement oggetti.

Una soluzione che uso è in realtà andare in Strumenti/Opzioni/Editor/Modelli di codice (con PHP selezionato come lingua) e aggiungere un nuovo modello. Ho chiamato il mio suggerimento . Poi sotto di testo esteso, utilizzare il seguente modello:

/** @var ${VAR_TYPE variableFromNextAssignmentType default="ClassName"} $$${VARIABLE variableFromNextAssignmentName default="variable"} */ 

Answer 4

Siete alla ricerca di documentare quei fastidiosi magici variabili? (Ho fatto; La questione si colloca attualmente risultato superiore per che in Google Spero che questo aiuta qualcuno.!)

Il tag @property permette di documentare magici variabili php - quelle realizzate utilizzando __get() e __set().Il tag deve essere utilizzato nella documentazione immediatamente precedente la definizione della classe:

/** 
* Class Contact 
* @property string $firstName 
* @property string $lastName 
*/ 
class Contact extends Model { 
    ... 

Questa notazione innesca completamento automatico, testato in Netbeans 8.1 e PhpStorm 2016,1.

Answer 5

Secondo this bug report, la sintassi cambierà in NetBeans 9:

/* @var $variable VarType */ // vdoc1 (legacy syntax) 
/** @var VarType $variable */ // vdoc (new syntax) 

Inoltre, vale la pena ricordare che è possibile aggiungere [] ad un nome di classe per indicare un array di oggetti:

/* @var $foos Foo[] */ 
$foos = // ... 

foreach ($foos as $foo) { 
    // $foo will be hinted as Foo here 
} 

E non dimenticare la tua dichiarazione use, ad es. use Foo;