Organización de clases PHP para código limpio y seguro

Clase 8 de 23 • Curso de Fundamentos de PHP

Resumen

Un código organizado, limpio y seguro es esencial para ambientes profesionales en programación PHP. Una estructura adecuada no solo facilita la lectura del código, sino que también protege nuestros datos contra modificaciones indeseadas.

¿Por qué es importante separar las clases en archivos independientes?

Separar clases en archivos independientes contribuye a un diseño ordenado y lógico del código PHP. Cada clase debe residir en su propio archivo, facilitando su mantenimiento.

Nombramos el archivo con la primera letra en mayúscula, por ejemplo, OrdenBasicoClases.php.
Invocamos el archivo hermano mencionando únicamente su nombre.
Así facilitamos la detección de errores y realizamos actualizaciones rápidas.

¿Qué ventajas tiene trabajar de esta manera?

Separamos claramente la lógica (clases) de la ejecución y presentación.
Mejora la legibilidad y organización del proyecto.
Permite actualizaciones y mantenimiento eficiente.

¿Cómo asegurar que las propiedades de clases sean seguras?

Cuando se definen propiedades como públicas, cualquier parte del código podría modificarlas indebidamente. Para garantizar la seguridad de nuestra información:

Definimos propiedades como privadas para evitar manipulaciones externas.
Creamos métodos públicos específicos para obtener esta información (getters).

¿Cómo implementar métodos seguros para acceder a propiedades?

Creamos métodos que solo sirven para obtener datos, no para alterarlos. Ejemplo para obtener el título:

public function dameElTitulo() {
    return $this->titulo;
}

También creamos métodos equivalentes para subtítulo, descripción y etiquetas.

¿En qué consiste una capa adicional de seguridad para modificaciones?

Para evitar adición no deseada de etiquetas o información publicada:

Añadimos métodos específicos para agregar nuevas etiquetas.
Validamos si una etiqueta ya existe, si está vacía o si supera un límite definido:

public function agregaEtiqueta(string $etiqueta): void {
    if (empty($etiqueta) || in_array($etiqueta, $this->etiquetas) || count($this->etiquetas) >= 5) {
        return;
    }
    $this->etiquetas[] = $etiqueta;
}

Esto mantiene limpios nuestros datos y previene errores y redundancias.

¿Cómo beneficia manejar la lógica aislada del resto del código?

Aislar la lógica en métodos y archivos separados resulta fundamental para proyectos en crecimiento.

Permite agregar validaciones específicas sin afectar otras partes del sistema.
Facilita la navegación a través del código, mejorando su mantenimiento.
Garantiza integridad y claridad al momento de hacer cambios futuros.

¿Qué estrategias adicionales utilizas en tus proyectos para asegurar un código limpio y seguro? Deja tu experiencia o solución en los comentarios.

Marina Sonia

student•

🧱 Separar la definición de clases: orden, reutilización y profesionalismo

Modularidad: Cada clase representa una entidad o comportamiento específico. Tenerla en su propio archivo refuerza su independencia conceptual.
Reutilización: Facilita la importación (require_once) desde múltiples scripts sin repetir código.
Mantenibilidad: Cambios a la clase no requieren editar múltiples archivos.
Escalabilidad: En proyectos con muchas clases y colaboradores, esta práctica mejora el flujo de trabajo y la comprensión general.
Depuración simplificada: Si hay errores, identificar la fuente se vuelve más ágil.

📁 Convención recomendada: nombra el archivo como la clase, con mayúscula inicial: Usuario.php, Producto.php, etc.

🧰 ¿Qué son los getters y setters?

Los getters y setters son métodos públicos que permiten acceder o modificar los atributos privados de una clase de manera segura y controlada.

🔸 Getters (obtener un valor)

Un getter devuelve el valor actual de un atributo. Suelen nombrarse con el prefijo get:

public function getNombre(): string {

return $this->nombre;

}

🔹 Setters (modificar un valor)

Un setter permite establecer o actualizar el valor de un atributo. Suelen nombrarse con el prefijo set:

public function setNombre(string $nuevoNombre): void {

$this->nombre = $nuevoNombre;

}

📌 Convención de nombres: getNombre(), setNombre(), getPrecio(), etc., para mantener claridad y consistencia.

✅ ¿Por qué usarlos?

Aplicás validaciones antes de modificar atributos.
Garantizás que los datos internos permanezcan en un estado válido.
Te preparás para que futuras modificaciones no afecten al código externo que ya usa tu clase.

🔒 Encapsulamiento: proteger atributos y controlar el acceso

Encapsular = blindar el interior de la clase. Solo se exponen métodos públicos que permiten interacción segura con sus propiedades internas.

🔑 Ventajas:

Impide accesos directos desde fuera.
Se pueden aplicar validaciones antes de modificar el estado interno.
Permite futuras mejoras sin romper el código existente: por ejemplo, transformar el getter en uno que formatee precios.

🎯 Comportamientos consistentes con atributos actualizados

Los métodos internos acceden a propiedades privadas mediante $this->atributo.

Esto permite mantener la coherencia del objeto, incluso cuando un valor cambia a través de un setter.

🧪 Validaciones y robustez profesional

Un paso más allá: no solo encapsular, sino proteger la integridad de los datos. Esto se logra validando entrada y, opcionalmente, lanzando excepciones:


public function setStock(int $nuevoStock): void {

    if ($nuevoStock < 0) {

        throw new InvalidArgumentException("El stock no puede ser negativo.");

    }

    $this->stock = $nuevoStock;

}

Ulises Rodríguez Candela

student•

Siempre me había dado pereza aprender a usar/implementar clases en cualquier tipo de lenguaje...

Tuve que venir a un curso de PHP a ver lo maravilloso que es el lenguaje y lo importante que son las clases para mantener buenas prácticas, código mantenible fácilmente, y ver que no era para tanto!

Gracias profe, lo amo😳🤣

Aby Leyva

student•


public function UpdatePrice(float $new_price): void
    {
        // rules:
        // If the new price is valid.
        if (!is_numeric($new_price)) {
            return; // or throw an exception
        }
        //The new price not negative.
        if ($new_price < 0) {
            return; // or throw an exception
        }
        // If the new price is the same as the current price, do nothing.
        if ($new_price === $this->price) {
            return; // No change needed
        }
        
        $this->price = $new_price;
    }


$course->UpdatePrice(9.99); // Update the price to $9.99

Edwin Alexander Aguilar Angulo

student•

Dave Juanes

student•

gracias

Juan David Gutierrez Castaño

student•

Aqui mi solucion del reto:

David Antonio Martinez Mendoza

student•

Excelente explicacion

Fernando Javier de Jesus Arias Urbano

student•

este curso es oro puro desbloquee la mente

Ulises Rodríguez Candela

student•

Reto Terminado:

Jerson Cañon

student•

Jonathan Mendoza

student•

¿Qué versión de PHP estan usando?

Jesus Manuel Lopez Suarez

student•

debe ser 8 o mayor para que funcione.

Marina Sonia

student•

//Cambiar atributo nombre de Author.php
 // Setter para el nombre
    public function setNombre(string $nuevoNombre): void {
        $this->nombre = $nuevoNombre;
    }


//Uso del setter en el archivo principal
<?php
require_once 'Author.php';


// Crear autores del género horror
$king = new Author(
    genero: "Horror",
    nombre: "Stephen King",
    fechaNacimiento: "1947-09-21",
    peliculas: ["Carrie", "El resplandor", "Misery", "It"]
);

// Cambiar el nombre usando el setter
$king->setNombre("Esteban Rey");

$carpenter = new Author(
    genero: "Horror",
    nombre: "John Carpenter",
    fechaNacimiento: "1945-01-16",
    peliculas: ["Halloween", "The Fog", "Escape from New York", "Big Trouble in Little China"]
);
$carpenter->setNombre("Juan Carpintero");

?>

Yorgen Omar Marciales Parada

student•

Para proteger tus datos públicos, es esencial seguir buenas prácticas de programación y seguridad. En el contexto de PHP, asegúrate de que las propiedades de tus clases sean privadas, lo que evita modificaciones no deseadas desde el exterior. Implementa métodos que controlen el acceso a estos datos, como getters y setters, garantizando que la información sensible no sea expuesta. Además, verifica siempre la validación de datos ingresados por los usuarios para prevenir inyecciones de código y otras vulnerabilidades. Mantener tu código limpio y organizado también contribuye a la seguridad general de tus aplicaciones.

Beder Danilo Casa Condori

student•

Emmanuel Garcia Roldan

student•

 public function agregaCurso(string $cursos): void{
       
        if(strlen($cursos)>=10){
return;
        }
         $this->cursos []=$cursos;
    }

           
``` public function agregaCurso(string $cursos): void{               if(strlen($cursos)>=10){return;        }         $this->cursos \[]=$cursos;    }

public function setStock(int $nuevoStock): void {

    if ($nuevoStock < 0) {

        throw new InvalidArgumentException("El stock no puede ser negativo.");

    }

    $this->stock = $nuevoStock;

}

public function UpdatePrice(float $new_price): void
    {
        // rules:
        // If the new price is valid.
        if (!is_numeric($new_price)) {
            return; // or throw an exception
        }
        //The new price not negative.
        if ($new_price < 0) {
            return; // or throw an exception
        }
        // If the new price is the same as the current price, do nothing.
        if ($new_price === $this->price) {
            return; // No change needed
        }
        
        $this->price = $new_price;
    }

//Cambiar atributo nombre de Author.php
 // Setter para el nombre
    public function setNombre(string $nuevoNombre): void {
        $this->nombre = $nuevoNombre;
    }


//Uso del setter en el archivo principal
<?php
require_once 'Author.php';


// Crear autores del género horror
$king = new Author(
    genero: "Horror",
    nombre: "Stephen King",
    fechaNacimiento: "1947-09-21",
    peliculas: ["Carrie", "El resplandor", "Misery", "It"]
);

// Cambiar el nombre usando el setter
$king->setNombre("Esteban Rey");

$carpenter = new Author(
    genero: "Horror",
    nombre: "John Carpenter",
    fechaNacimiento: "1945-01-16",
    peliculas: ["Halloween", "The Fog", "Escape from New York", "Big Trouble in Little China"]
);
$carpenter->setNombre("Juan Carpintero");

?>

 public function agregaCurso(string $cursos): void{
       
        if(strlen($cursos)>=10){
return;
        }
         $this->cursos []=$cursos;
    }

           
``` public function agregaCurso(string $cursos): void{               if(strlen($cursos)>=10){return;        }         $this->cursos \[]=$cursos;    }

Organización de clases PHP para código limpio y seguro

Fundamentos de Programación

Por qué PHP sigue siendo relevante en el desarrollo web actual

Creación y uso de variables en PHP

Condicionales en PHP para mostrar información dinámica

Arreglos en PHP: almacenar múltiples valores en una sola variable

Ciclo forEach en PHP para recorrer arreglos automáticamente

Arreglos asociativos en PHP para organizar datos

Creación de clases y objetos en PHP

Organización de clases PHP para código limpio y seguro

Métodos mágicos en PHP para acceso dinámico a propiedades

Fundamentos profesionales

Estructura profesional de archivos en proyectos PHP

Autocarga de clases en PHP con Composer

Proyecto CLI

Creación de un bot interactivo en PHP desde terminal

Creación de clases de servicio para organizar lógica en PHP

Instalación de Olama para inteligencia artificial local

Integración de Olama con PHP usando Composer

Configuración de API Key de OpenAI en PHP

Configuración de variables de entorno en PHP con dotenv

Organización de proyectos PHP con archivo Bootstrap

Diseño de prompts para asistentes especializados en PHP

Inyección de dependencias para código limpio en PHP

Interfaces en PHP para reducir acoplamiento entre clases

Refactorización de código para mejor legibilidad y mantenimiento

Adaptación de código PHP de terminal a navegador web