cvs: phpdoc-pl /reference/filesystem/functions chmod.xml

leszek Sun Feb 8 08:36:22 2004 EDT Modified files: /phpdoc-pl/reference/filesystem/functions chmod.xml Log: [adi] update to rev. 1.11 http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/chmod.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-pl/reference/filesystem/functions/chmod.xml diff -u phpdoc-pl/reference/filesystem/functions/chmod.xml:1.3 phpdoc-pl/reference/filesystem/functions/chmod.xml:1.4 --- phpdoc-pl/reference/filesystem/functions/chmod.xml:1.3 Fri May 17 09:50:49 2002 +++ phpdoc-pl/reference/filesystem/functions/chmod.xml Sun Feb 8 08:36:22 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.2 Maintainer: adi Status: ready --> -<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.11 Maintainer: adi Status: ready --> +<!-- $Revision: 1.4 $ --> <refentry id="function.chmod"> <refnamediv> <refname>chmod</refname> @@ -9,9 +9,9 @@ <refsect1> <title>Opis</title> <methodsynopsis> - <type>int</type><methodname>chmod</methodname> + <type>bool</type><methodname>chmod</methodname> <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam> - <methodparam><type>int</type><parameter>prawa</parameter></methodparam> + <methodparam><type>bool</type><parameter>prawa</parameter></methodparam> </methodsynopsis> <para> Dokonuje zmiany praw pliku podanego w parametrze @@ -24,12 +24,48 @@ (takie jak "g+w") nie bêd± poprawnie interpretowane. Aby zapewniæ poprawno¶æ operacji musisz parametr <parameter>prawa</parameter> poprzedziæ prefixem zero (0): + </para> + <para> + <informalexample> + <programlisting role="php"> + <![CDATA[ + <?php + chmod("/somedir/somefile", 755); // dziesiêtnie; prawdopodobnie nieprawid³owo + chmod("/somedir/somefile", "u+rwx,go+rx"); // ³añcuch; nieprawid³owo + chmod("/somedir/somefile", 0755); // ósemkowo; poprawna warto¶æ dla praw + ?> + ]]> + </programlisting> + </informalexample> + </para> + <para> + Parametr <parameter>prawa</parameter> zawiera trzy cyfry w systemie ósemkowym + okre¶laj±ce prawa dostêpu dla w³a¶ciciela, grupy do której on nale¿y + oraz wszystkich innych. Jedna cyfra mo¿e zostaæ obliczona poprzez + dodanie do siebie potrzebnych uprawnieñ. Cyfra 1 oznacza nadanie + praw do wykonania, cyfra 2 oznacza, ¿e plik bêdzie zapisywalny, cyfra + 4 oznacza, ¿e plik bêdzie mo¿na odczytaæ. Dodaj±c te cyfry + okre¶lamy potrzebne uprawnienia. Wiêcej o prawach w systemie Unix + mo¿na przeczytaæ w 'man 1 chmod' i 'man 2 chmod'. + </para> + <para> + <informalexample> <programlisting role="php"> <![CDATA[ -chmod ("/katalog/plik", 755); // dziesiêtnie; prawdopodobnie nieprawid³owo -chmod ("/katalog/plik", "u+rwx,go+rx"); // ³añcuch; nieprawid³owo -chmod ("/katalog/plik", 0755); // ósemkowo; poprawna warto¶æ dla praw +<?php +// Odczyt i zapis dla w³a¶ciciela, ¿adnych praw dla innych +chmod("/katalog/plik", 0600); + +// Odczyt i zapis dla w³a¶ciciela, odczyt dla wszystkich +chmod("/katalog/plik", 0644); + +// Wszystkie prawa dla w³a¶ciciela, odczyt i wykonanie dla innych +chmod("/katalog/plik", 0755); + +// Wszystkie prawa dla w³a¶ciciela, odczyt i wykonanie dla grupy w³a¶ciciela +chmod("/katalog/plik", 0750); +?> ]]> </programlisting> </informalexample> @@ -37,11 +73,26 @@ <para> &return.success; </para> +<note> + <para> + Bie¿±cy u¿ytkownik to u¿ytkownik pod którym dzia³± PHP. + Prawdpodobnie nie jest to ten sam u¿ytkownik, którego u¿ywasz + normalnie przy dostêpie do shell'a lub FTP. + </para> + </note> + &note.no-remote; + <note> + <simpara> + Kiedy w³±czony jest <link linkend="features.safe-mode">tryb bezpieczny</link>, PHP + sprawdza czy pliki lub katalogi na których maj± zostaæ wykonane operacje + posiadaj± taki sam UID (w³a¶ciciela) jak skrypt, który jest wykonywany. + W dodatku, nie mo¿esz ustawiæ SUI, SGID i bitów lepko¶ci (sticky bits). + </simpara> + </note> <para> Patrz tak¿e: <function>chown</function> i <function>chgrp</function>. </para> - &note.no-windows; </refsect1> </refentry>