Acervo.estudos
Trilhas Enviar material Entrar
mapa · Intermediário

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 @julio · rev. 23 set · 4 telas

Uma caixa em volta dos dados

Por que encapsular

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
<?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)
Quem enxerga cada membro

public, protected, private

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
Acesso a partir de…publicprotectedprivate
a própria classesimsimsim
uma classe filhasimsimnão
fora das classessimnãonã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::$saldo
Porta de entrada com validação

Getters e setters

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
<?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 property

Lanç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.)

Teste antes de seguir

Revisão rápida

clique nos círculos para abrir e fechar ramos · arraste para mover · role para dar zoom
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.

← Voltar ao curso