chmod.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5eb55cda5cc4bc61e94f17468c6402d631edafa5 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes Maintainer: itanea -->
<refentry xml:id="function.chmod" xmlns="http://docbook.org/ns/docbook">
 <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>permissions</parameter></methodparam>
  </methodsynopsis>
  <para>
   Remplace le mode du fichier <parameter>filename</parameter>
   par le mode <parameter>permissions</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>permissions</parameter></term>
     <listitem>
      <para>
       Il est à noter que le mode <parameter>permissions</parameter> est
       considéré comme un nombre en notation octale, aussi, afin de
       vous en assurer, vous pouvez préfixer le mode
       <parameter>permissions</parameter> par un zéro. Les chaînes comme "g+w"
       ne fonctionneront pas correctement :
      </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>permissions</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="errors">
  &reftitle.errors;
  <para>
   En cas d'échec, une erreur <constant>E_WARNING</constant> est émis.
  </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;
 </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:"~/.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
-->