Recapitulação - Sistema de Registro de Alunos

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy — lição 43 de 91.

Desafio

Fácil

Vamos construir um Sistema de Registro de Estudantes que reúna todos os conceitos de encapsulamento que você aprendeu neste capítulo. Você criará um sistema bem organizado que gerencia os dados dos alunos de forma segura, usando promoção de construtor, propriedades privadas, getters e setters com validação e ocultação de informações.

Você organizará seu código em três arquivos:

Student.php — Crie uma classe Student usando promoção de construtor para um $name (string) privado e um $studentId (string) privado. Também inclua uma propriedade privada $grades do tipo array (inicializada como vazia). Seu estudante deve ter:
- getName() — retorna o nome do estudante
- getStudentId() — retorna o ID do estudante
- addGrade(int $grade) — adiciona uma nota apenas se ela estiver entre 0 e 100 (inclusive)
- getAverage() — retorna a média de todas as notas como um float (retorna 0.0 se não existirem notas)
- getGradeCount() — retorna o número de notas registradas
Classroom.php — Crie uma classe Classroom que gerencia uma coleção de estudantes. Use um array privado para armazenar os estudantes. Inclua o arquivo Student. Sua sala de aula deve ter:
- Um construtor que aceita um $roomName (string) privado usando promoção de construtor
- addStudent(Student $student) — adiciona um estudante à sala de aula
- getStudentCount() — retorna o número de estudantes matriculados
- getClassAverage() — calcula a média das médias de todos os estudantes (retorna 0.0 se não houver estudantes ou notas)
- getRoomName() — retorna o nome da sala de aula
main.php — Inclua o arquivo Classroom. Você receberá cinco entradas: um nome de sala, um nome de estudante, um ID de estudante e dois valores de nota. Crie um Classroom com o nome da sala. Crie um Student com o nome e ID, adicione ambas as notas (convertidas para inteiros) e, em seguida, adicione o estudante à sala de aula. Imprima quatro linhas:
- O nome da sala
- O nome do estudante seguido por sua média formatada com 1 casa decimal: "[name]: [average]"
- O número de notas desse estudante
- A média da classe formatada com 1 casa decimal

Este sistema demonstra o encapsulamento adequado: as notas são protegidas contra manipulação direta, as médias são calculadas internamente sem expor os dados brutos e todos os dados fluem através de métodos controlados. A sala de aula não precisa saber como os estudantes calculam suas médias — ela apenas solicita o resultado.

Experimente você mesmo

<?php

require_once 'Classroom.php';

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

// TODO: Criar uma Classroom com o nome da sala

// TODO: Criar um Student com o nome e ID

// TODO: Adicionar ambas as notas ao estudante

// TODO: Adicionar o estudante à sala de aula

// TODO: Imprimir o nome da sala

// TODO: Imprimir o nome do estudante seguido por sua média formatada com 1 casa decimal: "[name]: [average]"

// TODO: Imprimir o número de notas desse estudante

// TODO: Imprimir a média da classe formatada com 1 casa decimal

?>