Menu
CoddyTech

__serialize e __unserialize

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

Quando você precisa converter um objeto em uma string para armazenamento ou transmissão, o PHP usa a serialização. Os métodos mágicos __serialize() e __unserialize() dão a você controle sobre exatamente quais dados são salvos e como são restaurados.

O método __serialize() retorna um array de dados a serem serializados, enquanto __unserialize() recebe esse array e reconstrói o objeto:

<?php
class Session {
    public function __construct(
        private string $userId,
        private array $data,
        private int $createdAt
    ) {}
    
    public function __serialize(): array {
        return [
            'userId' => $this->userId,
            'data' => $this->data
        ];
    }
    
    public function __unserialize(array $data): void {
        $this->userId = $data['userId'];
        $this->data = $data['data'];
        $this->createdAt = time();
    }
    
    public function getCreatedAt(): int {
        return $this->createdAt;
    }
}

$session = new Session("user123", ["theme" => "dark"], time());
$serialized = serialize($session);

$restored = unserialize($serialized);
echo "Created at: " . $restored->getCreatedAt();

Observe que createdAt é excluído da serialização e recebe um novo registro de data e hora ao ser desserializado. Isso é útil para excluir dados confidenciais, valores temporários ou recursos que não podem ser serializados, como conexões de banco de dados.

Esses métodos substituíram os métodos mais antigos __sleep() e __wakeup() no PHP 7.4, oferecendo uma abordagem mais clara, na qual você trabalha diretamente com arrays de dados em vez de nomes de propriedades.

challenge icon

Desafio

Fácil

Vamos criar um sistema de cache de perfil de usuário que demonstra como __serialize() e __unserialize() dão a você controle sobre quais dados são salvos e como são restaurados.

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

  • UserProfile.php: Crie uma classe UserProfile que represente o perfil de um usuário com recursos de cache. Use a promoção de propriedades do construtor para definir propriedades privadas para $userId (string), $username (string), $email (string) e $accessToken (string). Adicione uma propriedade privada $cachedAt que armazene quando o perfil foi colocado em cache (defina-a como "not cached" inicialmente no construtor). Sua classe precisa de:
    • __serialize(): Retorna um array contendo apenas userId, username e email. O accessToken é confidencial e nunca deve ser serializado. O registro de data e hora cachedAt será gerado novamente na restauração.
    • __unserialize(): Restaura userId, username e email a partir do array de dados. Define accessToken como "expired" (já que os tokens não devem persistir).
    • getInfo(): Retorna uma string no formato: "[username] ([email]) - Token: [accessToken]"
  • main.php: Inclua o arquivo UserProfile. Você receberá quatro entradas: um ID de usuário, um nome de usuário, um e-mail e um token de acesso. Crie uma instância de UserProfile com esses valores. Imprima três linhas:
    • As informações do perfil original (antes da serialização)
    • Serialize o perfil usando serialize() e, em seguida, desserialize-o usando unserialize() para criar um perfil restaurado. Imprima as informações do perfil restaurado.
    • Imprima "Token preserved: yes" ou "Token preserved: no", dependendo de o token do perfil restaurado corresponder ou não ao original (dica: não deve corresponder, pois os tokens expiram durante a restauração)

Esse padrão é essencial para armazenar dados de usuário em cache com segurança. Você quer armazenar as informações do perfil, mas nunca persistir credenciais confidenciais, como tokens de acesso. Quando o perfil é restaurado do cache, o token é marcado como expirado, forçando o aplicativo a obter um novo.

Experimente você mesmo

<?php

require_once 'UserProfile.php';

// Leia as entradas
$userId = trim(fgets(STDIN));
$username = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$accessToken = trim(fgets(STDIN));

// TODO: Crie uma instância de UserProfile com os valores de entrada

// TODO: Exiba as informações do perfil original (antes da serialização)

// TODO: Serialize o perfil e, em seguida, desserialize-o para criar um perfil restaurado

// TODO: Exiba as informações do perfil restaurado

// TODO: Exiba "Token preserved: yes" ou "Token preserved: no"
// dependendo de o token do perfil restaurado corresponder ao do perfil original

?>
quiz iconTeste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Programação Orientada a Objetos

Pratique por conta própria: Compilador de PHP online