Recapitulação - Coleção Personalizada

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

Desafio

Fácil

Vamos construir uma classe Collection que reúna todos os métodos mágicos que você aprendeu neste capítulo. Sua coleção funcionará como um contêiner de dados flexível que parece natural de usar — armazenando itens por chave, verificando se eles existem, encontrando itens dinamicamente e criando cópias independentes.

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

Collection.php — Crie uma classe Collection que armazena itens em um array privado. Sua coleção deve suportar estes métodos mágicos trabalhando juntos:
- __construct() — Aceita um array opcional de itens iniciais (o padrão é um array vazio)
- __get($key) — Retorna o item na chave fornecida, ou null se ele não existir
- __set($key, $value) — Armazena o valor na chave fornecida
- __isset($key) — Retorna se a chave existe na coleção
- __unset($key) — Remove o item na chave fornecida
- __call($method, $args) — Lida com métodos de busca dinâmicos. Quando um método começando com findBy é chamado (como findByRole ou findByStatus), extraia o nome do campo (converta para minúsculas a parte após "findBy"), pesquise em todos os itens e retorne a chave do primeiro item onde esse campo corresponde ao primeiro argumento. Retorne null se nenhuma correspondência for encontrada. Para qualquer outro método, retorne "Unknown method: [method]"
- __toString() — Retorna "Collection([count] items)" onde count é o número de itens
- __clone() — Quando clonado, o array de itens deve ser uma cópia nova (não uma referência ao original)
main.php — Inclua o arquivo Collection. Você receberá três entradas: um nome de chave, um valor de cargo (role) e um cargo de busca. Construa uma coleção de usuários e demonstre todos os métodos mágicos:
- Crie uma nova Collection
- Adicione um usuário com a chave de entrada, armazenando um array com "name" definido como a chave e "role" definido como o valor do cargo de entrada
- Adicione outro usuário com a chave "bob", armazenando ["name" => "Bob", "role" => "editor"]
- Imprima se a chave de entrada existe usando isset() — saída "exists" ou "missing"
- Imprima o resultado da chamada do método dinâmico findByRole() com o cargo de busca como argumento (isso deve retornar a chave do usuário correspondente, ou nada se for null)
- Imprima a coleção usando echo (aciona o __toString)
- Clone a coleção e, em seguida, remova a chave de entrada do clone usando unset
- Imprima se a chave de entrada existe na coleção original — saída "exists" ou "missing" (deve continuar existindo, pois o clone é independente)

Cada saída deve estar em sua própria linha. O buscador dinâmico assume que cada item em sua coleção é um array associativo com campos como "name" e "role".

Experimente você mesmo

<?php

require_once 'Collection.php';

// Ler as entradas
$keyName = trim(fgets(STDIN));
$roleValue = trim(fgets(STDIN));
$searchRole = trim(fgets(STDIN));

// TODO: Criar uma nova Collection

// TODO: Adicionar um usuário com a chave de entrada, armazenando o array com "name" => key e "role" => roleValue

// TODO: Adicionar outro usuário com a chave "bob", armazenando ["name" => "Bob", "role" => "editor"]

// TODO: Imprimir se a chave de entrada existe usando isset() - saída "exists" ou "missing"

// TODO: Imprimir o resultado da chamada de findByRole() com searchRole como argumento

// TODO: Imprimir a coleção usando echo (aciona o __toString)

// TODO: Clonar a coleção e, em seguida, remover a chave de entrada do clone usando unset

// TODO: Imprimir se a chave de entrada existe na coleção ORIGINAL - "exists" ou "missing"

?>