PSR (PHP Standards Recommendation) es un conjunto de estándares que buscan mejorar la interoperabilidad y cohesión del código PHP. Estos estándares son desarrollados y mantenidos por el PHP-FIG (PHP Framework Interoperability Group), una comunidad que incluye a muchos de los principales desarrolladores de frameworks y bibliotecas PHP. La misión principal de PSR es proporcionar pautas y normas comunes que los desarrolladores pueden seguir para asegurar que las diferentes piezas de software puedan trabajar juntas de manera más efectiva.
Uno de los primeros y más conocidos estándares es PSR-1, que trata sobre las Reglas Básicas de Codificación. Este estándar establece reglas simples pero fundamentales, como las siguientes:
1. Uso de etiquetas de apertura “: Para mayor compatibilidad, se recomienda evitar etiquetas de apertura cortas y otros estilos de etiquetas de apertura menos comunes.
2. Codificación de archivos: Todos los archivos PHP deben utilizar exclusivamente UTF-8 sin BOM (Byte Order Mark).
3. Nombres de clases y archivos: Las clases deben seguir el estándar de Autoload PSR-0, lo que facilita el cargado automático de clases.
A continuación se presenta un ejemplo de convenciones de nombres según PSR-1:
```php
// Incorrecto
class miClaseBase { }
// Correcto
class MiClaseBase { }
```
PSR-2, conocido como Guía de Estilo de Código, amplía las reglas de PSR-1 y proporciona una guía más detallada sobre el formato del código:
1. Indentación: El código debe ser indentado con 4 espacios, no tabulaciones.
2. Longitud de línea: Las líneas no deben tener más de 120 caracteres.
3. Llaves: Las llaves deben colocarse en la siguiente línea para las clases y métodos, pero en la misma línea para las estructuras de control.
Ejemplo de formato según PSR-2:
```php
// Incorrecto
if(condicion) {
// hacer algo
}
// Correcto
if (condicion)
{
// hacer algo
}
```
PSR-4 trata sobre Autoloading de Clases, proporcionando una especificación para cargar clases automáticamente utilizando espacios de nombres (namespaces). Este estándar ha sido ampliamente adoptado debido a su simplicidad y eficiencia.
Ejemplo sencillo de estructura de archivos para PSR-4:
```plain
src/
└── Foo/
├── Bar.php # Contiene la clase Foo\Bar
└── Baz.php # Contiene la clase Foo\Baz
```
El archivo `Bar.php` podría verse así:
```php
namespace Foo;
class Bar {
// contenido de la clase
}
```
En resumen, PSR juega un papel crítico en la estandarización del desarrollo en PHP. El seguir estas recomendaciones no solo facilita la colaboración entre desarrolladores, sino que también asegura que el código sea limpio, legible y fácil de mantener.
