cvs: phpdoc-pl /reference/filesystem/functions is-uploaded-file.xml

From: Date: Mon, 31 May 2004 01:03:47 +0000
Subject: cvs: phpdoc-pl /reference/filesystem/functions is-uploaded-file.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-332@lists.php.net to get a copy of this message
leszek Sun May 30 21:03:47 2004 EDT Modified files: /phpdoc-pl/reference/filesystem/functions is-uploaded-file.xml Log: [adi] update to rev. 1.5 http://cvs.php.net/diff.php/phpdoc-pl/reference/filesystem/functions/is-uploaded-file.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-pl/reference/filesystem/functions/is-uploaded-file.xml diff -u phpdoc-pl/reference/filesystem/functions/is-uploaded-file.xml:1.4 phpdoc-pl/reference/filesystem/functions/is-uploaded-file.xml:1.5 --- phpdoc-pl/reference/filesystem/functions/is-uploaded-file.xml:1.4 Fri May 17 09:50:49 2002 +++ phpdoc-pl/reference/filesystem/functions/is-uploaded-file.xml Sun May 30 21:03:47 2004 @@ -1,45 +1,75 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/filesystem.xml, last change in rev 1.1 --> -<!-- last change to 'is-uploaded-file' in en/ tree in rev 1.39 --> -<!-- EN-Revision: 1.2 Maintainer: adi Status: partial --> -<!-- OLD-Revision: 1.115/EN.1.39 --> +<!-- EN-Revision: 1.5 Maintainer: adi Status: ready --> +<!-- $Revision: 1.5 $ --> <refentry id="function.is-uploaded-file"> <refnamediv> <refname>is_uploaded_file</refname> - <refpurpose>Mówi czy plik zosta³ przys³any przez HTTP POST</refpurpose> + <refpurpose>Mówi czy plik zosta³ przys³any przez HTTP POST.</refpurpose> </refnamediv> <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>is_uploaded_file</methodname> - <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam> - </methodsynopsis> - - <para> - Ta funkcja jest dostêpna tylko w wersjach PHP 3 pó¼niejszych od - 3.0.16 i w wersjach PHP 4 pó¼niejszych od 4.0.2. - </para> - + <title>Opis</title> + <methodsynopsis> + <type>bool</type><methodname>is_uploaded_file</methodname> + <methodparam><type>string</type><parameter>nazwa_pliku</parameter></methodparam> + </methodsynopsis> <para> - Zwraca &true; je¶li plik o nazwie <varname>nazwa_pliku</varname> + Zwraca &true; je¶li plik o nazwie <parameter>nazwa_pliku</parameter> zosta³ przys³any (upload) przez HTTP POST. To pomaga upewniæ siê, czy z³o¶liwy u¿ytkownik nie próbuje oszukaæ skryptu pracuj±cego na plikach, tak aby dzia³a³ on na plikach na których nie powinien -- na przyk³ad <filename>/etc/passwd</filename>. </para> - <para> Ten rodzaj testów jest szczególnie wa¿ny je¶li istnieje szansa, ¿e cokolwiek robimy z przys³anymi plikami mo¿e zdradziæ ich tre¶æ u¿ytkownikowi lub nawet innym u¿ytkownikom tego samego systemu. </para> + <para> + <function>is_uploaded_file</function> jest dostêpna tylko w wersjach + PHP 3 pó¼niejszych od PHP 3.0.16, i wersjach PHP 4 pó¼niejszych od 4.0.2. + Je¶li utkno³e¶ przy u¿ywaniu wcze¶niejszej wersji, mo¿esz u¿yæ poni¿szej + funkcji w celu pomocy w zabezpieczeniu siebie: + <note> + <para> + Poni¿szy przyk³ad <emphasis>nie</emphasis> zadzia³a w wersjach + PHP 4 pó¼niejszych od 4.0.2. To jest spowodowane zmian± wewnêtrznej + funkcjonalno¶ci PHP po tej wersji. + </para> + </note> + </para> + <example> + <title><function>is_uploaded_file</function> przyk³ad</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* Userland test for uploaded file. */ + function is_uploaded_file($filename) + { + if (!$tmp_file = get_cfg_var('upload_tmp_dir')) { + $tmp_file = dirname(tempnam('', '')); + } + $tmp_file .= '/' . basename($filename); + /* User might have trailing slash in php.ini... */ + return (ereg_replace('/+', '/', $tmp_file) == $filename); +} +/* Jak u¿yæ tej funkcji, w tych starych wersjach nie masz tak¿e + * move_uploaded_file(): */ +if (is_uploaded_file($HTTP_POST_FILES['userfile'])) { + copy($HTTP_POST_FILES['userfile'], "/place/to/put/uploaded/file"); +} else { + echo "Prawdopodobny atak przez uploadowanie pliku: '$HTTP_POST_FILES[userfile]'."; +} +?> +]]> + </programlisting> + </example> <para> - Patrz tak¿e: <function>move_uploaded_file</function> i sekcjê - <link linkend="features.file-upload">Handling file uploads</link> - aby zobaczyæ przyk³adowe skrypty. + Patrz tak¿e: <function>move_uploaded_file</function> i rozdzia³ + <link linkend="features.file-upload">Obs³uga uploadowanych plików</link> + w celu uzyskania prostych przyk³adów u¿ycia tej funkcji. </para> </refsect1> </refentry>

« previous php.doc.pl (#332) next »