cvs: phpdoc-pl /reference/filesystem/functions is-uploaded-file.xml
| From: | Leszek Krupinski | 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>