Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
8 changes: 7 additions & 1 deletion appendices/migration82/incompatible.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 763b31ef61c2aceb779c333c4577d669bf63ea48 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 97ec75e6709ebc47dbcdacbc1c373c6eb57d657b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: Marqitos -->
<sect1 xml:id="migration82.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Cambios incompatibles con versiones anteriores</title>
Expand All @@ -19,6 +19,12 @@
Los símbolos <literal>number</literal> en los <link linkend="datetime.formats.relative">formatos relativos</link>
ya no aceptan signos múltiples, por ejemplo <literal>+-2</literal>.
</para>

<simpara>
<methodname>DateTime::getLastErrors</methodname> y
<methodname>DateTimeImmutable::getLastErrors</methodname> ahora devuelven &false;
cuando no hay advertencias ni errores; anteriormente siempre devolvían un array.
</simpara>
</sect2>

<sect2 xml:id="migration82.incompatible.odbc">
Expand Down
4 changes: 2 additions & 2 deletions language/predefined/exception.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c4f95a6974306cf162dd4a6c89162cb310429762 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: eb3bd8f4d41ba473f467e8d2d028ddeb074c505b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<reference xml:id="class.exception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Exception</title>
Expand Down Expand Up @@ -45,7 +45,7 @@
<varname linkend="exception.props.string">string</varname>
<initializer>""</initializer>
</fieldsynopsis>
<fieldsynopsis xml:id="class.exception..code">
<fieldsynopsis>
<modifier>protected</modifier>
<type>int</type>
<varname linkend="exception.props.code">code</varname>
Expand Down
21 changes: 19 additions & 2 deletions reference/exif/functions/exif-read-data.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 330a38c4d45556b49e06ebe6d39e0e311534cd8c Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.exif-read-data">
<refentry xml:id="function.exif-read-data" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>exif_read_data</refname>
<refpurpose>Lee los encabezados <acronym>EXIF</acronym> en las imágenes</refpurpose>
Expand Down Expand Up @@ -192,12 +192,29 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Las etiquetas <literal>OffsetTime</literal>, <literal>OffsetTimeOriginal</literal>
y <literal>OffsetTimeDigitized</literal> ahora se reconocen;
anteriormente se reportaban como <literal>UndefinedTag:0x9010</literal>,
<literal>UndefinedTag:0x9011</literal> y
<literal>UndefinedTag:0x9012</literal>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>required_sections</parameter> ahora es nullable.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
El parámetro <parameter>file</parameter> ahora admite tanto ficheros
locales como recursos de flujo.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Expand Down
15 changes: 14 additions & 1 deletion reference/image/constants.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="image.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
Expand Down Expand Up @@ -714,6 +714,19 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.imagetype-svg">
<term>
<constant>IMAGETYPE_SVG</constant>
(<type>int</type>)
</term>
<listitem>
&gd.constants.type;
<simpara>
(disponible a partir de PHP 8.5.0, solo si la extensión
<link linkend="book.libxml">libxml</link> está cargada)
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.imagetype-unknown">
<term>
<constant>IMAGETYPE_UNKNOWN</constant>
Expand Down
119 changes: 76 additions & 43 deletions reference/image/functions/getimagesize.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 22ca9442cb38626cc8fc522c62f74f32b3dc9709 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
<refentry xml:id="function.getimagesize" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>getimagesize</refname>
<refpurpose>Devuelve el tamaño de una imagen</refpurpose>
Expand Down Expand Up @@ -44,6 +44,15 @@
para el primer codestream encontrado en la raíz del fichero.
</simpara>
</note>
<note>
<simpara>
Las imágenes SVG solo se reconocen si la extensión
<link linkend="book.libxml">libxml</link> está cargada. El elemento raíz
<tag>svg</tag> debe tener los atributos <literal>width</literal> y
<literal>height</literal>, cada uno un entero seguido opcionalmente de una
unidad, como <literal>5cm</literal>. En caso contrario, se devuelve &false;.
</simpara>
</note>
<note>
<simpara>
La información sobre iconos se recupera desde el icono con mayor resolución.
Expand Down Expand Up @@ -99,11 +108,11 @@

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un array que contiene hasta 7 elementos. No todos los tipos
<simpara>
Devuelve un array que contiene hasta 9 elementos. No todos los tipos
de imágenes incluyen los elementos <literal>channels</literal> y
<literal>bits</literal>.
</para>
</simpara>
<para>
El índice 0 contiene el ancho. El índice 1 contiene la altura.
</para>
Expand All @@ -127,10 +136,11 @@
El índice 2 es una constante entre <constant>IMAGETYPE_<replaceable>*</replaceable></constant>,
indicando el tipo de la imagen.
</para>
<para>
<simpara>
El índice 3 contiene la cadena para colocar en las etiquetas
<acronym>IMG</acronym>: <literal>height="xxx" width="yyy"</literal>.
</para>
Se omite si el ancho o la altura no se expresan en píxeles.
</simpara>
<para>
<literal>mime</literal> corresponde al tipo MIME de una imagen.
Esta información puede ser utilizada para enviar el encabezado
Expand All @@ -154,6 +164,12 @@ if ($size && $fp) {
</programlisting>
</example>
</para>
<simpara>
<literal>width_unit</literal> y <literal>height_unit</literal> son las
unidades en las que se expresan los índices 0 y 1. Son
<literal>"px"</literal> a menos que la imagen indique otra cosa, como pueden
hacer las imágenes SVG, y pueden diferir entre sí.
</simpara>
<para>
<literal>channels</literal> será 3 para imágenes RGB y 4 para
imágenes CMYK.
Expand Down Expand Up @@ -188,42 +204,59 @@ if ($size && $fp) {
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.2.0</entry>
<entry>
Devuelve las dimensiones actuales de la imagen, bits y canales de imágenes AVIF;
previamente, las dimensiones eran reportadas como <literal>0x0</literal>,
y bits y canales no eran reportados en absoluto.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Ahora se lanza una excepción <exceptionname>ValueError</exceptionname> si
<parameter>filename</parameter> está vacío; anteriormente se generaba
un <constant>E_WARNING</constant> y la función devolvía &false;.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Añadido el soporte para WebP.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Añadido el soporte para imágenes HEIF/HEIC.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Añadido el soporte para imágenes SVG, si la extensión libxml está cargada.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
El array devuelto ahora contiene los elementos <literal>width_unit</literal> y
<literal>height_unit</literal>.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
Devuelve las dimensiones actuales de la imagen, bits y canales de imágenes AVIF;
previamente, las dimensiones eran reportadas como <literal>0x0</literal>,
y bits y canales no eran reportados en absoluto.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Ahora se lanza una excepción <exceptionname>ValueError</exceptionname> si
<parameter>filename</parameter> está vacío; anteriormente se generaba
un <constant>E_WARNING</constant> y la función devolvía &false;.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Añadido el soporte para WebP.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
Expand Down
26 changes: 25 additions & 1 deletion reference/image/functions/image-type-to-extension.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.image-type-to-extension" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -51,6 +51,30 @@
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Añadido el soporte para <constant>IMAGETYPE_HEIF</constant> (<literal>.heif</literal>)
y, si la extensión <link linkend="book.libxml">libxml</link> está
cargada, para <constant>IMAGETYPE_SVG</constant> (<literal>.svg</literal>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
9 changes: 8 additions & 1 deletion reference/image/functions/image-type-to-mime-type.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.image-type-to-mime-type" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -130,6 +130,13 @@
<entry><constant>IMAGETYPE_HEIF</constant></entry>
<entry><literal>image/heif</literal></entry>
</row>
<row>
<entry>
<constant>IMAGETYPE_SVG</constant> (solo si la extensión
<link linkend="book.libxml">libxml</link> está cargada)
</entry>
<entry><literal>image/svg+xml</literal></entry>
</row>
</tbody>
</tgroup>
</table>
Expand Down
4 changes: 2 additions & 2 deletions reference/pdo/pdoexception.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3aac0ba2da1e235092086965f74b9855174f9ad1 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: eb3bd8f4d41ba473f467e8d2d028ddeb074c505b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.pdoexception" role="exception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La clase PDOException</title>
Expand Down Expand Up @@ -49,7 +49,7 @@
</fieldsynopsis>

<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;'] and (not(@xml:id) or @xml:id != 'class.exception..code')]))"/>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;'] and not(db:varname = 'code')]))"/>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdoexception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDOException'])"/>
Expand Down
Loading