chmod.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5eb55cda5cc4bc61e94f17468c6402d631edafa5 Maintainer: khp Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision 5eb55cda5cc4bc61e94f17468c6402d631edafa5 Reviewer: samesch -->
<refentry xml:id="function.chmod" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>chmod</refname>
  <refpurpose>Ändert den Modus für die Zugriffsrechte einer Datei</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>
   Versucht, den Modus für die Zugriffsrechte der angegebenen Datei zu dem in
   <parameter>permissions</parameter> definierten zu ändern.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>filename</parameter></term>
     <listitem>
      <para>
       Pfad zu der Datei.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>permissions</parameter></term>
     <listitem>
      <para>
       Es ist zu beachten, dass <parameter>permissions</parameter> nicht
       automatisch für einen Oktalwert gehalten wird. Um also sicherzustellen,
       dass die Operation wie erwartet verläuft, muss
       <parameter>permissions</parameter> mit dem Präfix Null (0) versehen
       werden. Zeichenketten wie etwa "g+w" funktionieren nicht korrekt.
      </para>
      <para>
       <informalexample>
        <programlisting role="php">
<![CDATA[
<?php
chmod("/einverzeichnis/einedatei", 755);   // dezimal; wahrscheinlich falsch
chmod("/einverzeichnis/einedatei", "u+rwx,go+rx"); // Zeichenkette; falsch
chmod("/einverzeichnis/einedatei", 0755);  // oktal; richtiger Wert für den Modus
?>
]]>
        </programlisting>
       </informalexample>
      </para>
      <para>
       Der Parameter <parameter>permissions</parameter> besteht aus drei
       oktalen Zifferkomponenten, die die Zugriffsberechtigungen für den
       Besitzer, für die Gruppe, in der der Besitzer ist, und für alle anderen
       in dieser Reihenfolge festlegen. Eine Komponete kann durch Addition der
       benötigten Rechte für das jeweilige Ziel berechnet werden. Die Ziffer 1
       bedeutet, dass man Ausführrechte gewährt, die Ziffer 2 bedeutet, dass
       die Datei beschreibbar ist, die Ziffer 4 bedeutet, dass die Datei
       lesbar ist. Addieren Sie diese Zahlen, um die benötigten Rechte
       anzugeben. In unixoiden Betriebssystemen können Sie mit
       '<command>man 1 chmod</command>' und '<command>man 2 chmod</command>'
       mehr über diese Modi lesen.
      </para>
      <para>
       <informalexample>
        <programlisting role="php">
<![CDATA[
<?php
// Lese- und Schreibrechte für den Besitzer, keine für alle anderen
chmod("/somedir/somefile", 0600);

// Lese- und Schreibrechte für den Besitzer, Leserechte für alle anderen
chmod("/somedir/somefile", 0644);

// Alle Rechte für den Besitzer, Lese- und Ausführrechte für andere
chmod("/somedir/somefile", 0755);

// Alle Rechte für den Besitzer, Lese- und Ausführrechte für die Gruppe
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>
   Bei einem Fehler wird ein <constant>E_WARNING</constant> ausgegeben.
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Der aktuelle Nutzer ist der Nutzer, unter dem PHP läuft. Dies ist
    möglicherweise nicht der gleiche Nutzer wie der, der für den Shell- oder
    FTP-Zugang verwendet wird. Auf den meisten Betriebssystemen können die
    Zugriffsrechte nur durch den Besitzer der Datei geändert werden.
   </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
-->