Vim IDE per Php

Configurazione base
Fedora, nell’installazione standard di Vim, da già una configurazione di base di quest’ultimo. La sintassi colorata è già attivata per esempio.
Si può leggere il file di configurazione di default di Vim in /etc/vimrc.

Ho però voluto personalizzare ulteriormente la configurazione di Vim aggiungendo alcune caratteristiche. Ho creato dunque un file di nome .vimrc nella home directory del mio utente e al suo interno ho aggiunto quanto segue:

set number "attivo la visualizzazione del numero delle righe"
set mouse=a "attivo il supporto per l'uso del mouse"
filetype on
autocmd FileType c,cpp,php set cindent shiftwidth=4 "vedi di seguito"
set splitbelow "quando apro una nuova finestra in Vim voglio che si apra in basso e non in alto"

Il comando che rende Vim già un ottimo editor per codice php è il penultimo: autocmd FileType c,cpp,php set cindent shiftwidth=4.
E’ sempre importante creare una buona indentazione del proprio codice.
Con il comando filetype on ho attivato in Vim la possibilità di riconoscere i tipi di file che sta caricando e con il penultimo comando ho istruito Vim ad utilizzare l’indentazione standard del codice C per tutti i file con estensione c o cpp o php.
Il Php è abbastanza simile al C o al C++ come sintassi, quindi è una buona scelta usare l’indentazione del proprio codice come se fosse codice C con una indentazione di 4 spazi bianchi.

Ora però è venuto il momento di estendere Vim in modo tale da essere ancora più veloci e produttivi nella creazione dei propri script.

ManPageView documentazione a portata di mano

Una cosa importante è avere sempre a portata di mano la documentazione di Php.
Doversi spostare in un browser web e navigare alla ricerca della documentazione di una determinata funzione è abbastanza noioso e fa perdere tempo.
Io voglio poter leggere direttamente la documentazione di Php da Vim.
Esiste un plugin scritto da Charles Campbell per far questo: ManPageView.

L’installazione è davvero semplice, basta scaricare il pacchetto dalla pagina del progetto e come specificato nella documentazione, dopo essersi spostati nella directory del pacchetto scaricato procedere con:

$ vim manpageview.vba.gz
   :so %
   :q   

Per utilizzare questo pacchetto è importante avere installato sul proprio sistema elinks. Per installarlo in fedora basta digitare in un terminale:

su -c "yum install elinks"

L’uso di ManPageView è davvero molto semplice. Se c’è una connessione attiva a internet all’interno della propria sessione di Vim in modalità normale (non inserimento) basta digitare:

:Man nome_funzione

(sostituire nome_funzione con il nome di una funzione php).
Se ad esempio si digita :Man echo Vim aprirà una finestra contente la documentazione della funzione echo presente nella documentazione ufficiale di php a questo indirizzo.

Commentare il proprio codice Php

Dato che stiamo parlando di documentazione e di buona scrittura del proprio codice Php…
E’ sempre importante documentare il proprio codice. Esiste per Vim un plugin scritto da Tobias Schlitt che semplifica l’operazione: phpDocumentator.
Anche qui, l’installazione di questo plugin è a dir poco semplice.
Dopo aver scaricato il pacchetto basta copiare il file php-doc.vim nella directory .vim/plugin presente nella home directory dell’utente.
Fatto questo bisogna aggiungere al proprio .vimrc le seguenti direttive:

inoremap  :call PhpDocSingle()i
nnoremap  :call PhpDocSingle() 
vnoremap  :call PhpDocRange()

Diventa così semplicissimo creare una struttura per commentare le proprie funzioni. Basta posizionarsi col cursore sulla dichiarazione della propria funzione o della classe e fare ctrl + p.