Files
doc-fr/appendices/reserved.constants.core.xml
T
2021-07-23 12:48:06 +02:00

719 lines
20 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3c18b283afac456a741f6cd5447440c6525ffc7d Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<sect2 xml:id="reserved.constants.core" xmlns="http://docbook.org/ns/docbook">
<title>Constantes prédéfinies</title>
<simpara>
Ces constantes sont définies par le cœur de PHP. Cela inclut notamment PHP,
le moteur Zend et les modules SAPI.
</simpara>
<variablelist>
<varlistentry xml:id="constant.php-version">
<term>
<constant>PHP_VERSION</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
La version courante de PHP sous la forme
d'une chaîne de caractères dans la notation
"major.minor.release[extra]".
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-major-version">
<term>
<constant>PHP_MAJOR_VERSION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La version majeure courante de PHP sous la forme
d'une chaîne de caractères (i.e., int(5)
depuis la version "5.2.7-extra").
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-minor-version">
<term>
<constant>PHP_MINOR_VERSION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La version mineure courante de PHP sous la forme
d'une chaîne de caractères (i.e., int(2)
depuis la version "5.2.7-extra").
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-release-version">
<term>
<constant>PHP_RELEASE_VERSION</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La version stable courante de PHP sous la forme
d'une chaîne de caractères (i.e., int(7)
depuis la version "5.2.7-extra").
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-version-id">
<term>
<constant>PHP_VERSION_ID</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La version courante de PHP sous la forme d'un
entier, utile pour la comparaison de versions
(i.e., int(50207) depuis la version "5.2.7-extra").
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-extra-version">
<term>
<constant>PHP_EXTRA_VERSION</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
La version "extra" courante de PHP sous la forme
d'une chaîne de caractères(i.e., '-extra'
depuis la version "5.2.7-extra"). Habituellement
utilisée par les packagers des distributions
pour indiquer une version de paquet.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-zts">
<term>
<constant>PHP_ZTS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-debug">
<term>
<constant>PHP_DEBUG</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-maxpathlen">
<term>
<constant>PHP_MAXPATHLEN</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La longueur maximale des noms de fichiers
(y compris le chemin) supportée
par ce binaire PHP.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-os">
<term>
<constant>PHP_OS</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-os-family">
<term>
<constant>PHP_OS_FAMILY</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Le système d'exploitation pour lequel PHP a été compilé. Un de
<literal>'Windows'</literal>, <literal>'BSD'</literal>,
<literal>'Darwin'</literal>, <literal>'Solaris'</literal>,
<literal>'Linux'</literal> ou <literal>'Unknown'</literal>.
Disponible à partir de PHP 7.2.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-sapi">
<term>
<constant>PHP_SAPI</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
L'API du serveur pour ce binaire PHP.
Voir aussi <function>php_sapi_name</function>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-eol">
<term>
<constant>PHP_EOL</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Le bon symbole de fin de ligne pour cette
plateforme.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-int-max">
<term>
<constant>PHP_INT_MAX</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Le plus grand entier supporté par ce binaire
de PHP. Habituellement, int(2147483647) sur les systèmes 32 bit et
int(9223372036854775807) sur les systèmes 64 bit.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-int-min">
<term>
<constant>PHP_INT_MIN</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Le plus petit entier supporté dans cette version de PHP.
Habituellement, int(-2147483648) sur les systèmes 32 bit
et int(-9223372036854775808) sur les systèmes 64 bit.
Habituellement, PHP_INT_MIN === ~PHP_INT_MAX.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-int-size">
<term>
<constant>PHP_INT_SIZE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
La taille d'un entier, en octets, dans cette version de PHP.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-float-dig">
<term>
<constant>PHP_FLOAT_DIG</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Nombre de décimales pouvant être arrondies dans un nombre à virgule
flottante et retournées sans perte de précision.
Disponible depuis PHP 7.2.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-float-epsilon">
<term>
<constant>PHP_FLOAT_EPSILON</constant>
(<type>float</type>)
</term>
<listitem>
<simpara>
Le plus petit nombre à virgule flottante positif supporté, de sorte que
<literal>x + 1.0 != 1.0</literal>.
Disponible à partir de PHP 7.2.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-float-min">
<term>
<constant>PHP_FLOAT_MIN</constant>
(<type>float</type>)
</term>
<listitem>
<simpara>
Le plus petit nombre à virgule flottante <emphasis>positif</emphasis> supporté.
Si vous avez besoin de la plus petite représentation
<emphasis>négative</emphasis> de nombre flottant,
utiliser <literal>- PHP_FLOAT_MAX</literal>.
Disponible à partir de PHP 7.2.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-float-max">
<term>
<constant>PHP_FLOAT_MAX</constant>
(<type>float</type>)
</term>
<listitem>
<simpara>
Le plus grand nombre à virgule flottante supporté.
Disponible à partir de PHP 7.2.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.default-include-path">
<term>
<constant>DEFAULT_INCLUDE_PATH</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pear-install-dir">
<term>
<constant>PEAR_INSTALL_DIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.pear-extension-dir">
<term>
<constant>PEAR_EXTENSION_DIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-extension-dir">
<term>
<constant>PHP_EXTENSION_DIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Le répertoire par défaut où chercher pour des extensions chargeable
dynamiquement (sauf rejeté par
<link linkend="ini.extension-dir">extension_dir</link>).
Par défaut <constant>PHP_PREFIX</constant> (ou <code>PHP_PREFIX . "\\ext"</code> sur Windows).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-prefix">
<term>
<constant>PHP_PREFIX</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
La valeur de <option role="configure">--prefix</option> qui a été définie lors de la configuration.
Sur Windows, c'est la valeur de <option role="configure">--with-prefix</option>
qui a été définie lors de la configuration.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-bindir">
<term>
<constant>PHP_BINDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Spécifie l'endroit où ont été installés
les binaires.
La valeur de <option role="configure">--bindir</option> qui a été définie lors de la configuration.
Sur Windows, c'est la valeur de <option role="configure">--with-prefix</option>
qui a été définie lors de la configuration.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-binary">
<term>
<constant>PHP_BINARY</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Spécifie le chemin vers le binaire PHP lors de l'exécution du script.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-mandir">
<term>
<constant>PHP_MANDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Spécifie le chemin d'installation des pages man.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-libdir">
<term>
<constant>PHP_LIBDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-datadir">
<term>
<constant>PHP_DATADIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-sysconfdir">
<term>
<constant>PHP_SYSCONFDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-localstatedir">
<term>
<constant>PHP_LOCALSTATEDIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-config-file-path">
<term>
<constant>PHP_CONFIG_FILE_PATH</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-config-file-scan-dir">
<term>
<constant>PHP_CONFIG_FILE_SCAN_DIR</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-shlib-suffix">
<term>
<constant>PHP_SHLIB_SUFFIX</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Le suffixe de la plate-forme de compilation
pour les bibliothèques partagées, comme "so"
(sous la plupart des Unix) ou "dll" (Windows).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-fd-setsize">
<term>
<constant>PHP_FD_SETSIZE</constant>
(<type>string</type>)
</term>
<listitem>
<simpara>
Nombre maximal de descripteurs de fichiers pour les appels système
sélectionnés. Disponible à partir de PHP 7.1.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-error">
<term>
<constant>E_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-warning">
<term>
<constant>E_WARNING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-parse">
<term>
<constant>E_PARSE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-notice">
<term>
<constant>E_NOTICE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-core-error">
<term>
<constant>E_CORE_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-core-warning">
<term>
<constant>E_CORE_WARNING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-compile-error">
<term>
<constant>E_COMPILE_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-compile-warning">
<term>
<constant>E_COMPILE_WARNING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-user-error">
<term>
<constant>E_USER_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-user-warning">
<term>
<constant>E_USER_WARNING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-user-notice">
<term>
<constant>E_USER_NOTICE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-recoverble-error">
<term>
<constant>E_RECOVERABLE_ERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-deprecated">
<term>
<constant>E_DEPRECATED</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-user-deprecated">
<term>
<constant>E_USER_DEPRECATED</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-all">
<term>
<constant>E_ALL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.e-strict">
<term>
<constant>E_STRICT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<link linkend="errorfunc.constants">Constante de rapport d'erreur</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.compiler-halt-offset">
<term>
<constant>__COMPILER_HALT_OFFSET__</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.true">
<term>
&true;
(<type>bool</type>)
</term>
<listitem>
<simpara>
Voir <link linkend="language.types.boolean">Booleans</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.false">
<term>
&false;
(<type>bool</type>)
</term>
<listitem>
<simpara>
Voir <link linkend="language.types.boolean">Booleans</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.null">
<term>
&null;
(<type>null</type>)
</term>
<listitem>
<simpara>
Voir <link linkend="language.types.null">Null</link>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-windows-event-ctrl-c">
<term>
<constant>PHP_WINDOWS_EVENT_CTRL_C</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Évènement Windows <literal>CTRL+C</literal>.
Disponible à partir de PHP 7.4.0 (Windows uniquement).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.php-windows-event-ctrl-break">
<term>
<constant>PHP_WINDOWS_EVENT_CTRL_BREAK</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Évènement Windows <literal>CTRL+BREAK</literal>.
Disponible à partir de PHP 7.4.0 (Windows uniquement).
</simpara>
</listitem>
</varlistentry>
</variablelist>
<para>
Voir aussi les <link linkend="language.constants.magic">constantes
magiques</link>.
</para>
</sect2>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->