Getters e Setters

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

Agora que você entende os modificadores de acesso, como você interage com segurança com propriedades privadas de fora da classe? A resposta são os getters e setters — métodos públicos que fornecem acesso controlado a dados privados.

Um getter recupera o valor de uma propriedade, enquanto um setter o modifica. Este padrão permite adicionar validação ou lógica quando os dados são acessados ou alterados:

<?php
class User {
    private string $email;
    private int $age;
    
    public function getEmail(): string {
        return $this->email;
    }
    
    public function setEmail(string $email): void {
        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
            $this->email = $email;
        }
    }
    
    public function getAge(): int {
        return $this->age;
    }
    
    public function setAge(int $age): void {
        if ($age >= 0 && $age <= 150) {
            $this->age = $age;
        }
    }
}

$user = new User();
$user->setEmail("john@example.com");
$user->setAge(25);

echo $user->getEmail() . "\n";
echo $user->getAge();

Saída:

john@example.com
25

O setter valida o formato do e-mail e garante que a idade seja razoável antes de armazenar os valores. Sem setters, qualquer pessoa poderia atribuir dados inválidos diretamente. Você também pode criar propriedades de apenas leitura fornecendo apenas um getter, ou propriedades de apenas escrita com apenas um setter.

Ponto Chave: Getters e setters oferecem controle sobre como os dados privados são acessados e modificados, permitindo validação, formatação ou qualquer lógica personalizada.

Desafio

Fácil

Vamos construir um sistema de inventário de produtos que utiliza getters e setters para proteger e validar os dados dos produtos. Você criará uma classe Product que garante que os preços sejam sempre positivos e as quantidades em estoque nunca sejam negativas — demonstrando como os setters podem aplicar regras de negócio.

Você organizará seu código em dois arquivos:

Product.php — Crie uma classe Product com três propriedades privadas: $name (string), $price (float) e $stock (inteiro). Implemente getters e setters para cada propriedade com as seguintes regras de validação:
- setName() deve aceitar apenas strings não vazias — se a string estiver vazia após o trim, não atualize a propriedade
- setPrice() deve aceitar apenas valores maiores que 0 — rejeite preços zero ou negativos
- setStock() deve aceitar apenas valores iguais ou maiores que 0 — rejeite quantidades de estoque negativas
Cada getter deve simplesmente retornar o valor da propriedade correspondente. Adicione um método público getInfo() que retorna "[name]: $[price] ([stock] in stock)" com o preço formatado com 2 casas decimais.
main.php — Inclua o arquivo Product. Você receberá quatro entradas: um nome de produto, um preço, uma quantidade em estoque e um novo preço para atualizar. Crie uma instância de Product e use os setters para atribuir o nome inicial, o preço (convertido para float) e o estoque (convertido para inteiro). Imprima o resultado de getInfo(). Em seguida, tente atualizar o preço com o novo valor de preço (convertido para float) e imprima getInfo() novamente. Por fim, tente definir o estoque como -5 (um valor inválido) e imprima getInfo() mais uma vez para confirmar que o estoque não foi alterado.

Seus setters agem como guardiões — eles validam os dados recebidos antes de permitir alterações nas propriedades privadas. Quando dados inválidos são passados (como um estoque negativo), o setter simplesmente os ignora, mantendo intacto o valor válido existente. Este é o poder do encapsulamento: seu objeto mantém sua integridade, independentemente do que o código externo tente fazer.

Folha de consulta

Use getters e setters para fornecer acesso controlado a propriedades privadas. Um getter recupera um valor, enquanto um setter o modifica com validação opcional:

<?php
class User {
    private string $email;
    private int $age;
    
    public function getEmail(): string {
        return $this->email;
    }
    
    public function setEmail(string $email): void {
        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
            $this->email = $email;
        }
    }
    
    public function getAge(): int {
        return $this->age;
    }
    
    public function setAge(int $age): void {
        if ($age >= 0 && $age <= 150) {
            $this->age = $age;
        }
    }
}

$user = new User();
$user->setEmail("john@example.com");
$user->setAge(25);

echo $user->getEmail(); // john@example.com
echo $user->getAge(); // 25

Setters podem validar dados antes de armazená-los. Se a validação falhar, o setter pode ignorar a atualização, mantendo o valor existente intacto. Você pode criar propriedades somente leitura fornecendo apenas um getter, ou propriedades somente escrita com apenas um setter.

Experimente você mesmo

<?php
require_once 'Product.php';

// Ler entradas
$name = trim(fgets(STDIN));
$price = trim(fgets(STDIN));
$stock = trim(fgets(STDIN));
$newPrice = trim(fgets(STDIN));

// TODO: Criar uma nova instância de Product

// TODO: Usar setters para atribuir o nome inicial, preço (como float) e estoque (como inteiro)

// TODO: Imprimir o resultado de getInfo()

// TODO: Atualizar o preço com newPrice (como float) e imprimir getInfo() novamente

// TODO: Tentar definir o estoque como -5 (inválido) e imprimir getInfo() para confirmar que o estoque não foi alterado

?>