Uso de "namespace" como nombre de constante de clase

Declarar una constante de clase llamada namespace ahora está obsoleto. namespace es una palabra clave semirreservada, y el nombre se reserva para una posible sintaxis futura, como una pseudoconstante ::namespace análoga a ::class. Los métodos y las propiedades estáticas llamados namespace no se ven afectados. Renombre la constante, por ejemplo a NAMESPACE_NAME.

Retornar desde un bloque finally

Utilizar la sentencia return dentro de un bloque finally ahora está obsoleto, y emite un aviso de obsolescencia en tiempo de compilación. Un return de este tipo descarta silenciosamente una excepción lanzada por el bloque try o catch asociado, o sobrescribe el valor que este devuelve, de modo que los fallos desaparecen sin dejar rastro. Mueva el return fuera del bloque finally; el mismo resultado siempre puede expresarse sin él.

<?php
function getConfig(): array
{
    try {
        return loadConfig(); // lanza una excepción si el fichero no existe
    } finally {
        return []; // Obsoleto: la excepción desaparece, el llamador simplemente obtiene []
    }
}

Tipo de retorno nullable para __debugInfo()

Declarar un tipo de retorno ?array para __debugInfo() ahora está obsoleto. Devolver null desde este método ya estaba obsoleto en PHP 8.5, por lo que el tipo de retorno nullable ya no describe un comportamiento válido. Declare array en su lugar.

Retornar valores desde __construct() y __destruct()

Devolver un valor desde __construct() o __destruct() ahora está obsoleto, y emite un aviso de obsolescencia en tiempo de compilación. Estos métodos no pueden declarar un tipo de retorno, y su valor de retorno nunca puede observarse en un uso normal, lo que hacía que devolver un valor resultara, como mínimo, confuso. Utilizar return; sin valor para omitir el resto de la lógica sigue estando permitido, al igual que llamar manualmente a estos métodos.

Por la misma razón, utilizar yield para convertir __construct() o __destruct() en un generador ahora está obsoleto.

Nombrar una función readonly

Declarar una función llamada readonly ahora está obsoleto. readonly es una palabra clave reservada; en PHP 8.1 se añadió una excepción en el analizador léxico únicamente para mantener en funcionamiento una función existente de WordPress con ese nombre, y ninguna otra palabra clave de PHP recibe un tratamiento especial de este tipo. Renombre la función.

Uso de let, is o _ como identificador

Utilizar let o is como nombre de clase, interfaz, trait, enumeración, función o constante (incluso mediante define()) ahora está obsoleto, al igual que utilizar cualquiera de ellos como alias en una llamada a class_alias() o en una declaración use, use function o use const. Los nombres se reservan como palabras clave para posibles funcionalidades futuras: let para el ámbito de bloque e is para la coincidencia de patrones. Renombre los símbolos afectados.

La obsolescencia de _ como nombre de clase en PHP 8.4 se extiende a las constantes: declarar una constante llamada _ con const o define(), y utilizar _ como alias de una clase o de una constante en una declaración use, ahora están obsoletos. Las funciones llamadas _, incluido el alias _() de gettext(), no se ven afectadas.

Tercer argumento de define()

Pasar el argumento case_insensitive a define() ahora está obsoleto. Las constantes insensibles a mayúsculas y minúsculas se eliminaron en PHP 8.0, y desde entonces el argumento se ignora. Pasar explícitamente false ahora emite un aviso de obsolescencia. Pasar true sigue emitiendo una advertencia, cuyo mensaje ahora indica que esto pasará a ser un error en PHP 9.0. Omita el argumento.

is_a() e is_subclass_of() con un string cuando allow_string es false

Llamar a is_a() o is_subclass_of() con un string como primer argumento mientras allow_string es false ahora está obsoleto. En ese caso las funciones siempre devuelven false, incluso cuando la clase ya está cargada, por lo que una llamada de este tipo indica un error. Para evitar activar la carga automática, compruebe primero con class_exists() con la carga automática desactivada, y luego llame a la función con allow_string establecido en true.

metaphone()

La función metaphone() ahora está obsoleta. Implementa el algoritmo Metaphone original de 1990, que se limita a las reglas de pronunciación del inglés y hace tiempo que fue superado por Double Metaphone y Metaphone 3. Los algoritmos fonéticos son específicos de cada idioma y se actualizan con frecuencia, por lo que se atienden mejor con una biblioteca en espacio de usuario; utilice una en su lugar.

Más de 16 filtros en una URL php://filter

Utilizar más de 16 filtros en una URL php://filter sin configurar la opción de contexto de flujo filter.max_filter_count ahora emite un aviso de obsolescencia. Las cadenas de filtros largas no tienen ningún uso legítimo conocido, pero son la base de una clase de ataques que convierten una inclusión de fichero local o una lectura arbitraria de ficheros en ejecución remota de código. Cuando filter.max_filter_count se define explícitamente, superarlo ya es un error: la apertura del flujo falla con una advertencia.

El código que necesite más filtros debería añadirlos con stream_filter_append() o stream_filter_prepend(), que no tienen límite, o bien aumentar el límite mediante la opción de contexto, por ejemplo de forma global con stream_context_set_default().

Pasar objetos a array_walk(), array_walk_recursive() y http_build_query()

Pasar un objeto como argumento array a array_walk() o array_walk_recursive() ahora está obsoleto. Un pequeño número de funciones interpretan silenciosamente un objeto como el array de sus propiedades visibles. Modificar esas propiedades mediante una función de retrollamada por referencia viola la semántica de readonly y puede corromper los casos de enumeración, y array_walk_recursive() de todos modos no desciende a los objetos anidados. Llame primero a get_object_vars() sobre el objeto y pase el array resultante.

Pasar un objeto como argumento data a http_build_query() ahora está obsoleto. Los objetos encontrados como valores dentro de data ahora también emiten un aviso de obsolescencia cuando se interpretan como arrays. Tratar los objetos como arrays ha sido una fuente recurrente de confusión, en particular para los objetos Stringable, que los usuarios esperan que se conviertan en string. Convierta los objetos en arrays con get_object_vars(), de forma recursiva si es necesario, antes de llamar a la función.

is_double(), is_long(), is_integer() y doubleval()

Tras la obsolescencia de los nombres de conversión no canónicos en PHP 8.5, los alias de funciones que llevan esos mismos nombres de tipo anticuados ahora están obsoletos. Se comportan de forma idéntica a sus equivalentes canónicos, que deben utilizarse en su lugar:

• is_double() => is_float()
• is_long() => is_int()
• is_integer() => is_int()
• doubleval() => floatval()

strcoll() y SORT_LOCALE_STRING

La función strcoll() ahora está obsoleta. Compara strings según el ajuste LC_COLLATE de la configuración regional actual, que es un estado global del proceso definido mediante setlocale() y que cualquier biblioteca puede cambiar; no es segura con datos binarios, a diferencia del resto de funciones de comparación de strings, y algunas configuraciones regionales no implementan reglas de ordenación correctas. Utilice en su lugar Collator::compare() de la extensión intl, que es precisa y dispone de reglas de ordenación actualizadas.

La bandera SORT_LOCALE_STRING de las funciones de ordenación ahora está obsoleta por las mismas razones, ya que ordena utilizando strcoll(). Utilice en su lugar uno de los siguientes métodos de la clase Collator:

• Collator::sort()
• Collator::asort()
• Collator::sortWithSortKeys()