Skip to content
Merged
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
9 changes: 7 additions & 2 deletions appendices/migration82/incompatible.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 763b31ef61c2aceb779c333c4577d669bf63ea48 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 97ec75e6709ebc47dbcdacbc1c373c6eb57d657b Maintainer: lacatoire Status: ready -->
<sect1 xml:id="migration82.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Modifications entraînant une incompatibilité ascendante</title>

Expand All @@ -21,6 +20,12 @@
Les symboles <literal>number</literal> dans les <link linkend="datetime.formats.relative">formats relatifs</link>
n'acceptent plus les signes multiples, par exemple <literal>+-2</literal>.
</para>

<simpara>
<methodname>DateTime::getLastErrors</methodname> et
<methodname>DateTimeImmutable::getLastErrors</methodname> retournent désormais &false;
lorsqu'il n'y a ni avertissement ni erreur, alors qu'auparavant elles retournaient toujours un tableau.
</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: yannick Status: ready -->
<!-- EN-Revision: eb3bd8f4d41ba473f467e8d2d028ddeb074c505b Maintainer: yannick Status: ready -->
<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>
<titleabbrev>Exception</titleabbrev>
Expand Down Expand Up @@ -43,7 +43,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
16 changes: 12 additions & 4 deletions reference/exif/functions/exif-read-data.xml
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 330a38c4d45556b49e06ebe6d39e0e311534cd8c Maintainer: lacatoire 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">
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: lacatoire Status: ready -->
<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>Lit les en-têtes <acronym>EXIF</acronym> dans les images</refpurpose>
Expand Down Expand Up @@ -197,6 +195,16 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Les tags <literal>OffsetTime</literal>, <literal>OffsetTimeOriginal</literal>
et <literal>OffsetTimeDigitized</literal> sont désormais reconnus ;
auparavant, ils étaient signalés sous les noms <literal>UndefinedTag:0x9010</literal>,
<literal>UndefinedTag:0x9011</literal> et
<literal>UndefinedTag:0x9012</literal>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
17 changes: 14 additions & 3 deletions reference/image/constants.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: lacatoire Status: ready -->
<appendix xml:id="image.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
Expand Down Expand Up @@ -714,6 +712,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 à partir de PHP 8.5.0, uniquement si l'extension
<link linkend="book.libxml">libxml</link> est chargée)
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.imagetype-unknown">
<term>
<constant>IMAGETYPE_UNKNOWN</constant>
Expand Down
121 changes: 77 additions & 44 deletions reference/image/functions/getimagesize.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 22ca9442cb38626cc8fc522c62f74f32b3dc9709 Maintainer: lacatoire Status: ready -->
<refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.getimagesize" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>getimagesize</refname>
<refpurpose>Retourne la taille d'une image</refpurpose>
Expand Down Expand Up @@ -48,6 +48,15 @@
pour le premier codestream rencontré à la racine du fichier.
</simpara>
</note>
<note>
<simpara>
Les images SVG ne sont reconnues que si l'extension
<link linkend="book.libxml">libxml</link> est chargée. L'élément racine
<tag>svg</tag> doit avoir des attributs <literal>width</literal> et
<literal>height</literal>, chacun étant un entier éventuellement suivi d'une
unité, comme <literal>5cm</literal>. Sinon, &false; est retourné.
</simpara>
</note>
<note>
<simpara>
Les informations sur les icônes sont récupérées depuis l'icône possédant
Expand Down Expand Up @@ -107,11 +116,11 @@

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne un tableau contenant jusqu'à 7 éléments. Tous les types
<simpara>
Retourne un tableau contenant jusqu'à 9 éléments. Tous les types
d'images n'incluent pas les éléments <literal>channels</literal> et
<literal>bits</literal>.
</para>
</simpara>
<para>
Les indices 0 et 1 contiennent respectivement la largeur et la hauteur de l'image.
</para>
Expand All @@ -136,11 +145,12 @@
L'index 2 est une constante parmi <constant>IMAGETYPE_<replaceable>*</replaceable></constant>,
indiquant le type de l'image.
</para>
<para>
<simpara>
L'index 3 est une chaîne de texte avec la chaîne
<literal>height="yyy" width="xxx"</literal> correcte qui peut être utilisée
directement dans une balise <acronym>IMG</acronym>.
</para>
directement dans une balise <acronym>IMG</acronym>. Il est omis si la largeur
ou la hauteur n'est pas exprimée en pixels.
</simpara>
<para>
<literal>mime</literal> correspond au type MIME d'une image.
Cette information peut être utilisée pour envoyer l'en-tête
Expand All @@ -164,6 +174,12 @@ if ($size && $fp) {
</programlisting>
</example>
</para>
<simpara>
<literal>width_unit</literal> et <literal>height_unit</literal> sont les
unités dans lesquelles les index 0 et 1 sont exprimés. Elles valent
<literal>"px"</literal> sauf si l'image indique autre chose, comme peuvent le faire
les images SVG, et elles peuvent différer l'une de l'autre.
</simpara>
<para>
<literal>channels</literal> sera 3 pour des images RGB et 4 pour
des images CMYK.
Expand Down Expand Up @@ -199,42 +215,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>
Retourne désormais les dimensions réelles de l'image, les bits et les canaux des images AVIF ;
précédemment, les dimensions étaient rapportées en tant que <literal>0x0</literal>,
et les bits et les canaux n'étaient pas rapportés du tout.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Une <exceptionname>ValueError</exceptionname> est désormais lancée si
<parameter>filename</parameter> est vide ; précédemment un
<constant>E_WARNING</constant> était émis et la fonction retournait &false;.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Ajout du support de 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>
Ajout de la prise en charge des images HEIF/HEIC.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Ajout de la prise en charge des images SVG, si l'extension libxml est chargée.
</entry>
</row>
<row>
<entry>8.5.0</entry>
<entry>
Le tableau retourné contient désormais les éléments <literal>width_unit</literal> et
<literal>height_unit</literal>.
</entry>
</row>
<row>
<entry>8.2.0</entry>
<entry>
Retourne désormais les dimensions réelles de l'image, les bits et les canaux des images AVIF ;
précédemment, les dimensions étaient rapportées en tant que <literal>0x0</literal>,
et les bits et les canaux n'étaient pas rapportés du tout.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Une <exceptionname>ValueError</exceptionname> est désormais lancée si
<parameter>filename</parameter> est vide ; précédemment un
<constant>E_WARNING</constant> était émis et la fonction retournait &false;.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Ajout du support de WebP.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
Expand Down
27 changes: 25 additions & 2 deletions reference/image/functions/image-type-to-extension.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9960a09a5705102bf4dd0ce63e03d9ec716d0015 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: yannick Status: ready -->
<refentry xml:id="function.image-type-to-extension" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>image_type_to_extension</refname>
Expand Down Expand Up @@ -51,6 +50,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>
Ajout de la prise en charge de <constant>IMAGETYPE_HEIF</constant> (<literal>.heif</literal>)
et, si l'extension <link linkend="book.libxml">libxml</link> est
chargée, de <constant>IMAGETYPE_SVG</constant> (<literal>.svg</literal>).
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
11 changes: 8 additions & 3 deletions reference/image/functions/image-type-to-mime-type.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f8bab1dfb5246788f144103de56208dd133e9461 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 4cab6e04096c02da7accd5668f9e5aaae2ac681b Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.image-type-to-mime-type" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>image_type_to_mime_type</refname>
Expand Down Expand Up @@ -129,6 +127,13 @@
<entry><constant>IMAGETYPE_HEIF</constant></entry>
<entry><literal>image/heif</literal></entry>
</row>
<row>
<entry>
<constant>IMAGETYPE_SVG</constant> (uniquement si l'extension
<link linkend="book.libxml">libxml</link> est chargée)
</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: lacatoire Status: ready -->
<!-- EN-Revision: eb3bd8f4d41ba473f467e8d2d028ddeb074c505b Maintainer: lacatoire Status: ready -->
<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 classe <classname>PDOException</classname></title>
<titleabbrev>PDOException</titleabbrev>
Expand Down Expand Up @@ -45,7 +45,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
Loading