Clean Code en PHP: principios y ejemplos para código limpio

Clean Code en PHP: principios y ejemplos prácticos

El código limpio no es un lujo, sino una necesidad para cualquier desarrollador PHP profesional. Cuando escribes código que es fácil de leer, entender y modificar, ahorras tiempo para ti y para tu equipo. En este artículo analizaremos los principios clave de Clean Code en PHP con ejemplos concretos que puedes aplicar de inmediato en tus proyectos.

¿Por qué es importante el código limpio en proyectos PHP?

PHP es un lenguaje flexible, pero esta flexibilidad a menudo conduce al caos si no se cuida la calidad del código. El código limpio ayuda a:

\n
• Encontrar y corregir errores más rápidamente;
\n
• Añadir nuevas funciones fácilmente sin riesgo de romper la lógica existente;
\n
• Reducir el tiempo de incorporación para nuevos desarrolladores;
\n
• Mejorar la estabilidad general de la aplicación.
\n

Pasemos a principios y ejemplos concretos.

Nombres correctos de variables y funciones

El primer paso hacia el código limpio son los nombres significativos. El nombre debe responder a la pregunta "¿Qué es esto?" o "¿Qué hace?".

Ejemplo incorrecto

<?php\n$a = 86400;\n$b = $a * 7;\n$c = $b * 0.8;

Ejemplo correcto (Clean Code)

<?php\n$secondsPerDay = 86400;\n$weeklySeconds = $secondsPerDay * 7;\n$discountedWeeklySeconds = $weeklySeconds * 0.8;

Principio: Los nombres deben ser descriptivos y no requerir comentarios. Evita abreviaturas (excepto las comúnmente aceptadas, como $i para contadores de bucle).

Ejemplo para funciones

<?php\n// Malo\nfunction calc($a, $b) {\n    return $a + $b * 1.2;\n}\n\n// Bueno\nfunction calculateTotalWithTax(float $price, float $taxRate = 0.2): float {\n    return $price * (1 + $taxRate);\n}

Principio de responsabilidad única (SRP) en clases

Uno de los principios SOLID dice: "Una clase debe tener una sola razón para cambiar". Esto significa que cada clase debe encargarse de una tarea específica.

Violación de SRP

<?php\nclass OrderProcessor {\n    public function process(Order $order) {\n        // Validación del pedido\n        if (empty($order->items)) {\n            throw new Exception("Pedido vacío");\n        }\n        \n        // Guardar en BD\n        $this->saveToDatabase($order);\n        \n        // Enviar email\n        mail($order->email, "Pedido confirmado", "¡Gracias por tu compra!");\n        \n        // Generar factura PDF\n        $this->generateInvoice($order);\n    }\n}

Implementación limpia con SRP

<?php\nclass OrderValidator {\n    public function validate(Order $order): void {\n        if (empty($order->items)) {\n            throw new Exception("Pedido vacío");\n        }\n    }\n}\n\nclass OrderRepository {\n    public function save(Order $order): void {\n        // Lógica de guardado en BD\n    }\n}\n\nclass EmailNotifier {\n    public function sendOrderConfirmation(Order $order): void {\n        mail($order->email, "Pedido confirmado", "¡Gracias por tu compra!");\n    }\n}\n\nclass InvoiceGenerator {\n    public function generate(Order $order): string {\n        // Generación de PDF\n        return "invoice_".$order->id.".pdf";\n    }\n}\n\n// Uso\nclass OrderProcessor {\n    public function __construct(\n        private OrderValidator $validator,\n        private OrderRepository $repository,\n        private EmailNotifier $notifier,\n        private InvoiceGenerator $invoiceGenerator\n    ) {}\n    \n    public function process(Order $order): void {\n        $this->validator->validate($order);\n        $this->repository->save($order);\n        $this->notifier->sendOrderConfirmation($order);\n        $this->invoiceGenerator->generate($order);\n    }\n}

Ahora cada clase se encarga de su área de responsabilidad, lo que simplifica las pruebas y el mantenimiento.

Evitar "números mágicos" y duplicación