Resumen - Sistema de registros de estudiantes

Parte de la sección Programación Orientada a Objetos del Journey de PHP de Coddy — lección 43 de 91.

Desafío

Fácil

Vamos a construir un Sistema de Registros de Estudiantes que reúna todos los conceptos de encapsulación que has aprendido en este capítulo. Crearás un sistema bien organizado que gestione los datos de los estudiantes de forma segura, utilizando la promoción de constructores, propiedades privadas, getters y setters con validación, y la ocultación de información.

Organizarás tu código en tres archivos:

Student.php — Crea una clase Student utilizando la promoción de constructores para un $name (string) privado y un $studentId (string) privado. También incluye una propiedad de array $grades privada (inicializada como vacía). Tu estudiante debe tener:
- getName() — devuelve el nombre del estudiante
- getStudentId() — devuelve el ID del estudiante
- addGrade(int $grade) — añade una calificación solo si está entre 0 y 100 (inclusive)
- getAverage() — devuelve el promedio de todas las calificaciones como un float (devuelve 0.0 si no existen calificaciones)
- getGradeCount() — devuelve el número de calificaciones registradas
Classroom.php — Crea una clase Classroom que gestione una colección de estudiantes. Utiliza un array privado para almacenar a los estudiantes. Incluye el archivo Student. Tu aula debe tener:
- Un constructor que acepte un $roomName (string) privado utilizando la promoción de constructores
- addStudent(Student $student) — añade un estudiante al aula
- getStudentCount() — devuelve el número de estudiantes inscritos
- getClassAverage() — calcula el promedio de los promedios de todos los estudiantes (devuelve 0.0 si no hay estudiantes o no hay calificaciones)
- getRoomName() — devuelve el nombre del aula
main.php — Incluye el archivo Classroom. Recibirás cinco entradas: un nombre de aula, un nombre de estudiante, un ID de estudiante y dos valores de calificación. Crea un Classroom con el nombre del aula. Crea un Student con el nombre e ID, añade ambas calificaciones (convertidas a enteros), luego añade al estudiante al aula. Imprime cuatro líneas:
- El nombre del aula
- El nombre del estudiante seguido de su promedio formateado a 1 decimal: "[name]: [average]"
- El número de calificaciones de ese estudiante
- El promedio de la clase formateado a 1 decimal

Este sistema demuestra una encapsulación adecuada: las calificaciones están protegidas de la manipulación directa, los promedios se calculan internamente sin exponer los datos brutos y todos los datos fluyen a través de métodos controlados. El aula no necesita saber cómo calculan los estudiantes sus promedios; simplemente solicita el resultado.

Pruébalo tú mismo

<?php

require_once 'Classroom.php';

// Leer entradas
$roomName = trim(fgets(STDIN));
$studentName = trim(fgets(STDIN));
$studentId = trim(fgets(STDIN));
$grade1 = intval(trim(fgets(STDIN)));
$grade2 = intval(trim(fgets(STDIN)));

// TODO: Crear un Classroom con el nombre de la sala

// TODO: Crear un Student con el nombre y el ID

// TODO: Agregar ambas calificaciones al estudiante

// TODO: Agregar al estudiante al aula

// TODO: Imprimir el nombre de la sala

// TODO: Imprimir el nombre del estudiante seguido de su promedio formateado a 1 decimal: "[nombre]: [promedio]"

// TODO: Imprimir el número de calificaciones de ese estudiante

// TODO: Imprimir el promedio de la clase formateado a 1 decimal

?>