Público, Protegido, Privado

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy. Lição 38 de 91.

Boas-vindas ao capítulo sobre Encapsulamento! O encapsulamento trata de controlar o acesso aos dados internos da sua classe. O PHP fornece três modificadores de acesso que determinam de onde as propriedades e os métodos podem ser acessados: public, protected e private.

Veja como cada modificador funciona:

<?php
class BankAccount {
    public $accountHolder;    // Acessível de qualquer lugar
    protected $accountNumber; // Acessível nesta classe e em classes filhas
    private $balance;         // Acessível apenas nesta classe
    
    public function __construct($holder, $number, $balance) {
        $this->accountHolder = $holder;
        $this->accountNumber = $number;
        $this->balance = $balance;
    }
    
    public function getBalance() {
        return $this->balance;
    }
}

$account = new BankAccount("John", "12345", 1000);

echo $account->accountHolder . "\n";  // Funciona - public
echo $account->getBalance();          // Funciona - método public

Saída:

John
1000

Tentar acessar $account->balance diretamente causaria um erro porque ele é privado. O mesmo se aplica a $account->accountNumber de fora da hierarquia de classes. Essa proteção garante que dados sensíveis só possam ser modificados por meio de métodos controlados.

Modificador	Mesma classe	Classe filha	Fora
`public`	Sim	Sim	Sim
`protected`	Sim	Sim	Não
`private`	Sim	Não	Não

Ponto-chave: Use private para dados internos que não devem ser acessados diretamente, protected para dados que as child classes precisam e public somente para acesso externo seguro.

Desafio

Fácil

Vamos criar um sistema seguro de gerenciamento de funcionários que demonstra como os modificadores de acesso protegem dados confidenciais. Você criará uma hierarquia de classes na qual diferentes níveis de informação ficam acessíveis dependendo de onde o código está sendo executado: dentro da classe, em uma classe filha ou externamente.

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

Employee.php: Crie uma classe Employee que gerencie os dados do funcionário com níveis de visibilidade apropriados. A classe deve ter:
- Uma propriedade public $name para o nome do funcionário (segura para qualquer pessoa visualizar)
- Uma propriedade protected $employeeId para o ID interno (necessária para as classes filhas)
- Uma propriedade private $salary para informações salariais confidenciais (somente esta classe deve acessá-la diretamente)
O construtor deve aceitar os três valores e atribuí-los. Adicione um método público getSalary() que retorne o salário privado. Essa é a maneira controlada de acessar dados protegidos. Adicione também um método público getPublicInfo() que retorne "[name] works here".
Manager.php: Crie uma classe Manager que estenda Employee. Inclua o arquivo Employee. O construtor deve aceitar name, employeeId, salary e um nome de departamento. Chame o construtor pai com os três primeiros valores e, em seguida, armazene o departamento em uma propriedade privada. Adicione um método público getTeamInfo() que retorne "Manager [name] (ID: [employeeId]) leads [department]". Observe como a classe filha pode acessar o $employeeId protegido, mas precisaria de getSalary() para acessar o salário privado.
main.php: Inclua o arquivo Manager. Você receberá quatro entradas: um nome, um ID de funcionário, um salário (como uma string que você converterá para um inteiro) e um nome de departamento. Crie uma instância de Manager com esses valores. Imprima três linhas:
- O nome do gerente acessado diretamente (propriedade pública)
- O resultado da chamada de getTeamInfo()
- O resultado da chamada de getSalary()

Este desafio demonstra o encapsulamento em ação: o nome é livremente acessível, o ID do funcionário é compartilhado com as classes filhas por meio da visibilidade protegida, e o salário permanece protegido na classe pai: acessível somente por meio de um método público controlado.

Experimente você mesmo

<?php
require_once 'Manager.php';

// Ler entradas
$name = trim(fgets(STDIN));
$employeeId = trim(fgets(STDIN));
$salary = intval(trim(fgets(STDIN)));
$department = trim(fgets(STDIN));

// TODO: Criar uma instância de Manager com os valores de entrada

// TODO: Imprimir o nome do manager (acessado diretamente como propriedade pública)

// TODO: Imprimir o resultado da chamada de getTeamInfo()

// TODO: Imprimir o resultado da chamada de getSalary()
?>