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 <input> 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>
