Subir archivos a "clases"

2026-09-24 10:07:25 +02:00
parent 467a861873
commit 93ac0e9ec2
2 changed files with 217 additions and 0 deletions
@@ -0,0 +1,102 @@
+<?php
+
+// Definición de la clase Usuario que representará a los usuarios del sistema
+class Usuario {
+    // ATRIBUTOS (Propiedades privadas para proteger los datos de accesos directos externos)
+    private ?int $id_usuario;      // El ID del usuario (puede ser null si aún no se ha guardado en la base de datos)
+    private string $nombre_usuario; // El nombre de usuario en texto
+    private string $contrasena;     // La contraseña (normalmente encriptada)
+    private string $email;          // El correo electrónico del usuario
+    private PDO $db;                // La conexión a la base de datos mediante el objeto PDO
+
+    // CONSTRUCTOR: Se ejecuta automáticamente al crear un nuevo objeto (ej: new Usuario($db, "Juan", ...))
+    public function __construct(PDO $db, string $nombre_usuario = "", string $contrasena = "", string $email = "", ?int $id_usuario = null) {
+        $this->db = $db;                         // Asigna la conexión a la base de datos al atributo interno
+        $this->id_usuario = $id_usuario;         // Asigna el ID (por defecto es null si es un registro nuevo)
+        $this->nombre_usuario = $nombre_usuario; // Asigna el nombre de usuario recibido
+        $this->contrasena = $contrasena;         // Asigna la contraseña recibida
+        $this->email = $email;                   // Asigna el email recibido
+    }
+
+    // --- GETTERS Y SETTERS (Métodos públicos para acceder y modificar los datos privados de forma segura) ---
+
+    // Getter para obtener el ID del usuario (es de solo lectura, no tiene setter)
+    public function getIdUsuario(): ?int { 
+        return $this->id_usuario; 
+    }
+    
+    // Getter para obtener el nombre de usuario
+    public function getNombreUsuario(): string { 
+        return $this->nombre_usuario; 
+    }
+    
+    // Setter para cambiar el nombre de usuario desde fuera de la clase
+    public function setNombreUsuario(string $nombre_usuario): void { 
+        $this->nombre_usuario = $nombre_usuario; 
+    }
+
+    // Getter para obtener la contraseña
+    public function getContrasena(): string { 
+        return $this->contrasena; 
+    }
+    
+    // Setter para cambiar la contraseña desde fuera de la clase
+    public function setContrasena(string $contrasena): void { 
+        $this->contrasena = $contrasena; 
+    }
+
+    // Getter para obtener el correo electrónico
+    public function getEmail(): string { 
+        return $this->email; 
+    }
+    
+    // Setter para cambiar el correo electrónico desde fuera de la clase
+    public function setEmail(string $email): void { 
+        $this->email = $email; 
+    }
+
+    // --- MÉTODOS DE BASE DE DATOS (Lógica de negocio e interacción con SQL) ---
+
+    // Método para registrar/insertar el usuario actual en la base de datos
+    public function registrar(): bool {
+        // Preparamos la consulta SQL usando marcadores (:nombre, :pass, :email) para evitar inyecciones SQL
+        $sql = "INSERT INTO usuario (nombre_usuario, contrasena, email) VALUES (:nombre, :pass, :email)";
+        $stmt = $this->db->prepare($sql); // Prepara la consulta en el servidor de la base de datos
+        
+        // Encriptamos la contraseña con el algoritmo BCRYPT antes de guardarla por seguridad
+        $passHash = password_hash($this->contrasena, PASSWORD_BCRYPT);
+
+        // Ejecutamos la consulta pasando los valores reales que sustituirán a los marcadores
+        $resultado = $stmt->execute([
+            ':nombre' => $this->nombre_usuario,
+            ':pass' => $passHash, // Guardamos la contraseña ya encriptada
+            ':email' => $this->email
+        ]);
+
+        // Si la inserción fue exitosa, recuperamos el ID generado por la base de datos y lo asignamos al objeto
+        if ($resultado) {
+            $this->id_usuario = (int)$this->db->lastInsertId();
+            return true; // Devuelve verdadero indicando que se registró correctamente
+        }
+        return false; // Devuelve falso si hubo algún error en la inserción
+    }
+
+    // Método estático para buscar un usuario por su ID sin necesidad de instanciar el objeto previamente
+    public static function buscarPorId(PDO $db, int $id): ?Usuario {
+        // Preparamos la consulta SQL filtrando por el ID recibido
+        $sql = "SELECT * FROM usuario WHERE id_usuario = :id";
+        $stmt = $db->prepare($sql);
+        $stmt->execute([':id' => $id]); // Ejecutamos la consulta
+        
+        // Obtenemos el registro en forma de array asociativo
+        $datos = $stmt->fetch(PDO::FETCH_ASSOC);
+
+        // Si el usuario existe en la base de datos, creamos y devolvemos un nuevo objeto Usuario con sus datos
+        if ($datos) {
+            return new Usuario($db, $datos['nombre_usuario'], $datos['contrasena'], $datos['email'], $datos['id_usuario']);
+        }
+        return null; // Si no se encuentra el usuario, devolvemos null
+    }
+}
+
+<?php