cvs: phpdoc /hu/features file-upload.xml

goba Thu Feb 14 14:36:19 2002 EDT Modified files: /phpdoc/hu/features file-upload.xml Log: Getting in sync with latest EN revision

Index: phpdoc/hu/features/file-upload.xml diff -u phpdoc/hu/features/file-upload.xml:1.8 phpdoc/hu/features/file-upload.xml:1.9 --- phpdoc/hu/features/file-upload.xml:1.8 Sat Dec 22 11:15:24 2001 +++ phpdoc/hu/features/file-upload.xml Thu Feb 14 14:36:18 2002 @@ -58,62 +58,35 @@ </para> <para> - PHP-ben a következõ változók jönnek létre a célprogramban - egy sikeres feltöltés után, feltéve, hogy a <link + A változók, amelyek egy sikeres feltöltés során létrejönnek + a PHP változat és beállítás függvényében mások-mások lehetnek. + A következõ változók a feltöltés célprogramjában jönnek létre + egy sikeres feltöltés során. Ha a <link + linkend="ini.track-vars">track_vars</link> beállítást + engedélyezed, a $HTTP_POST_FILES és $_FILES tömbök jönnek + létre. Végül a kapcsolódó változók létrejöhetnek globális + változókként is, ha a <link linkend="ini.register-globals">register_globals</link> - be van kapcsolva a <filename>php.ini</filename> fájlban. Ha - a <link linkend="ini.track-vars">track_vars</link> is - be van kapcsolva, elérhetõek lesznek a - <varname>$HTTP_POST_VARS</varname> globális tömbben is. - Vedd figyelembe, hogy a következõ változónevek - elsõ része onnan származik, hogy a fenti ûrlapban a - 'userfile' nevet adtuk a feltöltõ input elemnek: - - <itemizedlist> - <listitem> - <simpara> - $userfile - Az ideiglenes fájl elérési útja, ahol a - feltöltött fájl tárolásra került a szerveren. - </simpara> - </listitem> - <listitem> - <simpara> - $userfile_name - Az eredeti fájlnév a kliens gépen. - </simpara> - </listitem> - <listitem> - <simpara> - $userfile_size - A feltöltött fájl mérete, byte-ban megadva. - </simpara> - </listitem> - <listitem> - <simpara> - $userfile_type - A fájl MIME típusa, ha a böngészõ megadta ezt - az információt. Például egy gif kép esetében: "image/gif". - </simpara> - </listitem> - </itemizedlist> - - Figyeld meg, hogy a "$userfile" elõtag minden fenti - változóban a form-ban megadott érték, amit a TYPE=file sornál - megadott INPUT elem neveként határoztál meg. A fenti - kérdõívben ezt "userfile"-nak választottuk. - </para> - - <para> - A PHP 4 viselkedése egy kicsit eltér ettõl, mivel egy új - <varname>$HTTP_POST_FILES</varname> globális asszociatív tömbben - is visszaadja a feltöltött fájl információkat. Ez szintén - csak akkor áll rendelkezésre, ha a - <link linkend="ini.track-vars">track_vars</link> be van kapcsolva, - de a <link linkend="ini.track-vars">track_vars</link> a PHP 4.0.2-nél - késõbbi verziókban mindig ba van kapcsolva. + beállítás be van kapcsolva. Ez azonban nem javasolt. </para> - + <note> + <para> + A <link linkend="ini.track-vars">track_vars</link> beállítás + mindig be van kapcsolva a PHP 4.0.3 vagy újabb veziókban. + A PHP 4.1.0 vagy újabb változatokban a $_FILES tömböt + is használhatod a <varname>$HTTP_POST_FILES</varname> helyett. + A <varname>$_FILES</varname> mindig elérhetõ, ezért nem szabad + a <literal>global</literal> kulcsszót használni a $_FILES + változóra függvényekben. + </para> + </note> <para> - A <varname>$HTTP_POST_FILES</varname> tömb tartalma itt következik. - Ebben az esetben is feltételezzük, hogy a fenti ûrlapnak megfelelõen - a 'userfile' nevet adtad a feltöltési input mezõnek: + A <varname>$HTTP_POST_FILES</varname> és a + <varname>$_FILES</varname> változók használata javasolt + a feltöltött állomány információk elérésére. A tömb + tartalma itt következik. Ebben az esetben feltételezzük, + hogy a fenti ûrlapnak megfelelõen a 'userfile' nevet adtad + a feltöltési input mezõnek: <variablelist> <varlistentry> <term><varname>$HTTP_POST_FILES['userfile']['name']</varname></term> @@ -151,7 +124,56 @@ </varlistentry> </variablelist> </para> - + <note> + <para> + A PHP 4.1.0 és újabb verziók a rövidebb nevû + <varname>$_FILES</varname> változót is biztosítják. + A PHP 3 nem biztosítja a + <varname>$HTTP_POST_FILES</varname> változót. + </para> + </note> + + <para> + Ha a <link linkend="ini.register-globals">register_globals</link> + be van kapcsolva a <filename>php.ini</filename> fájlban, + a következõ változók jönnek létre. Ebben az esetben is + feltételezzük, hogy a fenti ûrlapnak megfelelõen a + 'userfile' nevet adtad a feltöltési input mezõnek: + <itemizedlist> + <listitem> + <simpara> + $userfile - Az ideiglenes fájl elérési útja, ahol a + feltöltött fájl tárolásra került a szerveren. + </simpara> + </listitem> + <listitem> + <simpara> + $userfile_name - Az eredeti fájlnév a kliens gépen. + </simpara> + </listitem> + <listitem> + <simpara> + $userfile_size - A feltöltött fájl mérete, byte-okban megadva. + </simpara> + </listitem> + <listitem> + <simpara> + $userfile_type - A fájl MIME típusa, ha a böngészõ megadta ezt + az információt. Például egy gif kép esetében: "image/gif". + </simpara> + </listitem> + </itemizedlist> + Figyeld meg, hogy a "$userfile" elõtag minden fenti + változóban az ûrlapban megadott érték, amit a type="file" + sornál megadott &lt;input&gt; elem neveként határoztál meg. + A fenti kérdõívben ezt "userfile"-nak választottuk. + </para> + <note> + <para> + A <literal>register_globals = On</literal> beállítás + nem ajánlott biztonsági és teljesítmény okok miatt. + </para> + </note> <para> A fájlok alapbeállításban a szerver szokásos ideiglenes könyvtárában tárolódnak, ha nem adtál meg mást az <link @@ -166,53 +188,22 @@ <example> <title>Fájlfeltöltések ellenõrzése</title> <para> - Az alábbi példák PHP 3 esetén a 3.0.16-nál újabb verziókkal - mûködnek, PHP 4 esetén a 4.0.2-nél újabbakkal. Lásd az - <function>is_uploaded_file</function> és + Az alábbi példák a PHP 4.0.2-nél újabb verzióival + mûködnek. Lásd az <function>is_uploaded_file</function> és <function>move_uploaded_file</function> függvényeket. </para> <programlisting role="php"> <![CDATA[ -<?php -if (is_uploaded_file($userfile)) { - copy($userfile, "/a/feltoltott/file/uj/helye"); +<?php +// A PHP 4.1.0 vagy késõbbi verzióiban a $_FILES +// használandó a $HTTP_POST_FILES helyett +if (is_uploaded_file($HTTP_POST_FILES['userfile']['tmp_name'])) { + copy($HTTP_POST_FILES['userfile']['tmp_name'], "/a/feltoltott/file/uj/helye"); } else { - echo "Lehetséges támadás. Fájlnév: '$userfile'."; + echo "Lehetséges támadás. Fájlnév: " . $HTTP_POST_FILES['userfile']['name']; } /* ...vagy... */ -move_uploaded_file($userfile, "/a/feltoltott/file/uj/helye"); -?> -]]> - </programlisting> - <para> - A PHP elõzõ verzióiban valami hasonlót kell csinálnod, mint - amit az alábbiakban bemutatunk. - <note> - <para> - Ez <emphasis>nem</emphasis> fog mûködni a PHP 4-es - 4.0.2-nél újabb verzióiban, mivel egy olyan belsõ - elemre épít, ami a késõbbi verziókban megváltozott. - </para> - </note> - </para> - <programlisting role="php"> -<![CDATA[ -<?php -/* Feltöltött fájl tesztelése */ -function is_uploaded_file($filename) { - if (!$tmp_file = get_cfg_var('upload_tmp_dir')) { - $tmp_file = dirname(tempnam('', '')); - } - $tmp_file .= '/' . basename($filename); - /* lehet, hogy a user befejezõ perjelet adott meg az iniben... */ - return (ereg_replace('/+', '/', $tmp_file) == $filename); -} - -if (is_uploaded_file($userfile)) { - copy($userfile, "/a/feltoltott/file/uj/helye"); -} else { - echo "Lehetséges támadás. Fájlnév: '$userfile'."; -} +move_uploaded_file($HTTP_POST_FILES['userfile']['tmp_name'], "/a/feltoltott/file/uj/helye"); ?> ]]> </programlisting> @@ -222,8 +213,10 @@ A PHP program, ami megkapja a feltöltött fájlt, gondoskodik arról is, hogy a kívánt mûveleteket elvégezze a fájlal. Például törölheti a fájlt, ha az túl nagy, vagy - túl kicsi, figyelembe véve a <varname>$..._size</varname> - változót, vagy meghatározhatja a <varname>$..._type</varname> + túl kicsi, figyelembe véve a + <varname>$HTTP_POST_FILES['userfile']['size']</varname> + változót, vagy meghatározhatja a + <varname>$HTTP_POST_FILES['userfile']['type']</varname> alapján, hogy ez a fájl megfelel-e egy meghatározott fájltípusnak, és ha nem, törölheti. Bármi is a cél a feltöltött fájlal, a PHP szkriptnek kell gondoskodnia @@ -247,6 +240,23 @@ beállítás értéke. Az alapbeállítás 2 megabyte. </simpara> <simpara> + Ha egy memória korlát be van állítva, esetleg növelned kell + a <link linkend="ini.memory-limit">memory_limit</link> értékét. + Gondoskodj a <link linkend="ini.memory-limit">memory_limit</link> + kellõen nagyra állításáról. + </simpara> + <simpara> + Ha a <literal>max_execution_time</literal> túl kicsire van + állítva, a file feltöltési folyamat során letelhet az idõ. + Ezért gondoskodj a <literal>max_execution_time</literal> + kellõen nagyra állítáráról. + </simpara> + <simpara> + Ha a <literal>post_max_size</literal> túl kicsi, nagy állományok + nem tölthetõek fel. Gondoskodj a <literal>post_max_size</literal> + kellõen nagyra állításáról. + </simpara> + <simpara> Ha nem ellenõrzöd a fájlokat, amin mûveleteket végzel, a felhasználói esetleg más könyvtárakhoz is hozzáférhetnek... </simpara> @@ -261,7 +271,14 @@ <sect1 id="features.fileupload.multiple"> <title>Több fájl egyidejû feltöltése</title> <simpara> - Lehetséges több fájl egyidejû feltöltése is. Ebben az + Lehetséges több fájl egyidejû feltöltése is, az + <literal>input</literal> elemek + <literal>name</literal> paramétereinek + különbözõ megadásával. + </simpara> + <simpara> + Úgyszintén lehetõség van több megegyezõ nevû ûrlap + elemmel is több állomány feltöltésére. Ebben az esetben a kapcsolódó információkat tömbökben kapod meg. Ahhoz, hogy ezt elérd, a hagyományos tömb hivatkozást kell alkalmaznod, mint minden más ûrlapelemnél: @@ -290,31 +307,33 @@ <simpara> Amikor a fenti ûrlap adatai elküldésre kerülnek, - a <varname>$userfile</varname> - <varname>$userfile_name</varname> és - <varname>$userfile_size</varname> globális - tömbök létrejönnek. Ezek megtalálhatóak a - $HTTP_POST_FILES tömbben is ($HTTP_POST_VARS tömb - PHP 3-ban). Ezek a tömbök numerikus indexekkel - rendelkeznek. + a <varname>$HTTP_POST_FILES['userfile']</varname> + <varname>$HTTP_POST_FILES['userfile']['name']</varname> és + <varname>$HTTP_POST_FILES['userfile']['size']</varname> + változók értéket kapnak. A $_FILES tömbben ugyanezek elérhetõek + a PHP 4.1.0 és újabb verziókban. Ezek mind számokkal indexelt + tömbök a tömbben beküldötteknek megfelelõ értékekkel. + A PHP 3-asban a $HTTP_POST_VARS használható. Ha a + <literal>register_globals</literal> be van kapcsolva, + globális változókat is kapsz. </simpara> <simpara> Páldául ha a <filename>/home/test/review.html</filename> és <filename>/home/test/xwp.out</filename> fájlok kerültek beküldésre, a - <varname>$userfile_name[0]</varname> tartalma + <varname>$HTTP_POST_FILES['userfile']['name'][0]</varname> tartalma <filename>review.html</filename> és a - <varname>$userfile_name[1]</varname> tartalma + <varname>$HTTP_POST_FILES['userfile']['name'][1]</varname> tartalma <filename>xwp.out</filename>. Hasonló módon a - <varname>$userfile_size[0]</varname> a + <varname>$HTTP_POST_FILES['userfile']['size'][0]</varname> a <filename>review.html</filename> fájl méretét tartalmazza, stb. </simpara> <simpara> - <varname>$userfile['name'][0]</varname>, - <varname>$userfile['tmp_name'][0]</varname>, - <varname>$userfile['size'][0]</varname> és - <varname>$userfile['type'][0]</varname> szintén elérhetõek. + <varname>$HTTP_POST_FILES['userfile']['name'][0]</varname>, + <varname>$HTTP_POST_FILES['userfile']['tmp_name'][0]</varname>, + <varname>$HTTP_POST_FILES['userfile']['size'][0]</varname> és + <varname>$HTTP_POST_FILES['userfile']['type'][0]</varname> szintén elérhetõek. </simpara> </sect1>