doc-fr/reference/phar/ini.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- EN-Revision: 1.10 Maintainer: gui 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>
     <row>
      <entry><link linkend="ini.phar.readonly">phar.readonly</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.require-hash">phar.require_hash</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.extract-list">phar.extract_list</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible de phar 1.1.0 à 1.2.3, supprimé en 2.0.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.phar.cache-list">phar.cache_list</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Disponible à partir de phar 2.0.0.</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   <varlistentry xml:id="ini.phar.readonly">
    <term>
     <parameter>phar.readonly</parameter>
     <type>boolean</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>boolean</type>
    </term>
    <listitem>
     <para>
	  Cette option forcera toutes les archives Phar ouvertes à contenir
	  un type de signature (à ce jour MD5, SHA1, SHA256 et SHA512 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; pour des
	   raisons de sécurité. 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>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.phar.extract-list">
    <term>
     <parameter>phar.extract_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Ce paramètre INI a été supprimé en phar 2.0.0.
     </para>
     <para>
	  Permet la correspondance entre le chemin complet d'une archive
	  phar ou son alias et l'emplacement de ses fichiers extraits.
	  Le format de ce paramètre est <literal>name=archive,name2=archive2</literal>.
	  Cela permet l'extraction de fichiers phar sur le disque, et 
	  permet à phar d'agir comme une sorte de correspondance vers 
	  des fichiers extraits sur disque. C'est souvent utilisé
	  pour des raisons de performance ou pour aider au débogage de phar.
      <example>
       <title>exemple d'utilisation de phar.extract_list</title>
       <programlisting role="php">
<![CDATA[
dans php.ini:
phar.extract_list = archive=/chemin/complet/vers/archive/,arch2=/chemin/complet/vers/arch2
<?php
include "phar://archive/content.php";
include "phar://arch2/foo.php";
?>
]]>
       </programlisting>
      </example>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.phar.cache-list">
    <term>
     <parameter>phar.cache_list</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Ce paramètre INI a été ajouté en phar 2.0.0
     </para>
     <para>
	  Permet aux correspondances d'archives phar d'être traitées au
	  démarrage du serveur web, augmentant de ce fait les performance
	  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:"../../../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
-->