From 47a40031db77f125c4e848103b32c640d188f6ce Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 19 Aug 2026 22:49:18 +0200 Subject: [PATCH 1/2] [Sync EN] Fix grammar in language/predefined (#5755) --- language/predefined/arrayaccess.xml | 6 +++--- language/predefined/iterator.xml | 6 +++--- language/predefined/serializable.xml | 22 ++++++++++++---------- language/predefined/stdclass.xml | 16 ++++++++-------- language/predefined/traversable.xml | 8 ++++---- language/predefined/valueerror.xml | 6 +++--- language/predefined/weakmap.xml | 8 ++++---- language/predefined/weakreference.xml | 8 ++++---- 8 files changed, 41 insertions(+), 39 deletions(-) diff --git a/language/predefined/arrayaccess.xml b/language/predefined/arrayaccess.xml index 20fac9d76f..e384ef1227 100644 --- a/language/predefined/arrayaccess.xml +++ b/language/predefined/arrayaccess.xml @@ -1,5 +1,5 @@ - + @@ -11,9 +11,9 @@
&reftitle.intro; - + Interfaz que permite acceder a los objetos de la misma manera que a los arrays. - +
diff --git a/language/predefined/iterator.xml b/language/predefined/iterator.xml index 72e22e377e..08e25f51c3 100644 --- a/language/predefined/iterator.xml +++ b/language/predefined/iterator.xml @@ -1,5 +1,5 @@ - + @@ -43,10 +43,10 @@
Iteradores Predefinidos - + PHP ya ofrece un número de iteradores para muchas de las tareas del día a día. Véase la lista de iteradores SPL. - +
diff --git a/language/predefined/serializable.xml b/language/predefined/serializable.xml index 3518085271..36ac6f4aed 100644 --- a/language/predefined/serializable.xml +++ b/language/predefined/serializable.xml @@ -1,5 +1,5 @@ - + @@ -15,18 +15,20 @@ Interfaz que permite personalizar la serialización. - + Las clases que implementan esta interfaz ya no soportan __sleep() y __wakeup(). - El método de serialización es llamado cada vez que una - instancia debe ser serializada. No llama al método - __destruct() y no tiene ningún efecto sobre el contenido de este método. - Cuando los datos son serializados, la clase es conocida y - el método unserialize() apropiado es llamado como constructor - en lugar de llamar a __construct(). Si es necesario llamar al constructor - estándar, se puede hacer en el método. - + El método serialize es llamado cada vez que una + instancia debe ser serializada. + Esto no invoca a __destruct ni tiene ningún otro + efecto secundario, salvo que se programe dentro del método. + Cuando los datos son deserializados, la clase es conocida y + el método unserialize apropiado es llamado como + constructor en lugar de llamar a __construct. + El constructor puede ser llamado desde el método + unserialize si se desea. + diff --git a/language/predefined/stdclass.xml b/language/predefined/stdclass.xml index b151520740..580b07895d 100644 --- a/language/predefined/stdclass.xml +++ b/language/predefined/stdclass.xml @@ -1,5 +1,5 @@ - + @@ -14,14 +14,14 @@ Una clase genérica vacía con propiedades dinámicas. - - Los objetos de esta clase pueden ser instanciados con - new operador o creados por + + Los objetos de esta clase pueden ser instanciados con el operador + new o creados por conversión a objeto. Varias funciones de PHP también crean instancias de esta clase, por ejemplo json_decode, mysqli_fetch_object o PDOStatement::fetchObject. - + A pesar de no implementar @@ -30,12 +30,12 @@ #[\AllowDynamicProperties] atributo. - + Esto no es una clase base ya que PHP no tiene el concepto de una clase base universal. - Sin embargo, es posible crear una clase personalizada que extienda de + Sin embargo, es posible crear una clase personalizada que extienda stdClass y como resultado herede la funcionalidad de propiedades dinámicas. - +
diff --git a/language/predefined/traversable.xml b/language/predefined/traversable.xml index 699f261516..f5d9aa294a 100644 --- a/language/predefined/traversable.xml +++ b/language/predefined/traversable.xml @@ -1,5 +1,5 @@ - + @@ -33,10 +33,10 @@ - - Esta interfaz no tiene métodos, su único propósito es ser la base + + Esta interfaz no tiene métodos; su único propósito es ser la base para todas las clases atravesables. - +
diff --git a/language/predefined/valueerror.xml b/language/predefined/valueerror.xml index fab0729f8c..96cd02f3ee 100644 --- a/language/predefined/valueerror.xml +++ b/language/predefined/valueerror.xml @@ -1,6 +1,6 @@ - + ValueError @@ -11,12 +11,12 @@
&reftitle.intro; - + Una ValueError se lanza cuando el tipo de un argumento es correcto pero su valor es incorrecto. Por ejemplo, si se pasa un entero negativo cuando la función espera un entero positivo, o si se pasa una cadena o un array vacío cuando la función espera que no esté vacío. - +
diff --git a/language/predefined/weakmap.xml b/language/predefined/weakmap.xml index cd02bfd6b0..ecb771ae9d 100644 --- a/language/predefined/weakmap.xml +++ b/language/predefined/weakmap.xml @@ -1,6 +1,6 @@ - + @@ -12,14 +12,14 @@
&reftitle.intro; - + Un WeakMap es un array asociativo (o diccionario) que acepta objetos como claves. Sin embargo, a diferencia del similar SplObjectStorage, un objeto en una clave de WeakMap no contribuye al número de referencias del objeto. En otras palabras, si, en un momento dado, la única referencia restante a un objeto es la clave de un WeakMap, el objeto será recolectado y eliminado del WeakMap. Su principal caso de uso es la construcción de cachés de datos derivados de un objeto que no necesitan ser conservados más tiempo que el objeto. - + WeakMap implementa ArrayAccess, Traversable (vía IteratorAggregate), @@ -64,7 +64,7 @@ &reftitle.examples; - Ejemplo de uso de un <classname>Weakmap</classname> + Ejemplo de uso de un <classname>WeakMap</classname> - + @@ -11,15 +11,15 @@
&reftitle.intro; - + Las referencias débiles permiten al programador mantener una referencia a un objeto sin impedir su destrucción. - Son útiles para implementar estructuras como cachés. + Son útiles para implementar estructuras de tipo caché. Si el objeto original ha sido destruido, &null; será devuelto al llamar al método WeakReference::get. El objeto original será destruido cuando el contador de referencias llegue a cero; la creación de referencias débiles no incrementa el contador de referencias del objeto referenciado. - + Las WeakReferences no pueden ser serializadas. From 504566f7486854ea6974613c386b3d781d536b93 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 19 Aug 2026 22:55:55 +0200 Subject: [PATCH 2/2] Align xi:include with doc-en and sync traversable.xml with php/doc-en#5773 --- language/predefined/arrayaccess.xml | 4 +--- language/predefined/iterator.xml | 4 +--- language/predefined/serializable.xml | 4 +--- language/predefined/traversable.xml | 21 +++++++++++---------- language/predefined/valueerror.xml | 12 +++--------- language/predefined/weakmap.xml | 4 +--- language/predefined/weakreference.xml | 8 ++------ 7 files changed, 20 insertions(+), 37 deletions(-) diff --git a/language/predefined/arrayaccess.xml b/language/predefined/arrayaccess.xml index e384ef1227..9b101c82bc 100644 --- a/language/predefined/arrayaccess.xml +++ b/language/predefined/arrayaccess.xml @@ -27,9 +27,7 @@ &Methods; - - - + diff --git a/language/predefined/iterator.xml b/language/predefined/iterator.xml index 08e25f51c3..ec520a4c35 100644 --- a/language/predefined/iterator.xml +++ b/language/predefined/iterator.xml @@ -33,9 +33,7 @@ &Methods; - - - + diff --git a/language/predefined/serializable.xml b/language/predefined/serializable.xml index 36ac6f4aed..5f10a62485 100644 --- a/language/predefined/serializable.xml +++ b/language/predefined/serializable.xml @@ -51,9 +51,7 @@ &Methods; - - - + diff --git a/language/predefined/traversable.xml b/language/predefined/traversable.xml index f5d9aa294a..b1e8d0dd5b 100644 --- a/language/predefined/traversable.xml +++ b/language/predefined/traversable.xml @@ -1,5 +1,5 @@ - + @@ -11,9 +11,9 @@
&reftitle.intro; - + Interfaz para detectar si una clase puede recorrerse mediante &foreach;. - + Una interfaz abstracta base no puede ser implementada sola. En su lugar, debe ser implementada con IteratorAggregate o con @@ -52,7 +52,7 @@ - 7.4.0 + 8.0.0 La interfaz Traversable ahora puede ser implementada por clases abstractas. Las clases que la extiendan deben implementar @@ -68,19 +68,20 @@
&reftitle.notes; - + Las clases internas que implementan esta interfaz pueden ser usadas en una construcción &foreach; y no necesitan implementar IteratorAggregate o Iterator. - + - - Antes de PHP 7.4.0, esta interfaz interna del motor no podía ser implementada - en scripts PHP. Se debe usar IteratorAggregate + + Antes de PHP 8.0.0, esta interfaz interna del motor no podía ser implementada + directamente en scripts PHP, ni siquiera por clases abstractas. + IteratorAggregate o Iterator deben usarse en su lugar. - +
diff --git a/language/predefined/valueerror.xml b/language/predefined/valueerror.xml index 96cd02f3ee..d17a3f7d1f 100644 --- a/language/predefined/valueerror.xml +++ b/language/predefined/valueerror.xml @@ -35,17 +35,11 @@ &InheritedProperties; - - - + &InheritedMethods; - - - - - - + +
diff --git a/language/predefined/weakmap.xml b/language/predefined/weakmap.xml index ecb771ae9d..35774d42c4 100644 --- a/language/predefined/weakmap.xml +++ b/language/predefined/weakmap.xml @@ -52,9 +52,7 @@ &Methods; - - - + diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml index 3a84db5560..6ccd975816 100644 --- a/language/predefined/weakreference.xml +++ b/language/predefined/weakreference.xml @@ -37,12 +37,8 @@ &Methods; - - - - - - + +