archived-doc-fr/reference/phar/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: jpauli Status: ready -->
<!-- Reviewed: yes -->
<section xml:id="phar.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>&ConfigureOptions; pour le système de fichiers</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="phar.configuration.list">
     <row>
      <entry><link linkend="ini.phar.readonly">phar.readonly</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.require-hash">phar.require_hash</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.cache-list">phar.cache_list</link></entry>
      <entry>""</entry>
      <entry><constant>INI_SYSTEM</constant></entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry xml:id="ini.phar.readonly">
    <term>
     <parameter>phar.readonly</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Cette option désactive la création ou la modification des 
      archives Phar en utilisant le flux <literal>phar</literal> 
      ou le support en écriture sur les objets <classname>Phar</classname>.
      Ce paramètre devrait toujours être activé sur des machines
      de production, car le support en écriture sur les archives
      phar pourrait mener à la création de virus basés sur PHP en
      cas d'utilisation conjuguée avec des vulnérabilités communes.
     </para>
     <note>
      <para>
       Ce paramètre ne peut être désactivé que dans &php.ini;
       pour des raisons de sécurité. Si <literal>phar.readonly</literal>
       est désactivé dans php.ini, l'utilisateur peut
       activer <literal>phar.readonly</literal> dans un script
       ou le désactiver plus tard. Si <literal>phar.readonly</literal> est
       activé dans &php.ini;, un script pourrait &quot;réactiver&quot;
       sans danger la variable INI, mais ne pourrait pas la désactiver.
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.phar.require-hash">
    <term>
     <parameter>phar.require_hash</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Cette option forcera toutes les archives Phar ouvertes à contenir
      un type de signature (à ce jour MD5, SHA1, SHA256, SHA512 et OpenSSL sont
      supportés), et toute archive Phar ne contenant
      pas de signature sera rejetée.
     </para>
     <note>
      <para>
       Ce paramètre ne peut être désactivé que dans &php.ini;.
       Si <literal>phar.require_hash</literal>
       est désactivé dans &php.ini;, l'utilisateur peut
       activer <literal>phar.require_hash</literal> dans un script
       ou le désactiver plus tard. Si <literal>phar.require_hash</literal> est
       activé dans &php.ini;, un script pourrait &quot;réactiver&quot;
       sans danger la variable INI, mais ne pourrait pas la désactiver.
      </para>
      <para>
       Ce paramètre n'affecte pas la lecture des fichiers tar avec la classe
       <classname>PharData</classname>.
      </para>
     </note>
     <caution>
      <simpara>
       <literal>phar.require_hash</literal> ne fournit pas de sécurité en soi,
       c'est uniquement une mesure contre l'exécution accidentelle d'archives
       Phar corrompues, car quiconque peut trafiquer le Phar peut
       facilement corriger la signature après.
      </simpara>
     </caution>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.phar.cache-list">
    <term>
     <parameter>phar.cache_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Permet aux correspondances d'archives phar d'être traitées au
      démarrage du serveur web, augmentant de ce fait les performances
      d'accès aux fichiers contenus dans une archive phar et les rendant
      très proche d'un accès à des fichiers d'une installation classique
      sur disque.
      <example>
       <title>Exemple d'utilisation de phar.cache_list</title>
       <programlisting role="php">
<![CDATA[
dans php.ini (windows):
phar.cache_list =C:\chemin\vers\phar1.phar;C:\chemin\vers\phar2.phar
dans php.ini (unix):
phar.cache_list =/chemin/vers/phar1.phar:/chemin/vers/phar2.phar
]]>
       </programlisting>
      </example>
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </para>
</section>

<!-- 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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->