2.5 Encapsulamento: modificadores de acesso (public, private, protected)
Encapsulamento em PHP: visibilidade public, protected e private, o que cada uma permite, e getters e setters com validação, tipos e exceções.
Por que encapsular
<?php
class Pessoa
{
public string $nome = '';
public int $idade = 0;
}
$p = new Pessoa();
$p->idade = -5; // aceito: nada impede
echo $p->idade; // Saída: -5 (incoerente)public, protected, private
| Acesso a partir de… | public | protected | private |
|---|---|---|---|
| a própria classe | sim | sim | sim |
| uma classe filha | sim | sim | não |
| fora das classes | sim | não | não |
<?php
class Conta
{
protected float $saldo = 0.0; // filhas podem usar
private string $senha = 'x'; // só Conta usa
}
class Poupanca extends Conta
{
public function aplicarJuros(): void
{
$this->saldo *= 1.005; // ok: protected
// $this->senha; // não: private de Conta
}
}
$c = new Poupanca();
echo $c->saldo; // Error: Cannot access protected property Poupanca::$saldoGetters e setters
<?php
declare(strict_types=1);
class Pessoa
{
private string $nome;
private int $idade;
public function __construct(string $nome, int $idade)
{
$this->setNome($nome);
$this->setIdade($idade);
}
public function getNome(): string { return $this->nome; }
public function getIdade(): int { return $this->idade; }
public function setNome(string $nome): void
{
if (trim($nome) === '') {
throw new InvalidArgumentException('Nome vazio');
}
$this->nome = $nome;
}
public function setIdade(int $idade): void
{
if ($idade < 0 || $idade > 130) {
throw new InvalidArgumentException("Idade inválida: $idade");
}
$this->idade = $idade;
}
}
$p = new Pessoa("Carlos", 25);
echo $p->getNome() . ' ' . $p->getIdade(); // Saída: Carlos 25
$p->setIdade(-5); // InvalidArgumentException: Idade inválida: -5
$p->idade = 30; // Error: Cannot access private propertyLançar exceção deixa quem chamou decidir o que fazer. O echo "Idade inválida!" do original mistura regra com tela e deixa o programa seguir como se nada tivesse acontecido.
⚠ A página original diz que setIdade() "aceita apenas idades dentro de uma faixa lógica (1 a 119)". Como o parâmetro não tem tipo, o teste $novaIdade > 0 && $novaIdade < 120 também aceita 0.5, 119.5 e a string "30". A faixa só fica garantida com int no parâmetro. (Ele ainda recusa 0, a idade de um recém-nascido.)
Revisão rápida
Uma classe filha consegue ler uma propriedade private da classe pai?
Não. Para a filha enxergar, a propriedade precisa ser protected (ou public).
E um código fora das classes, consegue ler uma propriedade protected?
Não: gera Error "Cannot access protected property".
Se o setter encontrar um valor inválido, o que é melhor: dar echo ou lançar exceção?
Lançar exceção. O objeto não fica em estado errado e quem chamou decide como avisar o usuário.
Qual a vantagem de tipar o parâmetro do setter como int?
O PHP já recusa texto e números quebrados; o setter só precisa checar a faixa.