PHP Conference Kansai 2025

Modificaciones que causan incompatibilidad ascendente

Excepción al pasar muy pocos argumentos de función

Anteriormente, se emitía una advertencia al invocar funciones definidas por el usuario con muy pocos argumentos. Ahora, esta advertencia se ha promovido a una excepción de error. Esta modificación se aplica únicamente a las funciones definidas por el usuario, y no a las funciones internas. Por ejemplo:

<?php
function test($param){}
test();

El resultado del ejemplo sería algo similar a:

Fatal error: Uncaught ArgumentCountError: Too few arguments to function test(), 0 passed in %s on line %d and exactly 1 expected in %s:%d

Prohibir las llamadas dinámicas a las funciones de introspección de ámbito

Se han prohibido las llamadas dinámicas para ciertas funciones (en forma de $func() o array_map('extract', ...), etc.). Estas funciones inspeccionan o modifican otro ámbito, y presentan un comportamiento ambiguo y no fiable. Las funciones son las siguientes:

<?php
(function () {
$func = 'func_num_args';
$func();
})();

El resultado del ejemplo sería:

Warning: Cannot call func_num_args() dynamically in %s on line %d

Nombre de clase, interfaz y trait inválido

Los siguientes nombres no pueden ser utilizados para nombrar clases, interfaces o traits:

Las conversiones de cadenas numéricas ahora respetan la notación científica

Las operaciones enteras y las conversiones sobre cadenas numéricas ahora respetan la notación científica. Esto incluye también la operación de cast (int) y las siguientes funciones: intval() (donde la base es 10), settype(), decbin(), decoct() y dechex().

Correcciones al algoritmo mt_rand()

mt_rand() ahora utiliza por defecto la versión corregida del algoritmo Mersenne Twister. Si la salida determinista de mt_srand() ha sido invocada, entonces MT_RAND_PHP puede ser utilizado como segundo parámetro opcional de mt_srand() para preservar la antigua (y incorrecta) implementación.

rand() alias de mt_rand() y srand() alias de mt_srand()

rand() y srand() son ahora alias de mt_rand() y mt_srand(), respectivamente. Esto significa que la salida para las siguientes funciones ha sido modificada: rand(), shuffle(), str_shuffle() y array_rand().

Prohibir el carácter de control de eliminación ASCII en los identificadores

El carácter de control de eliminación ASCII (0X7f) no puede ser utilizado en los identificadores que no están entre comillas.

error_log cambio para el valor syslog

Si el parámetro INI error_log está definido en syslog, los niveles de error PHP se mapean a los niveles de error syslog. Esto aporta una diferenciación más fina en los registros de errores en comparación con el enfoque anterior donde todos los errores se registraban con el nivel de aviso únicamente.

No llamar a los destructores en objetos incompletos

Los destructores ya no se llaman para los objetos que lanzan una excepción durante la ejecución de su constructor. En versiones anteriores, este comportamiento dependía de si el objeto era referenciado fuera del constructor (por ejemplo, por una traza de excepción).

call_user_func() manejo de argumentos de referencia

call_user_func() ahora siempre generará una advertencia en las llamadas a funciones que esperan referencias como argumentos. Anteriormente, esto dependía de si la llamada estaba completamente calificada.

Además, call_user_func() y call_user_func_array() ya no abandonarán la llamada de función en este caso. La advertencia "referencia esperada" será emitida, pero la llamada continuará como de costumbre.

El operador de índice vacío ya no es soportado para las cadenas

La aplicación del operador de índice vacío a una cadena (por ejemplo, $str[] = $x) lanza un error fatal en lugar de convertirla silenciosamente en un array.

Asignación vía acceso de índice de cadena en una cadena vacía

La modificación de cadena por carácter en una cadena vacía ahora funciona como para las cadenas no vacías, es decir, escribiendo en un desplazamiento fuera de rango de la cadena con espacios, donde los tipos no enteros se convierten en enteros, y solo el primer carácter de la cadena asignada se utiliza. Anteriormente, las cadenas vacías se trataban silenciosamente como un array vacío.

<?php
$a
= '';
$a[10] = 'foo';
var_dump($a);
?>

Salida del ejemplo anterior en PHP 7.0:

array(1) {
  [10]=>
  string(3) "foo"
}

Salida del ejemplo anterior en PHP 7.1:

string(11) "          f"

Directivas ini eliminadas

Las siguientes directivas ini han sido eliminadas:

  • session.entropy_file
  • session.entropy_length
  • session.hash_function
  • session.hash_bits_per_character

El ordenamiento de los elementos de un array ha cambiado cuando se crean automáticamente durante las asignaciones por referencia

El orden de los elementos en un array ha cambiado cuando estos elementos han sido creados automáticamente al referenciarlos en una asignación por referencia. Por ejemplo:

<?php
$array
= [];
$array["a"] =& $array["b"];
$array["b"] = 1;
var_dump($array);
?>

Salida del ejemplo anterior en PHP 7.0:

array(2) {
  ["a"]=>
  &int(1)
  ["b"]=>
  &int(1)
}

Salida del ejemplo anterior en PHP 7.1:

array(2) {
  ["b"]=>
  &int(1)
  ["a"]=>
  &int(1)
}

Orden de clasificación de elementos iguales

El algoritmo de clasificación interno ha sido mejorado, lo que puede resultar en un orden de clasificación diferente de los elementos que se comparaban como iguales anteriormente.

Nota:

No se debe confiar en el orden de los elementos que se comparan como iguales; podría cambiar en cualquier momento.

Mensaje de error para los errores E_RECOVERABLE

El mensaje de error para los errores E_RECOVERABLE ha sido cambiado de "Catchable fatal error" a "Recoverable fatal error".

Parámetro $options de unserialize()

El elemento allowed_classes del parámetro $options de unserialize() ahora es estrictamente tipado, es decir, si se da un valor distinto de un array o un boolean, unserialize() devuelve false y emite un E_WARNING.

El constructor de DateTime incorpora microsegundos

DateTime y DateTimeImmutable ahora incorporan correctamente los microsegundos cuando se construyen a partir de la hora actual, ya sea explícitamente o con una cadena relativa (por ejemplo, "first day of next month"). Esto significa que las comparaciones ingenuas de dos instancias recién creadas ahora serán más propensas a devolver false en lugar de true:

<?php
new DateTime() == new DateTime();
?>

Conversiones de errores fatales en excepciones Error

En la extensión date, los datos de serialización inválidos para las clases DateTime o DatePeriod, o el fallo de la inicialización de la zona horaria a partir de datos serializados, ahora lanzarán una excepción Error a partir del método __wakeup() o __set_state(), en lugar de traducirse en un error fatal.

En la extensión DBA, las funciones de modificación de datos (como dba_insert()) ahora lanzarán una excepción Error en lugar de desencadenar un error fatal capturable si la clave no contiene exactamente dos elementos.

En la extensión DOM, los contextos de validación de esquema o RelaxNG no válidos ahora lanzarán una excepción Error en lugar de resultar en un error fatal. Asimismo, el intento de registrar una clase de nodo que no extiende la clase base apropiada, o intenta leer una propiedad no válida o escribir en una propiedad de solo lectura, también lanzará una excepción Error.

En la extensión IMAP, las direcciones de correo electrónico más largas que 16385 bytes lanzarán una excepción Error en lugar de traducirse en un error fatal.

En la extensión Intl, no llamar al constructor padre en una clase que extiende Collator antes de llamar a los métodos padres ahora lanzará una Error en lugar de resultar en un error fatal recuperable. Además, la clonación de un objeto Transliterator ahora lanza una excepción Error en caso de fallo de la clonación del Transliterator interno en lugar de un error fatal.

En la extensión LDAP, proporcionar un tipo de modificación desconocido a ldap_batch_modify() ahora lanzará una excepción Error en lugar de un error fatal.

En la extensión mbstring, las funciones mb_ereg() y mb_eregi() ahora lanzarán una excepción ParseError si se proporciona una expresión PHP no válida y se utiliza la opción 'e'.

En la extensión mcrypt, mcrypt_encrypt() y mcrypt_decrypt() ahora lanzarán una excepción Error en lugar de un error fatal si mcrypt no puede ser inicializada.

En la extensión mysqli, el intento de leer una propiedad no válida o de escribir en una propiedad de solo lectura ahora lanza una excepción Error en lugar de traducirse en un error fatal.

En la extensión Reflection, no recuperar un objeto de reflexión o recuperar una propiedad de objeto ahora lanza una excepción Error en lugar de traducirse en un error fatal.

En la extensión de sesión, los gestores de sesión personalizados que no devuelvan cadenas para los ID de sesión ahora lanzarán una excepción Error en lugar de provocar un error fatal cuando se llama a una función para generar un ID de sesión.

En la extensión SimpleXML, la creación de un atributo sin nombre o duplicado ahora lanzará una excepción Error en lugar de generar un error fatal.

En la extensión SPL, un intento de clonar un objeto SplDirectory ahora lanzará una excepción Error en lugar de generar un error fatal. Asimismo, llamar a ArrayIterator::append() durante la iteración sobre un objeto también lanzará una excepción Error.

En la extensión estándar, la función assert(), cuando se proporciona con un argumento de cadena como primer parámetro, ahora lanzará una excepción ParseError en lugar de un error fatal capturable si el código PHP no es válido. Asimismo, la llamada a forward_static_call() fuera de un ámbito de clase ahora lanza una excepción Error.

En la extensión Tidy, la creación manual de un tidyNode lanzará una excepción Error en lugar de un error fatal.

En la extensión WDDX, una referencia circular durante la serialización ahora lanzará una excepción Error en lugar de un error fatal.

En la extensión XML-RPC, una referencia circular durante la serialización ahora lanzará una instancia de excepción Error en lugar de traducirse en un error fatal.

En la extensión Zip, el método ZipArchive::addGlob() ahora lanzará una excepción Error en lugar de traducirse en un error fatal si el soporte de glob no está disponible.

Las variables ligadas léxicamente no pueden reutilizar los nombres

Las variables ligadas a una función anónima vía la construcción use no pueden utilizar el mismo nombre que cualquier superglobals, $this o cualquier parámetro. Por ejemplo, todas estas definiciones de función resultarán en un error fatal:

<?php
$f
= function () use ($_SERVER) {};
$f = function () use ($this) {};
$f = function ($param) use ($param) {};

Cambio de tipo de parámetro de long2ip()

long2ip() ahora espera un int en lugar de string.

Codificación y decodificación JSON

El parámetro INI serialize_precision ahora controla la precisión de serialización al codificar los floats.

La decodificación de una clave vacía ahora resulta en un nombre de propiedad vacío, en lugar de _empty_ como nombre de propiedad.

<?php
var_dump
(json_decode(json_encode(['' => 1])));

El resultado del ejemplo sería algo similar a:

object(stdClass)#1 (1) {
  [""]=>
  int(1)
}

Cuando se proporciona el indicador JSON_UNESCAPED_UNICODE a json_encode(), las secuencias U+2028 y U+2029 ahora se escapan.

Modificaciones de la semántica de los parámetros de mb_ereg() y mb_eregi()

El tercer parámetro de las funciones mb_ereg() y mb_eregi() (regs) ahora se establece en un array vacío si no se ha hecho ninguna coincidencia. Anteriormente, el parámetro no habría sido modificado.

Abandono de los flujos sslv2

El flujo SSLv2 ha sido abandonado en OpenSSL.

Prohibido "return;" para los retornos tipados en tiempo de compilación

Una declaración de retorno sin argumentos en las funciones que declaran un tipo de retorno ahora emite E_COMPILE_ERROR (excepto si el tipo de retorno se declara como void), incluso si la declaración de retorno nunca sería alcanzada.

add a note

User Contributed Notes 5 notes

up
46
love at sickpeople dot se
8 years ago
For anyone migrating from 5.x to 7.1:

About "Array ordering when elements are automatically created during by reference assignments has changed" on this page

(http://php.net/manual/en/migration71.incompatible.php#migration71.incompatible.array-order)

The behaviour of 7.1 is THE SAME as of PHP 5. It is only 7.0 that differs.

See https://3v4l.org/frbUc

<?php

$array
= [];
$array["a"] =& $array["b"];
$array["b"] = 1;
var_dump($array);
up
34
kees at twekaers dot net
8 years ago
The backwards incompatible change 'The empty index operator is not supported for strings anymore' has a lot more implications than just a fatal error on the following code

<?php
$a
= "";
$a[] = "hello world";
var_dump($a);
?>

This will give a fatal error in 7.1 but will work as expected in 7.0 or below and give you: (no notice, no warning)

array(1) {
[0]=>
string(11) "hello world"
}

However, the following is also changed:

<?php
$a
= "";
$a[0] = "hello world";
var_dump($a);
// 7.1: string(1) "h"
// pre-7.1: array(1) { [0]=> string(11) "hello world" }

$a = "";
$a[5] = "hello world";
var_dump($a);
// 7.1: string(6) " h"
// pre-7.1: array(1) { [0]=> string(11) "hello world" }

?>
up
17
m dot r dot sopacua at gmail dot com
8 years ago
"OMFG! Why was session.hash_function removed?!? Dude!"

https://wiki.php.net/rfc/session-id-without-hashing

There. Saved ya a search.
up
2
mikem at gmail dot com
7 years ago
ArgumentCountError - this modification is the main reason to avoid this version on older projects.
up
0
david at artefactual dot com
6 years ago
Regarding the ArgumentCountError, PHP 7.1+ does still support user functions with a variable number of arguments, using the "func(...$args) {}" syntax, see: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
To Top