Skip to content

[Sync EN] unserialization: allowed_classes option with enums #776

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
leonardolara merged 2 commits into from
Jun 18, 2026
Merged

[Sync EN] unserialization: allowed_classes option with enums #776

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bf28a39
[Sync EN] unserialization: allowed_classes option with enums
lacatoire Jun 9, 2026
1cecd41
Update unserialize.xml to reflect deprecation notice
leonardolara Jun 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 52 additions & 14 deletions language/enumerations.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1eb67bea30f61f7d9cdfd371146911a0ba07bbd2 Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo,ae,ABDALAZARD,leonardolara -->
<?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 8af3521cb43f54c652baaf8dbbcb786b79a5d04e Maintainer: leonardolara Status: ready --><!-- CREDITS: lhsazevedo,ae,ABDALAZARD,leonardolara -->
<chapter xml:id="language.enumerations" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
<title>Enumerações</title>
<sect1 xml:id="language.enumerations.overview">
Expand Down Expand Up @@ -37,6 +37,7 @@
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

enum Naipe
{
case Copas;
Expand All @@ -59,6 +60,7 @@ enum Naipe
<programlisting role="php">
<![CDATA[
<?php

enum Naipe
{
case Copas;
Expand Down Expand Up @@ -105,6 +107,7 @@ pegar_uma_carta('Espadas');
<programlisting role="php">
<![CDATA[
<?php

enum Naipe
{
case Copas;
Expand Down Expand Up @@ -155,6 +158,7 @@ if ($a !== 'Spades') {
<programlisting role="php">
<![CDATA[
<?php

enum Naipe
{
case Copas;
Expand Down Expand Up @@ -193,6 +197,7 @@ print Naipe::Espadas->name;
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

enum Naipe: string
{
case Copas = 'C';
Expand Down Expand Up @@ -235,6 +240,7 @@ enum Naipe: string
<programlisting role="php">
<![CDATA[
<?php

enum Naipe: string
{
case Copas = 'C';
Expand All @@ -258,6 +264,7 @@ print Naipe::Paus->value;
<programlisting role="php">
<![CDATA[
<?php

enum Naipe: string
{
case Copas = 'C';
Expand Down Expand Up @@ -307,6 +314,7 @@ $ref = &$naipe->value;
<programlisting role="php">
<![CDATA[
<?php

enum Naipe: string
{
case Copas = 'C';
Expand Down Expand Up @@ -352,6 +360,7 @@ print $naipe->value . "\n";
<programlisting role="php">
<![CDATA[
<?php

interface Colorido
{
public function cor(): string;
Expand All @@ -367,7 +376,7 @@ enum Naipe implements Colorido
// Cumpre o contrato da interface.
public function cor(): string
{
return match($this) {
return match ($this) {
Naipe::Copas, Naipe::Ouros => 'Vermelho',
Naipe::Paus, Naipe::Espadas => 'Preto',
};
Expand Down Expand Up @@ -405,6 +414,7 @@ print Naipe::Ouros->forma(); // imprime "Retângulo"
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

interface Colorido
{
public function cor(): string;
Expand All @@ -420,7 +430,7 @@ enum Naipe: string implements Colorido
// Cumpre o contrato da interface.
public function cor(): string
{
return match($this) {
return match ($this) {
Naipe::Copas, Naipe::Ouros => 'Vermelho',
Naipe::Paus, Naipe::Espadas => 'Preto',
};
Expand Down Expand Up @@ -453,6 +463,7 @@ enum Naipe: string implements Colorido
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

interface Colorido
{
public function cor(): string;
Expand All @@ -469,7 +480,7 @@ final class Naipe implements UnitEnum, Colorido

public function cor(): string
{
return match($this) {
return match ($this) {
Naipe::Copas, Naipe::Ouros => 'Vermelho',
Naipe::Paus, Naipe::Espadas => 'Preto',
};
Expand Down Expand Up @@ -508,6 +519,7 @@ final class Naipe implements UnitEnum, Colorido
<programlisting role="php">
<![CDATA[
<?php

enum Tamanho
{
case Pequeno;
Expand All @@ -516,7 +528,7 @@ enum Tamanho

public static function deComprimento(int $cm): self
{
return match(true) {
return match (true) {
$cm < 50 => self::Pequeno,
$cm < 100 => self::Medio,
default => self::Grande,
Expand Down Expand Up @@ -550,6 +562,7 @@ var_dump(Tamanho::fromLength(50));
<programlisting role="php">
<![CDATA[
<?php

enum Tamanho
{
case Pequeno;
Expand Down Expand Up @@ -578,14 +591,16 @@ var_dump(Tamanho::Enorme);
<programlisting role="php">
<![CDATA[
<?php

interface Colorido
{
public function cor(): string;
}

trait Retangulo
{
public function forma(): string {
public function forma(): string
{
return "Retângulo";
}
}
Expand All @@ -601,7 +616,7 @@ enum Naipe implements Colorido

public function cor(): string
{
return match($this) {
return match ($this) {
Naipe::Copas, Naipe::Ouros => 'Vermelho',
Naipe::Paus, Naipe::Espadas => 'Preto',
};
Expand Down Expand Up @@ -636,6 +651,7 @@ var_dump($naipe->forma());
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

// Esta é uma definição de enumeração perfeitamente legal.
enum Direcao implements ArrayAccess
{
Expand Down Expand Up @@ -734,6 +750,7 @@ $foo = new Foo();
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

$trevos = new Naipe();
// Erro: Não é possível instanciar a enumeração Naipe

Expand All @@ -757,6 +774,7 @@ $ferraduras = (new ReflectionClass(Naipe::class))->newInstanceWithoutConstructor
<programlisting role="php">
<![CDATA[
<?php

enum Naipe
{
case Copas;
Expand Down Expand Up @@ -796,6 +814,7 @@ var_dump(NaipeApoiado::cases());
<programlisting role="php">
<![CDATA[
<?php

enum Naipe: string
{
case Copas = 'C';
Expand All @@ -816,6 +835,12 @@ print serialize(Naipe::Copas);
Na desserialização, se uma enumeração de um caso não pode ser encontrada para combinar com um valor
serializado, um aviso será emitido e &false; retornado.</para>

<simpara>
A opção <literal>allowed_classes</literal> de
<function>unserialize</function> não afeta
<link linkend="language.enumerations">Enumerações</link>.
</simpara>

<para>
Se uma Enumeração Pura for serializada para JSON, um erro será lançado. Se uma Enumeração Apoiada
for serializada para JSON, ela será representada apenas por seu valor escalar, no
Expand All @@ -831,11 +856,14 @@ print serialize(Naipe::Copas);
<programlisting role="php">
<![CDATA[
<?php
enum Foo {

enum Foo
{
case Bar;
}

enum Baz: int {
enum Baz: int
{
case Beep = 5;
}

Expand Down Expand Up @@ -868,12 +896,14 @@ Baz Enum:int {
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

class A {}
class B extends A {}

function foo(A $a) {}

function bar(B $b) {
function bar(B $b)
{
foo($b);
}
]]>
Expand All @@ -892,7 +922,9 @@ function bar(B $b) {
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php
enum ErrorCode {

enum ErrorCode
{
case SOMETHING_BROKE;
}

Expand All @@ -919,13 +951,16 @@ function quux(ErrorCode $errorCode)
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

// Apenas para o exemplo onde enumerações não são finais.
// Isto *não* funciona no PHP.
enum MoreErrorCode extends ErrorCode {
enum MoreErrorCode extends ErrorCode
{
case PEBKAC;
}

function fot(MoreErrorCode $errorCode) {
function fot(MoreErrorCode $errorCode)
{
quux($errorCode);
}

Expand Down Expand Up @@ -957,6 +992,7 @@ fot(MoreErrorCode::PEBKAC);
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

enum Ordem
{
case Asc;
Expand Down Expand Up @@ -986,6 +1022,7 @@ function consulta($campos, $filtros, Ordem $ordem = Ordem::Asc)
<programlisting role="php">
<![CDATA[
<?php

enum EstadoDeUsuario: string
{
case Pendente = 'P';
Expand All @@ -995,7 +1032,7 @@ enum EstadoDeUsuario: string

public function rotulo(): string
{
return match($this) {
return match ($this) {
self::Pendente => 'Pendente',
self::Ativo => 'Ativo',
self::Suspenso => 'Suspenso',
Expand Down Expand Up @@ -1025,6 +1062,7 @@ var_dump($status->rotulo());
<programlisting role="php">
<![CDATA[
<?php

enum EstadoDeUsuario: string
{
case Pendente = 'P';
Expand Down
12 changes: 11 additions & 1 deletion reference/var/functions/unserialize.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a9e47cecca7d5834de43b7641baf5d86828bb153 Maintainer: leonardolara Status: ready -->
<!-- EN-Revision: 8af3521cb43f54c652baaf8dbbcb786b79a5d04e Maintainer: leonardolara Status: ready -->
<refentry xml:id="function.unserialize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>unserialize</refname>
Expand Down Expand Up @@ -103,6 +103,9 @@
Omitir esta opção é o mesmo que defini-la como &true;: o PHP
tentará instanciar objetos de qualquer classe.
</simpara>
<simpara>
Esta opção não afeta <link linkend="language.enumerations">Enumerações</link>.
</simpara>
</entry>
</row>
<row>
Expand Down Expand Up @@ -172,6 +175,13 @@
de <parameter>options</parameter> não for um <type>array</type> de nomes de classes.
</entry>
</row>
<row>
<entry>8.4.0</entry>
<entry>
Desserializar strings usando a tag maiúscula <literal>"S"</literal>
foi descontinuado; use a tag minúscula <literal>"s"</literal> em vez disso.
</entry>
</row>
<row>
<entry>8.3.0</entry>
<entry>
Expand Down
Loading