Web y desarrollo

PHP 8.6: Nuevas Funciones, Funciones Deprecadas y una Guía Práctica de Migración

PHP 8.6: New Features, Deprecated Functions, and a Practical Migration Guide

Actualiza a PHP 8.6 con ejemplos antes y después de funciones PHP deprecadas, MySQLi, mbstring, CSV, sesiones y una lista de verificación práctica de migración.

PHP 8.6.0 se publicó el 19 de noviembre de 2026. Las características principales son interesantes, pero para los desarrolladores que mantienen sitios web reales la pregunta urgente suele ser diferente: ¿qué líneas de código existente comenzarán a emitir avisos de obsolescencia, y cómo deberían reescribirse?

Esta guía prioriza el trabajo de migración. Cada ejemplo identifica una API obsoleta, muestra un reemplazo y destaca dónde una búsqueda y reemplazo mecánico sería peligroso. Un aviso de obsolescencia no es lo mismo que un error fatal inmediato: advierte que el código necesita atención, a menudo antes de que una futura versión importante elimine la API.

Ruta de migración de PHP 8.6: inventario, entorno de pruebas, registros, correcciones y pruebas de regresión

1. Check your runtime before touching production

Run these commands in the same PHP environment that serves the application (CLI and web PHP may use different binaries and settings):

php -v
php -m
php --ini

Check extensions used by the project, especially mbstring, mysqli and intl. Verify that the framework, CMS, extensions and hosting environment explicitly support PHP 8.6; do not infer compatibility merely because a site starts.

Revise las extensiones utilizadas por el proyecto, especialmente mbstring, mysqli y intl. Verifique que el framework, el CMS, las extensiones y el entorno de alojamiento admitan explícitamente PHP 8.6; no infiera compatibilidad solo porque el sitio inicie.

In a staging environment, log all errors while keeping diagnostic messages out of public HTML:

<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');

En un entorno de pruebas, registre todos los errores manteniendo los mensajes de diagnóstico fuera del HTML público:

Estos ajustes de tiempo de ejecución son útiles para una prueba controlada. Prefiera configurar el registro a nivel de servidor para entornos de larga duración; asegúrese de que el registro de errores sea escribible y privado. Un mensaje Deprecated es accionable incluso cuando la página aún se renderiza.

2. Quick reference: deprecated APIs and what to use instead

Obsoleto en PHP 8.6 Enfoque recomendado Advertencia de migración
is_integer(), is_long() is_int() Alias directos
is_double() is_float() Alias directo
doubleval() floatval() Alias directo
spl_object_hash() spl_object_id() El tipo de retorno cambia de string a int
mb_ereg(), mb_eregi() preg_match() Adapte la sintaxis del patrón y las marcas Unicode
mb_ereg_replace() preg_replace() Revise el escape, la semántica de reemplazo y los errores
mysqli_stmt_init() mysqli_prepare() Prepárese de inmediato
mysqli_get_charset() mysqli_character_set_name() Solo si se necesita el nombre del conjunto de caracteres
SplFileObject::fgetcsv() fgetcsv() on a stream Revise la posición de la secuencia y la configuración de CSV
SplFileObject::fputcsv() fputcsv() on a stream Pase el delimitador, el encerramiento y el escape explícitamente
strcoll() Collator::compare() Requiere intl; elija una configuración regional
SORT_LOCALE_STRING Collator::sort() / asort() El comportamiento de la configuración regional puede cambiar
spl_classes() ReflectionExtension::getClassNames() Inspeccione la extensión adecuada
Third argument of define() Omit the argument El antiguo modo que no distingue mayúsculas de minúsculas ha desaparecido
return in finally Return outside finally Evite suprimir excepciones
Object passed to array_walk() get_object_vars() first Las ediciones por referencia podrían dejar de mutar el objeto
metaphone() A maintained phonetic implementation No hay un reemplazo directo del núcleo

Algunas API no tienen un reemplazo exacto. La migración correcta puede requerir cambiar el diseño en lugar de renombrar una función. Consulte la lista oficial de obsolescencias de PHP 8.6.

3. Simple aliases: safe, fast fixes

Antes — obsoleto:

<?php
if (is_integer($quantity) && is_double($price)) {
    $total = doubleval($price) * $quantity;
}

Después:

<?php
if (is_int($quantity) && is_float($price)) {
    $total = floatval($price) * $quantity;
}

Los alias tienen la misma semántica. No asuma que is_float(40) es true: un integer permanece como integer. Ese comportamiento ya estaba presente antes de la migración.

Para un monto de cadena, floatval() es una conversión, no una representación decimal segura para dinero. Mantenga la estrategia existente de manejo de dinero del proyecto en lugar de cambiarla como parte de una actualización de PHP no relacionada.

4. Migrating mbstring regular expressions

La familia mb_ereg* está obsoleta porque su motor de expresiones regulares Oniguruma subyacente ya no se mantiene. PHP recomienda PCRE para muchos casos de uso, pero los dialectos de patrón no son idénticos.

Antes:

<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;

Después (solo dígitos ASCII):

<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;

Aquí, el modificador D hace que $ coincida solo al final del sujeto. Para texto Unicode, use un patrón UTF-8 apropiado y el modificador u:

<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;

Antes — reemplazo:

<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);
Illustration of the article's main concept

Después — reemplazo:

<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
    throw new RuntimeException('Regular expression failed');
}

Los dos patrones pueden diferir en algunos espacios en blanco Unicode. Para migraciones reales, pruebe caracteres con acento, saltos de línea, UTF-8 no válido, grupos de captura y referencias inversas con datos reales del proyecto. No reemplace masivamente cada llamada a mb_ereg sin revisar la expresión.

5. MySQLi: prepare a statement in one step

Antes — obsoleto:

<?php
$stmt = mysqli_stmt_init($mysqli);
mysqli_stmt_prepare($stmt, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Después:

<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Con la API orientada a objetos, use $mysqli->prepare($sql) en lugar de $mysqli->stmt_init() seguido de prepare(). Mantenga su manejo de errores existente y cierre las sentencias apropiadamente.

La API independiente mysqli_get_charset() también está obsoleta. Si solo necesita el nombre del conjunto de caracteres actual:

<?php
$charsetName = mysqli_character_set_name($mysqli);

Esto no es un reemplazo para todos los campos del objeto de información de conjunto de caracteres antiguo. Si el código depende de metadatos de intercalación, inspeccione lo que realmente necesita y consulte al servidor apropiadamente.

6. CSV: replace deprecated SplFileObject CSV methods

Los métodos específicos de CSV en SplFileObject están obsoletos. Para código nuevo y migrado, use las funciones basadas en secuencias fgetcsv() y fputcsv().

Antes:

<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
    $row = $file->fgetcsv();
    // Process row
}

Después:

<?php
$handle = fopen($path, 'rb');
if ($handle === false) {
    throw new RuntimeException('Cannot open CSV file');
}
try {
    while (($row = fgetcsv($handle, 0, ',', '"', '')) !== false) {
        // Process row
    }
} finally {
    fclose($handle);
}

El argumento de escape vacío deshabilita el mecanismo de escape propietario de PHP; pruebe esta opción con el formato que exporta su sistema de origen. Revise líneas en blanco, encabezados, delimitadores, saltos de línea integrados y codificación. Este ejemplo ilustra el cambio de API, no un analizador CSV universal.

Para escritura, use fputcsv($handle, $fields, ',', '"', ''). Preserve el dialecto esperado del archivo original.

7. Identidad de objeto: spl_object_hash() no es un hash de contenido

Antes:

<?php
$key = spl_object_hash($object);

Después:

<?php
$key = spl_object_id($object);

El reemplazo devuelve un integer, no una cadena. Si las claves están serializadas, almacenadas en una base de datos o expuestas a través de una API, revise los consumidores primero. Ninguna de las dos funciones produce un identificador persistente entre solicitudes, y los ID pueden reutilizarse después de que los objetos se destruyan. Para un mapa indexado por identidad de objeto en vivo, considere SplObjectStorage o WeakMap, según los requisitos de ciclo de vida.

8. Un return en finally puede ocultar fallos

Antes — obsoleto y engañoso:

<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        return []; // Overrides the result and hides exceptions
    }
}

Después — preservar la limpieza sin anular el resultado:

Technical workflow illustration
<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        releaseTemporaryResources();
    }
}

Si el código original devolvió intencionalmente un valor alternativo, traslade esa decisión a un bloque catch con manejo explícito. No trague silenciosamente una excepción que debería llegar al llamador.

9. Ordenamiento sensible a la configuración regional y otros cambios menos evidentes

strcoll() y la marca de ordenamiento SORT_LOCALE_STRING están obsoletas. La alternativa recomendada intl es Collator:

<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);

Verifique que intl esté instalado. El ordenamiento consciente de la configuración regional es una regla de negocio: pruebe el orden esperado en lugar de asumir que ICU y una configuración regional global del proceso siempre se comportarán de forma idéntica.

Otros elementos de migración merecen atención explícita:

  • ArrayIterator: se han obsoleto el ordenamiento, las marcas y los métodos de serialización como asort(), ksort(), setFlags() y serialize(). Ordene el arreglo subyacente o use ArrayObject cuando su API sea apropiada; no asuma que un iterador y un contenedor son intercambiables.
  • Manejadores de sesión personalizados: implemente tanto create_sid() como validateId() según lo requieran las interfaces/comportamiento actualizados. PHP 8.6 habilita valores predeterminados de sesión más estrictos; pruebe el inicio de sesión, la rotación de sesión y la persistencia.
  • __debugInfo(): use un tipo de retorno array no nullable; devolver null ya estaba obsoleto.
  • define(): elimine el tercer argumento case_insensitive, incluso cuando sea false.
  • http_build_query() y array_walk(): pasar objetos donde se esperan arreglos está obsoleto. Convierta intencionalmente usando get_object_vars() o construya el arreglo deseado explícitamente.
  • metaphone(): no existe un reemplazo integrado equivalente de PHP. Elija y pruebe un algoritmo fonético mantenido y apropiado para el idioma.
  • Identificadores reservados: nombres como let, is, readonly (función) y namespace (constante de clase) tienen nuevas restricciones de obsolescencia. Cambie el nombre de las declaraciones afectadas con cuidado.
  • Reflexión: revise objetos no válidos pasados a ReflectionProperty::setValue() y argumentos de objeto suministrados al invocar métodos estáticos.

Consulte la guía de migración completa para casos extremos no cubiertos en esta selección práctica.

10. Encuentre llamadas obsoletas en un proyecto existente

Comience con un inventario de solo lectura. En Linux o macOS:

grep -RnE --include='*.php' \
  'is_integer\(|is_long\(|is_double\(|doubleval\(|spl_object_hash\(|mb_ereg\(|mb_ereg_replace\(|mysqli_stmt_init\(|mysqli_get_charset\(' \
  ./src

Reemplace ./src con el directorio real. Esta búsqueda de texto puede coincidir con comentarios o cadenas, y omitirá llamadas dinámicas, alias con espacio de nombres y otras API obsoletas. Es un punto de partida, no un analizador estático completo.

Para una opción multiplataforma, el Buscar en archivos de un editor puede buscar los mismos nombres. No edite directamente archivos de proveedor o del núcleo del CMS: actualice el paquete ascendente o envíe un parche a su mantenedor.

Un flujo de trabajo de migración seguro de PHP 8.6 con entorno de pruebas, revisión de registros y pruebas de regresión

Una secuencia de migración reproducible

  1. Registre la versión actual de PHP y las extensiones habilitadas.
  2. Haga una copia de seguridad de los archivos y la base de datos; prepare una copia de entorno de pruebas.
  3. Ejecute el proyecto bajo PHP 8.6 con el registro de obsolescencia habilitado.
  4. Invente los avisos por archivo y línea, luego agrupe por API.
  5. Corrija el código de primera parte con cambios específicos; actualice las dependencias de terceros por separado.
  6. Vuelva a ejecutar pruebas unitarias/de integración y recorridos de usuario importantes.
  7. Revise formularios, inicio de sesión, sesiones, correo electrónico, pagos, trabajos programados, importación/exportación de CSV y acceso a la base de datos.
  8. Implemente con un plan de reversión; supervise los registros de errores después del lanzamiento.

Joomla y WordPress: que se haya lanzado PHP 8.6 no significa que toda versión de CMS, extensión o complemento lo admita. Confirme la compatibilidad con las versiones exactas en uso y pruebe primero un entorno de pruebas. No use la actualización como motivo para parchear directamente el núcleo o el código del proveedor.

11. ¿Qué hay realmente de nuevo en PHP 8.6?

Además de las obsolescencias, la versión agrega varias características del lenguaje y del tiempo de ejecución:

Característica Uso práctico
Aplicación parcial de funciones Precargue argumentos y obtenga un llamable para los restantes
clamp() Restrinja un valor entre un mínimo y un máximo
\Time\Duration Represente tiempo transcurrido en lugar de una fecha de calendario
SortDirection Exprese dirección ascendente/descendente mediante una enumeración estándar
Io\Poll Admita sondeo de secuencias en bibliotecas de bucle de eventos y E/S
Valores predeterminados para propiedades readonly Simplifique declaraciones de clases inmutables seleccionadas

Un ejemplo pequeño y útil de inmediato es clamp():

<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));

// PHP 8.6
$percentage = clamp($input, 0, 100);

El código es más fácil de leer, pero la prioridad de migración debería seguir siendo la prueba de compatibilidad. Las otras características no son necesarias solo para mantener funcionando una aplicación existente. Consulte el anuncio oficial de lanzamiento.

12. Antes de cambiar la versión de PHP de producción

Trate PHP 8.6 como una actualización controlada, no como un botón para hacer clic en un servidor de producción ocupado. Una lista de verificación de lanzamiento sensata es: CMS y dependencias compatibles; extensiones disponibles; ninguna inundación inesperada de obsolescencias; pruebas aprobadas; comportamiento de base de datos y sesión verificado; copias de seguridad probadas; y un procedimiento de reversión.

Conclusión: PHP 8.6 trae características útiles, pero sus obsolescencias son a menudo donde comienza el trabajo de mantenimiento. Corrija primero los alias sencillos, luego pruebe las migraciones de comportamiento—especialmente expresiones regulares, CSV, sesiones y operaciones sensibles a la configuración regional—con datos reales.

Fuentes oficiales