Propriedades Privadas e Protegidas

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

Até agora, usamos propriedades public que podem ser acessadas de qualquer lugar. Mas, às vezes, você precisa restringir o acesso para proteger seus dados. O PHP fornece dois modificadores de visibilidade adicionais: private e protected.

Uma propriedade private só pode ser acessada de dentro da classe que a define:

<?php
class BankAccount {
    private $balance = 0;
    
    public function deposit($amount) {
        $this->balance += $amount;
    }
    
    public function getBalance() {
        return $this->balance;
    }
}

$account = new BankAccount();
$account->deposit(100);
echo $account->getBalance();

Saída:

Tentar acessar $account->balance diretamente de fora da class causaria um erro. Isso protege o balance contra alterações sem passar pelo method deposit.

Uma propriedade protected funciona de maneira semelhante, mas também pode ser acessada por classes filhas que estendem a classe parent:

<?php
class User {
    protected $email;
    
    public function __construct($email) {
        $this->email = $email;
    }
}

class Admin extends User {
    public function showEmail() {
        return $this->email;
    }
}

$admin = new Admin("admin@example.com");
echo $admin->showEmail();

Saída:

admin@example.com

Ponto principal: Use private quando somente a classe que o define deve acessar a propriedade. Use protected quando as classes filhas também precisarem de acesso. Ambos impedem o acesso externo direto, mantendo o estado interno do seu objeto seguro.

Desafio

Fácil

Vamos criar um sistema seguro de gerenciamento de funcionários que demonstre como proteger dados confidenciais usando propriedades private e protected.

Você criará três arquivos que trabalham juntos para gerenciar informações de funcionários com controle de acesso adequado:

Employee.php: Define uma Employee class que serve como base para todos os funcionários. Ela deve ter uma propriedade protected $name (para que classes filhas possam acessá-la) e uma propriedade private $salary (somente esta class deve modificar diretamente os salários). O constructor accepts um nome e um salário, definindo ambas as propriedades. Adicione um método público getName() que returns o nome, um método público getSalary() que returns o salário e um método público giveRaise($amount) que aumenta o salário pelo valor informado.
Manager.php: Define uma Manager class que extends Employee. Inclua o arquivo Employee no início. Adicione uma propriedade private $department. O constructor deve accepts nome, salário e departamento: call o constructor parent com parent::__construct($name, $salary) e, em seguida, defina o departamento. Crie um método getDetails() que returns "[name] manages [department]" acessando diretamente a propriedade protected $name. Adicione também um método getDepartment() que returns o departamento.
main.php: Inclua os dois arquivos de class. Crie um Manager com o nome "Sarah", salário 75000 e departamento "Engineering". Print os detalhes do manager usando getDetails(). Em seguida, dê ao manager um raise de 5000 e print o novo salário usando getSalary(). Cada saída deve estar em sua própria linha.

Observe como a Manager class pode acessar diretamente a propriedade protected $name, mas deve usar o método getSalary() para acessar o salário private. Isso demonstra a diferença fundamental entre a visibilidade protected e private: protected permite o acesso da class filha, enquanto private mantém os dados realmente ocultos.

Experimente você mesmo

<?php
require_once 'Employee.php';
require_once 'Manager.php';

// TODO: Crie um Manager com nome "Sarah", salário 75000 e departamento "Engineering"

// TODO: Imprima os detalhes do manager usando getDetails()

// TODO: Dê ao manager um aumento de 5000

// TODO: Imprima o novo salário usando getSalary()
?>