File: info.xml

package info (click to toggle)
phpdoc 20020310-1
links: PTS
area: main
in suites: woody
size: 35,272 kB
ctags: 354
sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (1790 lines) | stat: -rw-r--r-- 56,840 bytes
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.21 $ -->
<reference id="ref.info">
 <title>Options PHP et informations</title>
 <titleabbrev>Options et informations PHP</titleabbrev>
 <refentry id="function.assert">
  <refnamediv>
   <refname>assert</refname>
   <refpurpose>V&eacute;rifie si une assertion est fausse</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>assert</methodname>
     <methodparam><type>string|boolean</type><parameter>assertion</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>assert</function> va v&eacute;rifier l'assertion
    <parameter>assertion</parameter> et prendre la mesure appropri&eacute;e
    si le r&eacute;sultat est &false;.
   </para>
   <para>
    Si <parameter>assertion</parameter> est donn&eacute;e sous la forme
    d'une cha&icirc;ne, elle sera &eacute;valu&eacute;e comme un code PHP
    par la fonction <function>assert</function>. Les avantages de ce type
    d'assertion sont d'&ecirc;tre moins lourd si la v&eacute;rification
    d'assertion est d&eacute;sactiv&eacute;e, et le contenu des messages
    lorsque l'assertion &eacute;choue.
   </para>
   <para>
    Il est recommand&eacute; de n'utiliser les assertions que comme outil de
    d&eacute;buggage. Vous pouvez les utiliser pour les v&eacute;rifications
    d'usage : ces conditions doivent normalement &ecirc;tre vraies, et indiquer
    une erreur de programmation si ce n'est pas le cas. Vous pouvez aussi
    v&eacute;rifier la pr&eacute;sence de certaines extensions ou
    limitations du syst&egrave;me.
   </para>
   <para>
    Les assertions ne doivent pas &ecirc;tre utilis&eacute;es pour faire des
    op&eacute;rations de v&eacute;rifications en production, comme par exemple
    des v&eacute;rifications de valeur d'argument. En conditions normales,
    votre code doit &ecirc;tre en &eacute;tat de fonctionner si la
    v&eacute;rification d'assertion est d&eacute;sactiv&eacute;e.
   </para>
   <para>
    Le comportement de <function>assert</function> peut &ecirc;tre configur&eacute;
    par <function>assert_options</function> ou par .ini-settings.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.assert-options">
  <refnamediv>
   <refname>assert-options</refname>
   <refpurpose>Fixe et lit diff&eacute;rentes options d'assertions</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>mixed</type><methodname>assert_options</methodname>
     <methodparam><type>int</type><parameter>what</parameter></methodparam>
     <methodparam choice="opt"><type>mixed</type><parameter>value</parameter></methodparam>
    </methodsynopsis>
   <para>
    Avec <function>assert_options</function> vous pouvez modifier les diverses
    options de la fonction <function>assert</function>, ou simplement
    conna&icirc;tre la configuration actuelle.
   </para>
   <table>
    <title>options d'assert</title>
    <tgroup cols="4">
     <thead>
     <row>
      <entry>Option</entry>
      <entry>Param&egrave;tre d'ini</entry>
      <entry>Valeur par d&eacute;faut</entry>
      <entry>Description</entry>
     </row>
     </thead>
     <tbody>
      <row>
       <entry>ASSERT_ACTIVE</entry>
       <entry>assert.active</entry>
       <entry>1</entry>
       <entry>active l'&eacute;valuation de la fonction <function>assert</function></entry>
      </row>
      <row>
       <entry>ASSERT_WARNING</entry>
       <entry>assert.warning</entry>
       <entry>1</entry>
       <entry>g&eacute;n&egrave;re une alerte PHP pour chaque assertion fausse</entry>
      </row>
      <row>
       <entry>ASSERT_BAIL</entry>
       <entry>assert.bail</entry>
       <entry>0</entry>
       <entry>termine l'ex&eacute;cution en cas d'assertion fausse</entry>
      </row>
      <row>
       <entry>ASSERT_QUIET_EVAL</entry>
       <entry>assert.quiet_eval</entry>
       <entry>0</entry>
       <entry>
        inactive le rapport d'erreur durant l'&eacute;valuation d'une assertion
       </entry>
      </row>
      <row>
       <entry>ASSERT_CALLBACK</entry>
       <entry>assert_callback</entry>
       <entry>(null)</entry>
       <entry>fonction utilisateur de traitement des assertions fausses</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
   <para>
    <function>assert_options</function> retourne la valeur originale
    de l'option, ou bien &false; en cas d'erreur.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.extension-loaded">
  <refnamediv>
   <refname>extension_loaded</refname>
   <refpurpose>
    D&eacute;termine si une extension est charg&eacute;e ou non.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>boolean</type><methodname>extension_loaded</methodname>
     <methodparam><type>string</type><parameter>name</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>extension_loaded</function> retourne &true; si l'extension
    <parameter>name</parameter> a &eacute;t&eacute; charg&eacute;e.
    Vous pouvez voir les diff&eacute;rents noms des extensions, en
    utilisant la fonction <function>phpinfo</function>.
   </simpara>
   <para>
    Voir aussi
    <function>phpinfo</function>.
    <note>
     <para>
      Cette fonction a &eacute;t&eacute; ajout&eacute;e dans 3.0.10.
     </para>
    </note>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.dl">
  <refnamediv>
   <refname>dl</refname>
   <refpurpose>Charge une extension PHP &agrave; la vol&eacute;e</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>dl</methodname>
     <methodparam><type>string</type><parameter>library</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>dl</function> charge l'extension PHP <parameter>library</parameter>
    &agrave; la vol&eacute;e .
   </para>
   <para>
    Voir aussi les directives de configuration
    <link linkend="ini.extension-dir">extension_dir</link> et
    <link linkend="ini.enable-dl">enable_dl</link>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.getenv">
  <refnamediv>
   <refname>getenv</refname>
   <refpurpose>Retourne la valeur de la variable d'environnement.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>getenv</methodname>
     <methodparam><type>string</type><parameter>varname</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>getenv</function> retourne la valeur de la variable
    d'environnement <parameter>varname</parameter>,
    ou &false; en cas d'erreur.
    <informalexample>
     <programlisting role="php">
&lt;?php
  $ip = getenv("REMOTE_ADDR"); // retourne l'adresse IP de l'utilisateur
?&gt;
     </programlisting>
    </informalexample>
   </para>
   <para>
    Vous pouvez voir une liste compl&egrave;te des variables d'environnement en
    utilisant la fonction <function>phpinfo</function>. Vous pouvez trouver
    la signification de chacune d'entre elles en consultant le site concernant
    <ulink url="&url.cgispecs;">CGI specification</ulink> (en anglais>, et
    particuli&egrave;ment la page concernant les
    <ulink url="&url.cgispec;">variables d'environnement.</ulink>.
   </para>
   <para>
    Voir aussi
    <function>putenv</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.get-cfg-var">
  <refnamediv>
   <refname>get_cfg_var</refname>
   <refpurpose>Retourne la valeur d'une option de PHP</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>get_cfg_var</methodname>
     <methodparam><type>string</type><parameter>varname</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>get_cfg_var</function> retourne la valeur courante de
    l'option PHP <parameter>varname</parameter>, ou bien
    &false; en cas d'erreur.
   </simpara>
   <simpara>
    <function>get_cfg_var</function> ne retourne pas les options qui
    ont &eacute;t&eacute; choisies lors de la compilation de PHP, ni
    ne lit dans le fichier de configuration d'Apache.
   </simpara>
   <simpara>
    Pour v&eacute;rifier si le syst&egrave;me utilise le
    <link linkend="configuration.file">fichier de configuration</link>,
    essayez de lire la valeur de cfg_file_path. Si cette valeur est
    disponible, alors le fichier de configuration est utilis&eacute;.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.get-current-user">
  <refnamediv>
   <refname>get_current_user</refname>
   <refpurpose>
    Retourne le nom du possesseur du script courant.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>get_current_user</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>get_current_user</function> retourne le nom du possesseur
    du script courant.
   </simpara>
   <simpara>
    Voir aussi
    <function>getmyuid</function>,
    <function>getmypid</function>,
    <function>getmyinode</function> et
    <function>getlastmod</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.get-defined-constants">
  <refnamediv>
   <refname>get_defined_constants</refname>
   <refpurpose>
    Retourne la liste des constantes et leur valeur
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>get_defined_constants</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>get_defined_constants</function> retourne les noms et
    valeurs des constantes d&eacute;j&agrave; d&eacute;finies. Cela inclut
    les constantes cr&eacute;&eacute;es par les extensions, et celles
    cr&eacute;&eacute;es avec la fonction <function>define</function>.
   </para>
   <para>
    Par exemple :
    <informalexample>
     <programlisting>
&lt;?php
  print_r(get_defined_constants());
?&gt;
     </programlisting>
    </informalexample>
    affichera
    <informalexample>
     <programlisting>
Array
(
    [E_ERROR] =&gt; 1
    [E_WARNING] =&gt; 2
    [E_PARSE] =&gt; 4
    [E_NOTICE] =&gt; 8
    [E_CORE_ERROR] =&gt; 16
    [E_CORE_WARNING] =&gt; 32
    [E_COMPILE_ERROR] =&gt; 64
    [E_COMPILE_WARNING] =&gt; 128
    [E_USER_ERROR] =&gt; 256
    [E_USER_WARNING] =&gt; 512
    [E_USER_NOTICE] =&gt; 1024
    [E_ALL] =&gt; 2047
    [TRUE] =&gt; 1
)
     </programlisting>
    </informalexample>
   </para>
   <para>
    Voir aussi
    <function>get_loaded_extensions</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.get-extension-funcs">
  <refnamediv>
   <refname>get_extension_funcs</refname>
   <refpurpose>
    Liste les fonctions d'une extension
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>get_extension_funcs</methodname>
     <methodparam><type>string</type><parameter>module_name</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>get_extension_funcs</function> retourne le nom des fonctions
    d&eacute;finies dans le module <parameter>module_name</parameter>.
   </para>
   <para>
    Par exemple, les lignes suivantes :
    <informalexample>
     <programlisting role="php">
&lt;?php
print_r(get_extension_funcs(&quot;xml&quot;));
print_r(get_extension_funcs(&quot;gd&quot;));
?&gt;
     </programlisting>
    </informalexample>
    vont afficher la liste des fonctions disponibles avec les modules
    <varname>xml</varname> et <varname>gd</varname>.
   </para>
   <para>
    Voir aussi
    <function>get_loaded_extensions</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.getmygid">
  <refnamediv>
   <refname>getmygid</refname>
   <refpurpose>Retourne le GID du propri&eacute;taire du script</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>getmygid</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>getmygid</function> retourne le GID du propri&eacute;taire du script,
    ou &false; en cas d'erreur.
   </simpara>
   <simpara>
    Voir aussi
    <function>getmyuid</function>,
    <function>getmypid</function>,
    <function>get_current_user</function>,
    <function>getmyinode</function> et
    <function>getlastmod</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.get-included-files">
  <refnamediv>
   <refname>get_included_files</refname>
   <refpurpose>
    Retourne un tableau avec les noms des fichiers qui sont inclus
    dans un script
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>get_included_files</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>get_included_files</function> retourne un tableau
    contenant les noms de tous les fichiers qui ont &eacute;t&eacute;
    ajout&eacute;s au script avec les fonctions <function>require_once</function> ou
    <function>include_once</function>.
   </para>
   <para>
    L'exemple ci-dessous
    <example>
     <title>Affichage des fichiers inclus et requis</title>
     <programlisting>
&lt;?php
require_once(&quot;local.php&quot;);
require_once(&quot;../inc/global.php&quot;);
for ($i=1; $i&lt;5; $i++)
  include &quot;util&quot;.$i.&quot;.php&quot;;
  echo &quot;Fichiers appel&eacute;s avec required_once/included_once\n&quot;;
  print_r(get_required_files());
?&gt;
     </programlisting>
    </example>
    va afficher :
    <informalexample>
     <programlisting>
Fichiers appel&eacute;s avec required_once/included_once
Array
(
  [0] =&gt; local.php
  [1] =&gt; /full/path/to/inc/global.php
  [2] =&gt; util1.php
  [3] =&gt; util2.php
  [4] =&gt; util3.php
  [5] =&gt; util4.php
)
     </programlisting>
    </informalexample>
   </para>
   <note>
    <para>
     En PHP 4.0.1pl2, cette fonction supposait que
     <varname>required_once</varname> utilisait l'extension
     &quot;.php&quot; : les autres extensions ne fonctionnaient pas.
     Par ailleurs, dans cette version, le tableau retourn&eacute; &eacute;tait
     un tableau associatif, et cette fonction n'&eacute;tait pas
     un alias de <function>get_included_files</function>
    </para>
   </note>
   <para>
    Voir aussi
    <function>require_once</function>,
    <function>include_once</function> et
    <function>get_required_files</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.get-loaded-extensions">
  <refnamediv>
   <refname>get_loaded_extensions</refname>
   <refpurpose>
    Retourne la liste de tous les modules compil&eacute;s et charg&eacute;s
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>get_loaded_extensions</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>get_loaded_extensions</function> retourne un tableau contenant
    les noms de tous les modules compil&eacute;s et charg&eacute;s sur
    l'interpreteur PHP courant.
   </para>
   <para>
    Par exemple, la ligne ci-dessous
    <informalexample>
     <programlisting role="php">
&lt;?php
print_r(get_loaded_extensions());
?&gt;
     </programlisting>
    </informalexample>
    affichera la liste suivante :
    <informalexample>
     <literallayout>
       <computeroutput>
Array
(
    [0] =&gt; xml
    [1] =&gt; wddx
    [2] =&gt; standard
      [3] =&gt; session
      [4] =&gt; posix
      [5] =&gt; pgsql
      [6] =&gt; pcre
      [7] =&gt; gd
      [8] =&gt; ftp
      [9] =&gt; db
      [10] =&gt; Calendar
      [11] =&gt; bcmath
)
       </computeroutput>
     </literallayout>
    </informalexample>
   </para>
   <para>
    Voir aussi
    <function>get_extension_funcs</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.get-required-files">
  <refnamediv>
   <refname>get_required_files</refname>
   <refpurpose>
    Retourne un tableau avec les noms des fichiers qui sont requis
    et inclus dans un script
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>get_required_files</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>get_required_files</function> retourne un tableau
    contenant les noms de tous les fichiers qui ont &eacute;t&eacute;
    charg&eacute;s dans un script avec la fonction
    <function>require_once</function> ou <function>include_once</function>.
    Les index de ces tableaux sont les noms des fichiers
    utilis&eacute;s dans les fonctions <function>require_once</function>
    ou <function>include_once</function>.
   </para>
   <note>
    <para>
     En PHP 4.0.1pl2, cette fonction supposait que
     <varname>required_once</varname> utilisait l'extension
     &quot;.php&quot; : les autres extensions ne fonctionnaient pas.
     Par ailleurs, dans cette version, le tableau retourn&eacute; &eacute;tait
     un tableau associatif, et cette fonction n'&eacute;tait pas
     un alias de <function>get_included_files</function>
    </para>
    <para>
     Depuis PHP 4.0.4, cette fonction est un alias de
     <function>get_included_files</function>
    </para>
   </note>
   <para>
    Voir aussi
    <function>require_once</function>,
    <function>include_once</function> et
    <function>get_included_files</function>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.get-magic-quotes-gpc">
  <refnamediv>
   <refname>get_magic_quotes_gpc</refname>
   <refpurpose>
    Retourne la configuration actuelle de l'option magic_quotes_gpc.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>long</type><methodname>get_magic_quotes_gpc</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>get_magic_quotes_gpc</function> retourne la configuration actuelle
    de l'option <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>
    (0 pour l'option d&eacute;sactiv&eacute;e, 1 pour l'option activ&eacute;e).
   </simpara>
   <simpara>
    Voir aussi
    <function>get_magic_quotes_runtime</function> et
    <function>set_magic_quotes_runtime</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.get-magic-quotes-runtime">
  <refnamediv>
   <refname>get_magic_quotes_runtime</refname>
   <refpurpose>
    Retourne la configuration actuelle de l'option magic_quotes_runtime.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>long</type><methodname>get_magic_quotes_runtime</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>get_magic_quotes_runtime</function> retourne la configuration
    actuelle de l'option
    <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>.
    (0 pour option d&eacute;sactiv&eacute;e, 1 pour option activ&eacute;e).
   </simpara>
   <simpara>
    Voir aussi
    <function>get_magic_quotes_gpc</function> et
    <function>set_magic_quotes_runtime</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.getlastmod">
  <refnamediv>
   <refname>getlastmod</refname>
   <refpurpose>
    Retourne la date de derni&egrave;re modification de la page.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>getlastmod</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>getlastmod</function> retourne la date de derni&egrave;re
    modification de la page. La valeur retourn&eacute;e est
    un marqueur de temps UNIX, utilisable comme param&egrave;tre avec
    la fonction <function>date</function>.
    <function>getlastmod</function> retourne &false; en
    cas d'erreur.
    <example>
     <title>Exemple avec <function>getlastmod</function></title>
     <programlisting role="php">
&lt;?php
// affiche 'Derni&egrave;re modification: March 04 1998 20:43:59.'
  echo "Derni&egrave;re modification: ".date( "F d Y H:i:s.", getlastmod() );
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>date</function>,
    <function>getmyuid</function>,
    <function>get_current_user</function>,
    <function>getmyinode</function> et
    <function>getmypid</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.getmyinode">
  <refnamediv>
   <refname>getmyinode</refname>
   <refpurpose>Retourne l'inode du script.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>getmyinode</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>getmyinode</function> retourne l'inode du script,
    ou &false; en cas d'erreur.
   </para>
   <para>
    Voir aussi
    <function>getmyuid</function>,
    <function>get_current_user</function>,
    <function>getmypid</function> et
    <function>getlastmod</function>.
   </para>
   <note>
    <simpara>
     <function>getmyinode</function> est inop&eacute;rante sur les syst&egrave;mes Windows.
    </simpara>
   </note>
  </refsect1>
 </refentry>
 <refentry id="function.getmypid">
  <refnamediv>
   <refname>getmypid</refname>
   <refpurpose>Retourne le num&eacute;ro de processus courant.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>getmypid</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>getmypid</function> retourne le num&eacute;ro de processus
    actuel ou &false; en cas d'erreur.
   </para>
   <para>
    Il est &agrave; noter que si vous utilisez PHP comme module Apache,
    il n'est pas garanti que deux invocations distinctes de la fonction
    donnent des r&eacute;sultats diff&eacute;rents.
   </para>
   <warning>
   <para>
    Les identifiants de processus ne sont pas uniques,
    et forment une source d'entropie faible. Nous recommandons
    de ne pas utiliser les pid pour assurer la s&eacute;curit&eacute; d'un
    syst&egrave;me.
   </para>
   </warning>
   <para>
    Voir aussi
    <function>getmyuid</function>,
    <function>get_current_user</function>,
    <function>getmyinode</function> et
    <function>getlastmod</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.getmyuid">
  <refnamediv>
   <refname>getmyuid</refname>
   <refpurpose>Retourne l'UID du propri&eacute;taire du script actuel.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>getmyuid</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>getmyuid</function> retourne l'UID du propri&eacute;taire
    du script actuel ou &false; en cas d'erreur.
   </simpara>
   <simpara>
    Voir aussi
    <function>getmypid</function>,
    <function>get_current_user</function>,
    <function>getmyinode</function> et
    <function>getlastmod</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.getrusage">
  <refnamediv>
   <refname>getrusage</refname>
   <refpurpose>Retourne le niveau d'utilisation des ressources.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>array</type><methodname>getrusage</methodname>
     <methodparam choice="opt"><type>int</type><parameter>who</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>getrusage</function> est une interface &agrave;
    la fonction system getrusage(2).
    Elle retourne un tableau associatif contenant les informations
    renvoy&eacute;es par cet appel syst&egrave;me. Si "who is 1",
    getrusage sera appel&eacute; avec le param&egrave;tre RUSAGE_CHILDREN.
   </para>
   <para>
    Toutes les valeurs du tableau sont accessibles en utilisant leur nom dans le
    tableau.
    <example>
     <title>Exemple getrusage</title>
     <programlisting role="php">
&lt;?php
  $dat = getrusage();
  echo $dat["ru_nswap"];        // Taille de la m&eacute;moire swap
  echo $dat["ru_majflt"];       // Nombre de page m&eacute;moires utilis&eacute;es
  echo $dat["ru_utime.tv_sec"]; // Temps utilisateur (en secondes)
  echo $dat["ru_utime.tv_usec"];// Temps utilisateur (en microsecondes)
?&gt;
     </programlisting>
    </example>
    Consultez le manuel "man" pour plus de d&eacute;tails.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.ini-alter">
  <refnamediv>
   <refname>ini_alter</refname>
   <refpurpose>Change la valeur d'une option de configuration</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>ini_alter</methodname>
     <methodparam><type>string</type><parameter>varname</parameter></methodparam>
     <methodparam><type>string</type><parameter>newvalue</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>ini_alter</function> change la valeur de l'option de
    configuration <parameter>varname</parameter>
    et lui donne la valeur de  <parameter>newvalue</parameter>.
    <function>ini_alter</function> retourne &false;
    en cas d'&eacute;chec, et la valeur pr&eacute;c&eacute;dente en
    cas de succ&egrave;s.
   </para>
   <note>
    <para>
     <function>ini_alter</function> est un alias de <function>ini_set</function>
    </para>
   </note>
   <para>
    Voir aussi
    <function>ini_get</function>,
    <function>ini_restore</function> et
    <function>ini_set</function>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.ini-get">
  <refnamediv>
   <refname>ini_get</refname>
   <refpurpose>Lit la valeur d'une option de configuration.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>ini_get</methodname>
     <methodparam><type>string</type><parameter>varname</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>ini_get</function> retourne la valeur de l'option de
    configuration <parameter>varname</parameter> en cas de succ&egrave;s, et
    &false;.
   </para>
   <para>
    Voir aussi
    <function>ini_alter</function>,
    <function>ini_restore</function> et
    <function>ini_set</function>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.ini-get-all">
  <refnamediv>
   <refname>ini_get_all</refname>
   <refpurpose>Lit toutes les valeurs de configuration</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
    <type>array</type><methodname>ini_get_all</methodname>
    <methodparam choice="opt"><type>string</type><parameter>extension</parameter></methodparam>
   </methodsynopsis>
  <para>
   <function>ini_get_all</function> retourne toutes les
   valeurs de configuration sous la forme d'un tableau associatif.
   Si le param&egrave;tre optionnel <parameter>extension</parameter> est
   fourni, <function>ini_get_all</function> retourne uniquement
   les configurations concernant cette extension.
  </para>
  <para>
   Voir aussi
   <function>ini_alter</function>,
   <function>ini_restore</function>,
   <function>ini_get</function> et
   <function>ini_set</function>
  </para>
 </refsect1>
 </refentry>
 <refentry id="function.ini-restore">
  <refnamediv>
   <refname>ini_restore</refname>
   <refpurpose>Restaure la valeur de l'option de configuration</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>ini_restore</methodname>
     <methodparam><type>string</type><parameter>varname</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>ini_restore</function> restaure la valeur originale de
    l'option de configuration <parameter>varname</parameter>.
   </para>
   <para>
    Voir aussi
    <function>ini_alter</function>,
    <function>ini_get</function> et
    <function>ini_set</function>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.ini-set">
  <refnamediv>
   <refname>ini_set</refname>
   <refpurpose>Change la valeur d'une option de configuration</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>ini_set</methodname>
     <methodparam><type>string</type><parameter>varname</parameter></methodparam>
     <methodparam><type>string</type><parameter>newvalue</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>ini_set</function> change la valeur de l'option de
    configuration <parameter>varname</parameter>
    et lui donne la valeur de  <parameter>newvalue</parameter>.
    <function>ini_set</function> retourne &false;
    en cas d'&eacute;chec, et la valeur
    pr&eacute;c&eacute;dente en cas de succ&egrave;s.
    La valeur de l'option de configuration sera modifi&eacute;e durant toute
    l'ex&eacute;cution du script et pour ce script sp&eacute;cifiquement. Elle reprendra
    sa valeur par d&eacute;faut d&egrave;s la fin du script.
   </para>
   <para>
    Toutes les options disponibles ne peuvent pas &ecirc;tre toutes
    modifi&eacute;es avec <function>ini_set</function>. Ci-dessous, vous
    trouverez une liste de toutes les options (disponibles
    en PHP 4.0.5-dev), et si elles peuvent &ecirc;tre modifi&eacute;es.
    <table>
     <title>Options de configuration</title>
     <tgroup cols="3">
      <thead>
      <row>
       <entry>Nom</entry>
       <entry>Par d&eacute;faut</entry>
       <entry>Modifiable</entry>
      </row>
      </thead>
      <tbody>
       <row>
        <entry>define_syslog_variables</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>highlight.bg</entry>
        <entry>HL_BG_COLOR</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>highlight.comment</entry>
        <entry>HL_COMMENT_COLOR</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>highlight.default</entry>
        <entry>HL_DEFAULT_COLOR</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>highlight.html</entry>
        <entry>HL_HTML_COLOR</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>highlight.keyword</entry>
        <entry>HL_KEYWORD_COLOR</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>highlight.string</entry>
        <entry>HL_STRING_COLOR</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>allow_call_time_pass_reference</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
       </row>
       <row>
        <entry>asp_tags</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
       </row>
       <row>
        <entry>display_errors</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>display_startup_errors</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>enable_dl</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>error_append_string</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>error_prepend_string</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>expose_php</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>html_errors</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>ignore_user_abort</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>implicit_flush</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>log_errors</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>magic_quotes_gpc</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>magic_quotes_runtime</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>magic_quotes_sybase</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>output_buffering</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>output_handler</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>register_argc_argv</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>register_globals</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>safe_mode</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>short_open_tag</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
       </row>
       <row>
        <entry>sql.safe_mode</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>track_errors</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>y2k_compliance</entry>
        <entry>"0"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>arg_separator</entry>
        <entry>"&amp;"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>auto_append_file</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>auto_prepend_file</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>doc_root</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>default_charset</entry>
        <entry>SAPI_DEFAULT_CHARSET</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>default_mimetype</entry>
        <entry>SAPI_DEFAULT_MIMETYPE</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>error_log</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>extension_dir</entry>
        <entry>PHP_EXTENSION_DIR</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>gpc_order</entry>
        <entry>"GPC"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>include_path</entry>
        <entry>PHP_INCLUDE_PATH</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>max_execution_time</entry>
        <entry>"30"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>open_basedir</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>safe_mode_exec_dir</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>upload_max_filesize</entry>
        <entry>"2M"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>file_uploads</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>post_max_size</entry>
        <entry>"8M"</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>upload_tmp_dir</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>user_dir</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>variables_order</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>SMTP</entry>
        <entry>"localhost"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>browscap</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>error_reporting</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>memory_limit</entry>
        <entry>"8M"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>precision</entry>
        <entry>"14"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>sendmail_from</entry>
        <entry>NULL</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
       <row>
        <entry>sendmail_path</entry>
        <entry>DEFAULT_SENDMAIL_PATH</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>disable_functions</entry>
        <entry>""</entry>
        <entry>PHP_INI_SYSTEM</entry>
       </row>
       <row>
        <entry>allow_url_fopen</entry>
        <entry>"1"</entry>
        <entry>PHP_INI_ALL</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <para>
    <table>
     <title>D&eacute;finition des constantes PHP_INI_*</title>
     <tgroup cols="3">
      <thead>
      <row>
       <entry>Constante</entry>
       <entry>Valeur</entry>
       <entry>Signification</entry>
      </row>
      </thead>
      <tbody>
       <row>
        <entry>PHP_INI_USER</entry>
        <entry>1</entry>
        <entry>La valeur peut &ecirc;tre modifi&eacute;e dans un script</entry>
       </row>
       <row>
        <entry>PHP_INI_PERDIR</entry>
        <entry>2</entry>
        <entry>La valeur peut &ecirc;tre modifi&eacute;e dans le fichier <filename>.htaccess</filename></entry>
       </row>
       <row>
        <entry>PHP_INI_SYSTEM</entry>
        <entry>4</entry>
        <entry>La valeur peut &ecirc;tre modifi&eacute;e dans <filename>php.ini</filename> ou
        <filename>httpd.conf</filename></entry>
       </row>
       <row>
        <entry>PHP_INI_ALL</entry>
        <entry>7</entry>
        <entry>La valeur peut &ecirc;tre modifi&eacute;e n'importe o&ugrave;</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <para>
    Voir aussi
    <function>ini_alter</function>,
    <function>ini_get</function> et
    <function>ini_restore</function>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.phpcredits">
  <refnamediv>
   <refname>phpcredits</refname>
   <refpurpose>Imprime les cr&eacute;dits de PHP.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>void</type><methodname>phpcredits</methodname>
     <methodparam><type>int</type><parameter>flag</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>phpcredits</function> affiche la liste des d&eacute;veloppeurs PHP,
    des modules, etc... Elle g&eacute;n&egrave;re le code HTML
    appropri&eacute; pour ins&eacute;rer les informations dans une page.
    Le param&egrave;tre <parameter>flag</parameter> indique les informations
    qui doivent &ecirc;tre affich&eacute;es. Par exemple, pour afficher
    les cr&eacute;dits g&eacute;n&eacute;raux, vous pouvez utiliser le
    code suivant :
    <informalexample>
     <programlisting role="php">
&lt;?php
  phpcredits(CREDITS_GENERAL);
?&gt;
     </programlisting>
    </informalexample>
    Et pour afficher la liste des d&eacute;veloppeurs et du groupe
    de documentation dans une page s&eacute;par&eacute;e, vous
    utiliserez
    <informalexample>
     <programlisting role="php">
&lt;?php
  phpcredits(CREDITS_GROUP + CREDITS_DOCS + CREDITS_FULLPAGE);
?&gt;
     </programlisting>
    </informalexample>
    Si vous vous sentez l'envie de placer tous les cr&eacute;dits dans votre page,
    vous pouvez utiliser ceci :
    <informalexample>
     <programlisting role="php">
&lt;html&gt;
  &lt;head&gt;
    &lt;title&gt;Ma page de cr&eacute;dits&lt;/title&gt;
  &lt;/head&gt;
  &lt;body&gt;
  &lt;?php
    // Un peu de votre code
    phpcredits(CREDITS_ALL + CREDITS_FULLPAGE);
    // Un autre peu de votre code
  ?&gt;
  &lt;/body&gt;
&lt;/html&gt;
     </programlisting>
    </informalexample>
   </para>
   <para>
   </para>
   <para>
    <table>
     <title>
      Param&egrave;tre pr&eacute;d&eacute;finis de <function>phpcredits</function>
     </title>
     <tgroup cols="2">
      <thead>
      <row>
       <entry>Nom</entry>
       <entry>Description</entry>
      </row>
      </thead>
      <tbody>
       <row>
        <entry>CREDITS_ALL</entry>
        <entry>
         Tous les cr&eacute;dits, &eacute;quivalent &agrave; :
         CREDITS_DOCS + CREDITS_GENERAL +  CREDITS_GROUP + CREDITS_MODULES +
         CREDITS_FULLPAGE. La fonction g&eacute;n&egrave;re
         alors une page HTML compl&egrave;te.
        </entry>
       </row>
       <row>
        <entry>CREDITS_DOCS</entry>
        <entry>Les cr&eacute;dits du groupe de documentation</entry>
       </row>
       <row>
        <entry>CREDITS_FULLPAGE</entry>
        <entry>
         En g&eacute;n&eacute;ral, ce param&egrave;tre est utilis&eacute; avec d'autres
         constantes. Il indique que la page ainsi g&eacute;n&eacute;r&eacute;e doit
         &ecirc;tre une page HTML compl&egrave;te, avec toutes les balises
         n&eacute;cessaires.
        </entry>
       </row>
       <row>
        <entry>CREDITS_GENERAL</entry>
        <entry>
         Cr&eacute;dits G&eacute;n&eacute;raux : conception et design du langage,
         auteurs de PHP 4.0, module SAPI.
        </entry>
       </row>
       <row>
        <entry>CREDITS_GROUP</entry>
        <entry>Une liste des d&eacute;veloppeurs principaux</entry>
       </row>
       <row>
        <entry>CREDITS_MODULES</entry>
        <entry>Une liste des extensions de PHP, et leurs auteurs</entry>
       </row>
       <row>
        <entry>CREDITS_SAPI</entry>
        <entry>Cette constante est d&eacute;finie, mais elle n'est toujours pas
         utilis&eacute;e sous PHP 4.0.1pl2.
        </entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <para>
    Voir aussi
    <function>version_compare</function>,
    <function>phpinfo</function>,
    <function>phpversion</function> et
    <function>php_logo_guid</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.phpinfo">
  <refnamediv>
   <refname>phpinfo</refname>
   <refpurpose>Affiche de nombreuses informations sur le PHP.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>int</type><methodname>phpinfo</methodname>
     <methodparam choice="opt"><type>int</type><parameter>what</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>phpinfo</function> affiche de nombreuses informations sur le PHP, concernant sa
    configuration courante : options de compilation, extensions,
    version, informations sur le serveur, et environnement (lorsque
    compil&eacute; comme module), environnement PHP, chemins, utilisateur,
    en-t&ecirc;tes HTTP, et licence GNU Public License.
   </para>
   <para>
    Les affichages peuvent &ecirc;tre personnalis&eacute;s en passant une
    ou plusieurs valeurs parmi les suivantes, comme param&egrave;tre
    optionnel <parameter>what</parameter> :
    <itemizedlist>
     <listitem><simpara>INFO_GENERAL</simpara></listitem>
     <listitem><simpara>INFO_CREDITS</simpara></listitem>
     <listitem><simpara>INFO_CONFIGURATION</simpara></listitem>
     <listitem><simpara>INFO_MODULES</simpara></listitem>
     <listitem><simpara>INFO_ENVIRONMENT</simpara></listitem>
     <listitem><simpara>INFO_VARIABLES</simpara></listitem>
     <listitem><simpara>INFO_LICENSE</simpara></listitem>
     <listitem><simpara>INFO_ALL</simpara></listitem>
    </itemizedlist>
   </para>
   <para>
    Voir aussi
    <function>phpversion</function>,
    <function>phpcredits</function> et
    <function>php_logo_guid</function>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.phpversion">
  <refnamediv>
   <refname>phpversion</refname>
   <refpurpose>
    Retourne le num&eacute;ro de la version courante de PHP.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>phpversion</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <function>phpversion</function> retourne le num&eacute;ro de
    la version courante de PHP.
    <example>
     <title>Exemple avec <function>phpversion</function></title>
     <programlisting role="php">
&lt;?php
// affiche le num&eacute;ro de version courante du PHP.
  echo "PHP Version: ".phpversion();
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>phpinfo</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.php-logo-guid">
  <refnamediv>
   <refname>php_logo_guid</refname>
   <refpurpose>Retourne le logo</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>php_logo_guid</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <note>
     <para>
      Cette fonctionnalit&eacute; a &eacute;t&eacute; ajout&eacute;e dans
      PHP 4 Beta 4.
     </para>
    </note>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.php-sapi-name">
  <refnamediv>
   <refname>php_sapi_name</refname>
   <refpurpose>
    Retourne le type d'interface utilis&eacute; entre le serveur web et PHP
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>php_sapi_name</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>php_sapi_name</function> retourne une cha&icirc;ne en minuscule
    qui d&eacute;crit le type d'interface utilis&eacute; en le serveur web et PHP
    (Server API, SAPI). En CGI PHP, cette cha&icirc;ne est "CGI", en
    mod_php pour Apache, cette cha&icirc;ne est "apache", etc...
   </simpara>
   <para>
    <example>
     <title>Exemple <function>php_sapi_name</function></title>
     <programlisting role="php">
&lt;?php
$inter_type = php_sapi_name();
if ($inter_type == "cgi")
    print "Vous utilisez CGI PHP\n";
else
    print "Vous n'utilisez pas CGI PHP\n";
?&gt;
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.php-uname">
  <refnamediv>
   <refname>php_uname</refname>
   <refpurpose>
    Retourne les informations sur le syst&egrave;me d'exploitation
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>php_uname</methodname>
     <void/>
    </methodsynopsis>
   <simpara>
    <function>php_uname</function> retourne les informations sur le syst&egrave;me
    d'exploitation sur lequel tourne PHP.
   </simpara>
   <para>
    <example>
     <title>Exemple <function>php_uname</function></title>
     <programlisting role="php">
&lt;?php
if (substr(php_uname(), 0, 7) == "Windows") {
    die("D&eacute;sol&eacute;, ce script ne fonctionne pas sous Windows.\n");
}
?&gt;
     </programlisting>
    </example>
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.putenv">
  <refnamediv>
   <refname>putenv</refname>
   <refpurpose>Fixe la valeur d'une variable d'environnement.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>void</type><methodname>putenv</methodname>
     <methodparam><type>string</type><parameter>setting</parameter></methodparam>
    </methodsynopsis>
   <para>
    <function>putenv</function> fixe la valeur d'une variable d'environnement.
    Cette valeur n'existera que durant la vie du script courant, et l'environnement
    initial sera restaur&eacute; lorsque le script sera termin&eacute;.
   </para>
    <para>
     Modifier la valeur de certaines variables syst&egrave;me peut &ecirc;tre un trou
     de s&eacute;curit&eacute; consid&eacute;rable. La directive de configuration
     <literal>safe_mode_allowed_env_vars</literal> contient une liste de
     pr&eacute;fixes, s&eacute;par&eacute;s par des virgules. Lorsque le Safe Mode est actif,
     l'utilisateur ne peut que modifier les variables qui dont le nom
     commence par les pr&eacute;fixes fournis par cette directive.
     Par d&eacute;faut, les utilisateurs ne peuvent modifier que les variables qui
     commencent par <literal>PHP_</literal>
     (i.e. <literal>PHP_FOO=BAR</literal>). Note: si cette directive est vide,
     PHP autorisera la modification de TOUTES les variables d'environnement!.
    </para>
    <para>
     La directive de configuration <literal>safe_mode_protected_env_vars</literal>
     contient une liste de variables d'environnement, s&eacute;par&eacute;es par des virgules.
     Les utilisateurs ne pourront pas modifier ces variables avec la fonction
     <function>putenv</function>. Ces variables seront prot&eacute;g&eacute;es m&ecirc;me si
     <literal>safe_mode_allowed_env_vars</literal> permet leur modification.
    </para>
   <para>
    <example>
     <title>Modification d'une variable d'environnement</title>
     <programlisting role="php">
&lt;?php
putenv("UNIQID=$uniqid");
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>getenv</function>.
   </para>
  </refsect1>
 </refentry>
 <refentry id="function.set-magic-quotes-runtime">
  <refnamediv>
   <refname>set_magic_quotes_runtime</refname>
   <refpurpose>
    Active/d&eacute;sactive l'option magic_quotes_runtime.
   </refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>long</type><methodname>set_magic_quotes_runtime</methodname>
     <methodparam><type>int</type><parameter>new_setting</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>set_magic_quotes_runtime</function> active/d&eacute;sactive l'option
    <link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>.
    (0 l'option est d&eacute;sactiv&eacute;e, 1 l'option est activ&eacute;e).
   </simpara>
   <simpara>
    Voir aussi
    <function>get_magic_quotes_gpc</function> et
    <function>get_magic_quotes_runtime</function>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.set-time-limit">
  <refnamediv>
   <refname>set_time_limit</refname>
   <refpurpose>Fixe le temps maximum d'ex&eacute;cution d'un script.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>void</type><methodname>set_time_limit</methodname>
     <methodparam><type>int</type><parameter>seconds</parameter></methodparam>
    </methodsynopsis>
   <simpara>
    <function>set_time_limit</function> fixe le d&eacute;lai d'expiration
    d'un script, en secondes. Si cette limite est atteinte, le script s'interrompt, et
    renvoie une erreur fatale. La valeur par d&eacute;faut est 30 secondes ou, si
    c'est le cas, la valeur de la directive max_execution_time d&eacute;finie dans le
    <link linkend="configuration.file">fichier de configuration</link>.
    Si la valeur est z&eacute;ro, il n'y a alors aucune limite impos&eacute;e.
   </simpara>
   <simpara>
    Lorsqu'elle est appel&eacute;e, la fonction
    <function>set_time_limit</function> remet le compteur
    de z&eacute;ro. En d'autres termes, si la limite par
    d&eacute;faut est &agrave; 30 secondes, et qu'apr&egrave;s
    25 secondes d'ex&eacute;cution du script l'appel
    set_time_limit(20) est fait, alors le script tournera
    pendant un total de 45 secondes avant de finir.
   </simpara>
   <simpara>
    Notez que <function>set_time_limit</function> n'a pas
    d'effet lorsque PHP fonctionne en mode <link linkend="ini.safe-mode">safe mode</link>. Il
    n'y a pas d'autre solution que de changer de
    mode, ou de modifier la dur&eacute;e maximale
    d'ex&eacute;cution dans le <link linkend="configuration.file">
    fichier de configuration</link>.
   </simpara>
  </refsect1>
 </refentry>
 <refentry id="function.zend-logo-guid">
  <refnamediv>
   <refname>zend_logo_guid</refname>
   <refpurpose>Retourne le logo de Zend</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>zend_logo_guid</methodname>
     <void/>
    </methodsynopsis>
   <para>
    <note>
     <para>
      Cette fonctionnalit&eacute; a &eacute;t&eacute; ajout&eacute;e en PHP 4 Beta 4.
     </para>
    </note>
   </para>
  </refsect1>
 </refentry>
  <refentry id="function.version-compare">
   <refnamediv>
    <refname>version_compare</refname>
    <refpurpose>Compare deux versions de PHP</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>int</type><methodname>version_compare</methodname>
      <methodparam><type>string</type><parameter>version1</parameter></methodparam>
      <methodparam><type>string</type><parameter>version2</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        operator
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>version_compare</function> compare
     les deux versions de PHP standardis&eacute;e. Cette fonction est pratique
     pour les programmes qui doivent v&eacute;rifier la version de PHP qui les
     fait tourner.
    </para>
    <para>
     <function>version_compare</function> retourne -1 si
      <parameter>version1</parameter> est inf&eacute;rieure &agrave; <parameter>version2</parameter>,
      0 si elles sont &eacute;gales, et 1 dans le reste des cas.
    </para>
    <para>
     Si vous sp&eacute;cifiez le troisi&egrave;me argument optionnel
     <parameter>operator</parameter>, vous pouvez tester une
     relation particuli&egrave;re. Les op&eacute;rateurs possibles sont
     <literal>&lt;</literal>,
     <literal>lt</literal>, <literal>&lt;=</literal>,
     <literal>le</literal>, <literal>&gt;</literal>,
     <literal>gt</literal>, <literal>&gt;=</literal>,
     <literal>ge</literal>, <literal>==</literal>,
     <literal>=</literal>, <literal>eq</literal>,
     <literal>!=</literal>, <literal>&lt;&gt;</literal>,
     <literal>ne</literal>. En utilisant cet argument,
     <function>version_compare</function> retournera 1 si la
     relation est v&eacute;rifi&eacute;e et 0 sinon.
    </para>
    <para>
     <example>
      <title>Exemple avec <function>version_compare</function></title>
      <programlisting role="php">
&lt;?php
echo version_compare("4.0.4", "4.0.6");
// affiche -1
echo version_compare("4.0.4", "4.0.6", "&lt;");
echo version_compare("4.0.6", "4.0.6", "eq");
// affichent tous 1
?&gt;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
 <refentry id="function.zend-version">
  <refnamediv>
   <refname>zend_version</refname>
   <refpurpose>Lit la version courante du moteur Zend.</refpurpose>
  </refnamediv>
  <refsect1>
   <title>Description</title>
    <methodsynopsis>
     <type>string</type><methodname>zend_version</methodname>
     <methodparam><type>void</type><parameter/></methodparam>
    </methodsynopsis>
   <para>
    <function>zend_version</function> retourne une cha&icirc;ne contenant le
    num&eacute;ro de version du moteur d'analyse Zend, pour l'ex&eacute;cutable
    PHP courant.
    <example>
     <title>Exemple <function>zend_version</function></title>
     <programlisting role="php">
&lt;?php
// affiche e.g. 'Version du moteur Zend: 1.0.4'
// ou bien quelque chose d'approchant si votre version de PHP date un peu
  echo "Version du moteur Zend: ".zend_version();
?&gt;
     </programlisting>
    </example>
   </para>
   <para>
    Voir aussi
    <function>phpinfo</function>,
    <function>phpcredits</function>,
    <function>php_logo_guid</function> et
    <function>phpversion</function>.
   </para>
  </refsect1>
 </refentry>
</reference>
<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->