doc-fr/reference/filesystem/functions/chmod.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.22 $ -->
<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.chmod">
 <refnamediv>
  <refname>chmod</refname>
  <refpurpose>Change le mode du fichier</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>chmod</methodname>
   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
   <methodparam><type>int</type><parameter>mode</parameter></methodparam>
  </methodsynopsis>
  <para>
   Remplace le mode du fichier <parameter>filename</parameter>
   par le mode <parameter>mode</parameter>.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>filename</parameter></term>
     <listitem>
      <para>
       Chemin vers le fichier.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>mode</parameter></term>
     <listitem>
      <para>
       Il est à noter que le mode <parameter>mode</parameter> est
       considéré comme un nombre en notation octale. Afin de
       vous en assurer, vous pouvez préfixer cette valeur par un
       zéro (<parameter>mode</parameter>) :
      </para>
      <para>
       <informalexample>
        <programlisting role="php">
<![CDATA[
<?php
chmod("/somedir/somefile", 755);   // notation décimale : probablement faux
chmod("/somedir/somefile", "u+rwx,go+rx"); // chaîne : incorrect
chmod("/somedir/somefile", 0755);  // notation octale : valeur du mode correcte
?>
]]>
        </programlisting>
       </informalexample>
      </para>
      <para>
       Le paramètre <parameter>mode</parameter> est constitué de trois
       valeurs octales qui spécifient les droits pour le propriétaire,
       le groupe du propriétaire et les autres, respectivement. Chaque
       composant peut être calculé en ajoutant les droits désirés.
       Le chiffre 1 donne les droits d'exécution, le chiffre 2 les droits
       d'écriture et le chiffre 4 les droits de lecture. Ajoutez simplement
       ces nombres pour spécifier les droits voulus. Vous pouvez aussi
       lire le manuel des systèmes Unix avec <command>man 1 chmod</command> et 
       <command>man 2 chmod</command>.
      </para>
      <para>
       <informalexample>
        <programlisting role="php">
<![CDATA[
<?php
// Lecture et écriture pour le propriétaire, rien pour les autres
chmod("/somedir/somefile", 0600);

// Lecture et écriture pour le propriétaire, lecture pour les autres
chmod("/somedir/somefile", 0644);

// Tout pour le propriétaire, lecture et exécution pour les autres
chmod("/somedir/somefile", 0755);

// Tout pour le propriétaire, lecture exécution pour le groupe, rien pour les autres
chmod("/somedir/somefile", 0750);
?>
]]>
        </programlisting>
       </informalexample>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    L'utilisateur courant est l'utilisateur avec lequel PHP fonctionne.
    Il est probablement différent de l'utilisateur que vous utilisez
    en mode Shell ou FTP. Le mode ne peut être modifié que par l'utilisateur
    à qui appartient le fichier sur la plupart des systèmes.
   </para>
  </note>
  &note.no-remote;
  <note>
   <para>
    Lorsque le &safemode; est activé, PHP vérifie si les fichiers et
    dossiers que vous allez utiliser ont le même UID (propriétaire) que
    le script qui est en cours d'exécution. De plus, vous ne pouvez pas
    modifier les SUID, SGID et sticky bits.
   </para>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>chown</function></member>
    <member><function>chgrp</function></member>
    <member><function>fileperms</function></member>
    <member><function>stat</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- 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
-->