Skip to content

Commit

Permalink
Info sync with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
devnexen committed Jan 27, 2025
1 parent ae657af commit e976882
Showing 1 changed file with 124 additions and 1 deletion.
125 changes: 124 additions & 1 deletion reference/info/ini.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ada1d79de35239334b68d0120b011530e31244ff Maintainer: yannick Status: ready -->
<!-- EN-Revision: b1116af46680f7baf89c46610430a3b63ce9a1f0 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<section xml:id="info.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
Expand Down Expand Up @@ -101,6 +101,24 @@
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.zend.max-allowed-stack-size">zend.max_allowed_stack_size</link></entry>
<entry>"0"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponible à partir de PHP 8.3.0.</entry>
</row>
<row>
<entry><link linkend="ini.zend.reserved-stack-size">zend.reserved_stack_size</link></entry>
<entry>"0"</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry>Disponible à partir de PHP 8.3.0.</entry>
</row>
<row>
<entry><link linkend="ini.fiber.stack-size">fiber.stack_size</link></entry>
<entry></entry>
<entry><constant>INI_ALL</constant></entry>
<entry>Disponible à partir de PHP 8.1.0.</entry>
</row>
</tbody>
</tgroup>
</table>
Expand Down Expand Up @@ -305,6 +323,111 @@
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.zend.max-allowed-stack-size">
<term>
<parameter>zend.max_allowed_stack_size</parameter>
<type>int</type>
</term>
<listitem>
<para>
La quantité maximale de mémoire de pile native (stack) autorisée par le
système d’exploitation pour le programme.
Tenter de consommer plus que le système ne le permet aboutit
généralement à un plantage brutal, sans informations de débogage
facilement disponibles.
Pour faciliter le débogage, le moteur déclenche une
<classname>Error</classname>
avant que cela ne se produise (lorsque le programme utilise plus de
<link linkend="ini.zend.max-allowed-stack-size">zend.max_allowed_stack_size</link>-<link linkend="ini.zend.reserved-stack-size">zend.reserved_stack_size</link>
octets de pile).
</para>
<para>
La récursion dans le code défini par l’utilisateur ne consomme pas
de pile native. Cependant, les fonctions internes et les méthodes magiques, elles,
consomment bien de la pile native.
Une récursion très profonde impliquant ces fonctions peut faire que le programme
épuise toute la mémoire de pile disponible.
</para>
<para>
Les valeurs possibles pour ce paramètre sont :
<simplelist>
<member>
<literal>0</literal> :
Détecter automatiquement la mémoire de pile native maximale que le système
d’exploitation autorise pour le programme.
C’est la valeur par défaut.
Lorsque la détection est impossible, une valeur par défaut du système est utilisée.
</member>
<member>
<literal>-1</literal> : Désactive la vérification de la taille de la pile dans le moteur.
</member>
<member>
Entier positif : Une taille fixe, en octets.
Définir cette valeur trop élevée revient au même que de désactiver la vérification de la
taille de la pile.
</member>
</simplelist>
</para>
<para>
Comme la taille de pile
<link linkend="language.fibers">des fibers</link>
est déterminée par
<link linkend="ini.fiber.stack-size">fiber.stack_size</link>,
la valeur de ce paramètre est utilisée à la place de
<link linkend="ini.zend.max-allowed-stack-size">zend.max_allowed_stack_size</link>
lors de la vérification de l’utilisation de la pile pendant l’exécution d’une Fiber.
</para>
<note>
<para>
Ceci n’a aucun lien avec les dépassements de tampon de la pile
<emphasis>(stack buffer overflows)</emphasis>, et n’est pas une fonctionnalité de sécurité.
</para>
</note>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.zend.reserved-stack-size">
<term>
<parameter>zend.reserved_stack_size</parameter>
<type>int</type>
</term>
<listitem>
<para>
La taille réservée de la pile, en octets.
Celle-ci est soustraite de la
<link linkend="ini.zend.max-allowed-stack-size">taille de pile maximale autorisée</link>,
comme une marge de sécurité, lors de la vérification de la taille de la pile.
</para>
<para>
Les valeurs possibles pour ce paramètre sont :
<simplelist>
<member>
<literal>0</literal> : Détecter automatiquement une taille raisonnable.
</member>
<member>
Entier positif : Une taille fixe, en octets.
</member>
</simplelist>
</para>
</listitem>
</varlistentry>

<varlistentry xml:id="ini.fiber.stack-size">
<term>
<parameter>fiber.stack_size</parameter>
<type>int</type>
</term>
<listitem>
<para>
La taille de la pile native, en octets, allouée à chaque
<link linkend="language.fibers">Fiber</link>.
</para>
<para>
La valeur par défaut est de 1 Mio sur les systèmes dont la taille des pointeurs
est inférieure à 8 octets, ou de 2 Mio sinon.
</para>
</listitem>
</varlistentry>

</variablelist>
</para>
Expand Down

0 comments on commit e976882

Please sign in to comment.