Cosa sono le PSR-1: le Basic Coding Standard

PSR-1, o Basic Coding Standard, è un set di linee guida stabilite dal PHP Framework Interoperability Group (PHP-FIG).

Le PSR-1 sono state pensate e formalizzate per garantire un elevato livello di interoperabilità tecnica tra codice PHP condiviso.

Il Basic Coding Standard è specificato con punti chiave che specificano modalità standard di scrittura del codice.

5 minuti

Se sei uno sviluppatore, se scrivi codice in linguaggio PHP, o se vuoi imparare a scriverlo, è fondamentale che tu impari anche le “PHP Standard Recommendation“. PSR sono le linee guida su come standardizzare la stesura del codice PHP in modo da rendere più facilmente condivisibile il codice nella comunità di programmatori in linguaggio PHP.

L'importanza di conoscere le basi

Prima che venissero scritte e diffuse le raccomandazioni PSR, non esisteva una modalità condivisa per scrivere codice programma, ognuno usava le proprie convenzioni e il proprio stile. Molte aziende, o gruppi di lavoro, si inventarono degli standard propri, linee guida per la scrittura di codice caratteristiche di una specifica azienda o gruppo di lavoro.

FIG. Framework Interoperability Group

Le raccomandazioni PSR sono state scritte dal FIG, che sta per Framework Interoperability Group. In precedenza si chiamava "PHP Standards Group". Il FIG è nato in occasione del PHP 2009, incontro in cui emerse fortemente l'esigenza di creare uno standard condiviso di scrittura codice programma.

I membri del FIG sono rappresentanti di diversi framework PHP, piattaforme di Content Management System, sviluppatori di package, tool, ecc… FIG nasce anche dall'esigenza di avere un gruppo eterogeneo che rappresenti l’intera comunità PHP e non solo un gruppo ristretto di sviluppatori.

L’obiettivo fondante del gruppo è quello di definire degli standard di scrittura, in riferimento a un elenco definito di aspetti della programmazione PHP, come gli autoload, lo stile di scrittura, la definizione di interfacce, ecc…

In questo articolo vedremo le linee guida degli standard necessari per garantire un elevato livello di interoperabilità del codice PHP condiviso tra sviluppatori, cioè le PSR-1

File
Tag PHP

Per la scrittura di codice PHP, i file devono contenere tag lunghi, come , o tag abbreviati/corti . Non devono essere utilizzati altre varianti di tag. Ciò vuol dire che il codice PHP che viene scritto in un file, deve essere evidenziato da tag di apertura codice come , o ?>.

Codifica dei caratteri

Il codice programma PHP deve essere scritto utilizzando solo codifica UTF-8, senza BOM.

Effetti collaterali

Un file contenente codice PHP, deve:

- dichiarare nuovi simboli (classi, funzioni, costanti, ecc.) e non causare altri effetti collaterali;
- oppure eseguire la logica con effetti collaterali;

ma non deve fare entrambe le cose.

Con l'espressione "effetti collaterali" si intende l'esecuzione di logica programma non direttamente correlata alla dichiarazione di classi, funzioni, costanti, ecc., semplicemente includendo il file.

"Effetti collaterali" includono, ma non sono limitati a: generazione di output, uso esplicito di require o include, connessione a servizi esterni, modifica delle impostazioni ini, emissione di errori o eccezioni, modifica di variabili globali o statiche, lettura da o scrittura su un file e così via.

Nell'esempio qui sotto, sono riportate delle dichiarazioni che possono portare conseguenze non desiderate, cioè potrebbero causare errori o comportamenti inaspettati. Sono quindi esempi da evitare:

Ercole Palmeri
#PHPTutorial #SoftwareEngineering #tutorialdilaravelPHP https://bloginnovazione.it/psr-1/52723/