cvs: phpdoc-ru /features file-upload.xml xforms.xml

From: Date: Sun, 30 May 2004 06:30:46 +0000
Subject: cvs: phpdoc-ru /features file-upload.xml xforms.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-348@lists.php.net to get a copy of this message
young Sun May 30 02:30:46 2004 EDT Added files: /phpdoc-ru/features file-upload.xml xforms.xml Log: Add new translated files

http://cvs.php.net/co.php/phpdoc-ru/features/file-upload.xml?r=1.1&p=1 Index: phpdoc-ru/features/file-upload.xml +++ phpdoc-ru/features/file-upload.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.76 Maintainer: young Status: ready --> <chapter id="features.file-upload"> <title> Çàãðóçêà ôàéëîâ íà ñåðâåð</title> <sect1 id="features.file-upload.post-method"> <title>Çàãðóçêà ôàéëîâ ìåòîäîì POST</title> <simpara> PHP ñïîñîáåí ïðèíèìàòü ôàéë çàãðóæàåìûé ïðè ïîìîùè ëþáîãî áðàóçåðà, ïîääåðæèâàþùåãî ñòàíäàðò RFC-1867 (â òîì ÷èñëå <productname>Netscape Navigator 3</productname> è âûøå, <productname>Microsoft Internet Explorer 3</productname> ñ ïàò÷åì îò Microsoft èëè áîëåå ïîçäíèå âåðñèè áåç ïàò÷à). Ýòî äàåò âîçìîæíîñòü çàãðóæàòü êàê òåêñòîâûå, òàê è áèíàðíûå ôàéëû. Âìåñòå ñ PHP-àóòåíòèôèêàöèåé è ôóíêöèÿìè äëÿ ðàáîòû ñ ôàéëîâîé ñèñòåìîé âû ïîëó÷àåòå ïîëíûé êîíòðîëü íàä òåì, êîìó ðàçðåøåíî çàãðóæàòü ôàéëû, è íàä òåì, ÷òî äåëàòü ñ ôàéëîì ïîñëå åãî çàãðóçêè. </simpara> <note> <title>Ñìåæíûå çàìå÷àíèÿ ïî êîíôèãóðàöèè</title> <para> Òàêæå îçíàêîìüòåñü ñ îïèñàíèåì äèðåêòèâ <link linkend="ini.file-uploads">file_uploads</link>, <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link>, è <link linkend="ini.post-max-size">post_max_size</link> êîíôèãóðàöèîííîãî ôàéëà &php.ini; </para> </note> <para> Òàêæå ñëåäóåò çàìåòèòü, ÷òî PHP ïîääåðæèâàåò çàãðóçêó ôàéëîâ ìåòîäîì PUT, êîòîðûé èñïîëüçóåòñÿ â êëèåíòàõ <productname>Netscape Composer</productname> è W3C <productname>Amaya</productname>. Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé äîêóìåíòàöèè îáðàòèòåñü ê ðàçäåëó <link linkend="features.file-upload.put-method">ïîääåðæêà ìåòîäà PUT</link> </para> <para> Ñòðàíèöà äëÿ çàãðóçêè ôàéëîâ ìîæåò áûòü ðåàëèçîâàíà ïðè ïîìîùè ñïåöèàëüíîé ôîðìû, êîòîðàÿ âûãëÿäèò ïðèìåðíî òàê: </para> <para> <example> <title>Ôîðìà äëÿ çàãðóçêè ôàéëîâ</title> <programlisting role="html"> <![CDATA[ <form enctype="multipart/form-data" action="_URL_" method="post"> <input type="hidden" name="MAX_FILE_SIZE" value="30000" /> Îòïðàâèòü ýòîò ôàéë: <input name="userfile" type="file" /> <input type="submit" value="Send File" /> </form> ]]> </programlisting> </example> </para> <para>  ïðèâåäåííîì âûøå ïðèìåðå "_URL_" íåîáõîäèìî çàìåíèòü ññûëêîé íà PHP-ñêðèïò. Ñêðûòîå ïîëå <literal>MAX_FILE_SIZE</literal>(çíà÷åíèå íåîáõîäèìî óêàçûâàòü â áàéòàõ) äîëæíî ïðåäøåñòâîâàòü ïîëþ äëÿ âûáîðà ôàéëà, è åãî çíà÷åíèå ÿâëÿåòñÿ ìàêñèìàëüíî äîïóñòèìûì ðàçìåðîì ïðèíèìàåìîãî ôàéëà. Òàêæå ñëåäóåò óáåäèòüñÿ, ÷òî â àòðèáóòàõ ôîðìû âû óêàçàëè <literal>enctype="multipart/form-data"</literal>, â ïðîòèâíîì ñëó÷àå çàãðóçêà ôàéëîâ íà ñåðâåð âûïîëíÿòüñÿ íå áóäåò. <warning> <para> Îïöèÿ <literal>MAX_FILE_SIZE</literal> ÿâëÿåòñÿ ðåêîìåíäàöèåé áðàóçåðó, äàæå åñëè áû PHP òàêæå ïðîâåðÿë ýòî óñëîâèå. Îáîéòè ýòî îãðàíè÷åíèå íà ñòîðîíå áðàóçåðà äîñòàòî÷íî ïðîñòî, ñëåäîâàòåëüíî, âû íå äîëæíû ïîëàãàòüñÿ íà òî, ÷òî âñå ôàéëû áîëüøåãî ðàçìåðà áóäóò áëîêèðîâàíû ïðè ïîìîùè ýòîé âîçìîæíîñòè. Òåì íå ìåíåå, îãðàíè÷åíèå PHP êàñàòåëüíî ìàêñèìàëüíîãî ðàçìåðà îáîéòè íåâîçìîæíî. Âû â ëþáîì ñëó÷àå äîëæíû äîáàâëÿòü ïåðåìåííóþ ôîðìû <literal>MAX_FILE_SIZE</literal>, òàê êàê îíà ïðåäîòâðàùàåò òðåâîæíîå îæèäàíèå ïîëüçîâàòåëåé ïðè ïåðåäà÷å îãðîìíûõ ôàéëîâ, òîëüêî äëÿ òîãî, ÷òîáû óçíàòü, ÷òî ôàéë ñëèøêîì áîëüøîé è ïåðåäà÷à ôàêòè÷åñêè íå ñîñòîÿëàñü. </para> </warning> </para> <para> Ïåðåìåííûå, îïðåäåëåííûå äëÿ çàãðóæåííûõ ôàéëîâ, çàâèñÿò îò âåðñèè PHP è òåêóùåé êîíôèãóðàöèè. Ñóïåðãëîáàëüíûé ìàññèâ <link linkend="reserved.variables.files">$_FILES</link> äîñòóïåí íà÷èíàÿ ñ PHP 4.1.0. Ìàññèâ <varname>$HTTP_POST_FILES</varname> äîñòóïåí íà÷èíàÿ ñ PHP 4.0.0. Ýòè ìàññèâû ñîäåðæàò âñþ èíôîðìàöèþ î çàãðóæåííûõ ôàéëàõ. Èñïîëüçîâàíèå <varname>$_FILES</varname> ÿâëÿåòñÿ áîëåå ïðåäïî÷òèòåëüíûì.  ñëó÷àå, åñëè êîíôèãóðàöèîííàÿ äèðåêòèâà <link linkend="ini.register-globals">register_globals</link> óñòàíîâëåíà çíà÷åíèåì <emphasis>on</emphasis>, äîïîëíèòåëüíî áóäóò îáúÿâëåíû ïåðåìåííûå ñ ñîîòâåòñòâóþùèìè èìåíàìè. Íà÷èíàÿ ñ âåðñèè <ulink url="&url.php.release4.2.0;">4.2.0</ulink> çíà÷åíèåì ïî óìîë÷àíèþ äëÿ îïöèè <link linkend="ini.register-globals">register_globals</link> ÿâëÿåòñÿ <emphasis>off</emphasis>. </para> <para> Ñîäåðæèìîå ìàññèâà <link linkend="reserved.variables.files">$_FILES</link> äëÿ íàøåãî ïðèìåðà ïðèâåäåíî íèæå. Îáðàòèòå âíèìàíèå, ÷òî çäåñü ïðåäïîëàãàåòñÿ èñïîëüçîâàíèå èìåíè <emphasis>userfile</emphasis> äëÿ ïîëÿ âûáîðà ôàéëà, êàê è â ïðèâåäåííîì âûøå ïðèìåðå. Íà ñàìîì äåëå èìÿ ïîëÿ ìîæåò áûòü ëþáûì. <variablelist> <varlistentry> <term><varname>$_FILES['userfile']['name']</varname></term> <listitem> <para> Îðèãèíàëüíîå èìÿ ôàéëà íà êîìïüþòåðå êëèåíòà. </para> </listitem> </varlistentry> <varlistentry> <term><varname>$_FILES['userfile']['type']</varname></term> <listitem> <para> Mime-òèï ôàéëà, â ñëó÷àå, åñëè áðàóçåð ïðåäîñòàâèë òàêóþ èíôîðìàöèþ. Ïðèìåð: <literal>"image/gif"</literal>. </para> </listitem> </varlistentry> <varlistentry> <term><varname>$_FILES['userfile']['size']</varname></term> <listitem> <para> Ðàçìåð â áàéòàõ ïðèíÿòîãî ôàéëà. </para> </listitem> </varlistentry> <varlistentry> <term><varname>$_FILES['userfile']['tmp_name']</varname></term> <listitem> <para> Âðåìåííîå èìÿ, ñ êîòîðûì ïðèíÿòûé ôàéë áûë ñîõðàíåí íà ñåðâåðå. </para> </listitem> </varlistentry> <varlistentry> <term><varname>$_FILES['userfile']['error']</varname></term> <listitem> <para> <link linkend="features.file-upload.errors">Êîä îøèáêè</link>, êîòîðàÿ ìîæåò âîçíèêíóòü ïðè çàãðóçêå ôàéëà. Êëþ÷ <emphasis>['error']</emphasis> áûë äîáàâëåí â PHP 4.2.0 </para> </listitem> </varlistentry> </variablelist> </para> <note> <para>  PHP 4.1.0 è áîëåå ðàííèõ âåðñèÿõ îïèñàííûé âûøå ìàññèâ íàçûâàëñÿ <varname>$HTTP_POST_FILES</varname> è íå ÿâëÿëñÿ <link linkend="language.variables.superglobals">ñóïåðãëîáàëüíûì</link>, â îòëè÷èå îò <varname>$_FILES</varname>.  PHP 3 ìàññèâ <varname>$HTTP_POST_FILES</varname> íå îïðåäåëåí. </para> </note> <para>  ñëó÷àå, åñëè <link linkend="ini.register-globals">register_globals</link> óñòàíîâëåíà çíà÷åíèåì <emphasis>on</emphasis> â êîíôèãóðàöèîííîì ôàéëå &php.ini;, áóäóò äîñòóïíû äîïîëíèòåëüíûå ïåðåìåííûå. Íàïðèìåð, <varname>$userfile_name</varname> áóäåò ýêâèâàëåíòíà ïåðåìåííîé <varname>$_FILES['userfile']['name']</varname>, à <varname>$userfile_type</varname> ñîîòâåòñòâóåò <varname>$_FILES['userfile']['type']</varname>, è òàê äàëåå. Íå ñòîèò çàáûâàòü, ÷òî íà÷èíàÿ ñ PHP 4.2.0 äëÿ äèðåêòèâû register_globals çíà÷åíèå ïî óìîë÷àíèþ <emphasis>off</emphasis>. Ðåêîìåíäóåòñÿ íå ïîëàãàòüñÿ íà çíà÷åíèå ýòîé äèðåêòèâû. </para> <para> Ïî óìîë÷àíèþ ïðèíÿòûå ôàéëû ñîõðàíÿþòñÿ íà ñåðâåðå â ñòàíäàðòíîé âðåìåííîé ïàïêå äî òåõ ïîð, ïîêà íå áóäåò çàäàíà äðóãàÿ äèðåêòîðèÿ ïðè ïîìîùè äèðåêòèâû <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> êîíôèãóðàöèîííîãî ôàéëà &php.ini;. Äèðåêòîðèþ ñåðâåðà ïî óìîë÷àíèþ ìîæíî ñìåíèòü, óñòàíîâèâ ïåðåìåííóþ <envar>TMPDIR</envar> äëÿ îêðóæåíèÿ, â êîòîðîì âûïîëíÿåòñÿ PHP. Óñòàíîâêà ïåðåìåííîé <envar>TMPDIR</envar> ïðè ïîìîùè ôóíêöèè <function>putenv</function> âíóòðè PHP-ñêðèïòà ðàáîòàòü íå áóäåò. Ýòà ïåðåìåííàÿ îêðóæåíèÿ òàêæå ìîæåò èñïîëüçîâàòüñÿ äëÿ òîãî, ÷òîáû óäîñòîâåðèòüñÿ, ÷òî äðóãèå îïåðàöèè òàêæå ðàáîòàþò ñ ïðèíÿòûìè ôàéëàìè. <example> <title>Ïðîâåðêà çàãðóæàåìûõ íà ñåðâåð ôàéëîâ</title> <para> Äëÿ ïîëó÷åíèÿ áîëåå äåòàëüíîé èíôîðìàöèè âû ìîæåòå îçíàêîìèòñÿ ñ îïèñàíèåì ôóíêöèé <function>is_uploaded_file</function> è <function>move_uploaded_file</function>. Ñëåäóþùèé ïðèìåð ïðèíèìàåò è îáðàáàòûâàåò çàãðóæåííûé ïðè ïîìîùè ôîðìû ôàéë. </para> <programlisting role="php"> <![CDATA[ <?php //  PHP 4.1.0 è áîëåå ðàííèõ âåðñèÿõ ñëåäóåò èñïîëüçîâàòü $HTTP_POST_FILES // âìåñòî $_FILES. $uploaddir = '/var/www/uploads/'; $uploadfile = $uploaddir . $_FILES['userfile']['name']; print "<pre>"; if (move_uploaded_file($_FILES['userfile']['tmp_name'], $uploadfile)) { print "File is valid, and was successfully uploaded. "; print "Here's some more debugging info:\n"; print_r($_FILES); } else { print "Possible file upload attack! Here's some debugging info:\n"; print "Possible file upload attack! Äîïîëíèòåëüíàÿ îòëàäî÷íàÿ èíôîðìàöèÿ:\n"; print_r($_FILES); } print "</pre>"; ?> ]]> </programlisting> </example> </para> <simpara> PHP-ñêðèïò, ïðèíèìàþùèé çàãðóæåííûé ôàéë, äîëæåí ðåàëèçîâûâàòü ëîãèêó, íåîáõîäèìóþ äëÿ îïðåäåëåíèÿ äàëüíåéøèõ äåéñòâèé íàä ïðèíÿòûì ôàéëîì. Íàïðèìåð, âû ìîæåòå ïðîâåðèòü ïåðåìåííóþ <varname>$_FILES['userfile']['size']</varname>, ÷òîáû îòñå÷ü ñëèøêîì áîëüøèå èëè ñëèøêîì ìàëåíüêèå ôàéëû. Òàêæå âû ìîæåòå èñïîëüçîâàòü ïåðåìåííóþ <varname>$_FILES['userfile']['type']</varname> äëÿ èñêëþ÷åíèÿ ôàéëîâ, êîòîðûå íå óäîâëåòâîðÿþò êðèòåðèþ êàñàòåëüíî òèïà ôàéëà. Íà÷èíàÿ ñ PHP 4.2.0 âû ìîæåòå èñïîëüçîâàòü <varname>$_FILES['userfile']['error']</varname> è <link linkend="features.file-upload.errors">ðàçúÿñíåíèå ñîîáùåíèé îá îøèáêàõ</link> ïðè ðåàëèçàöèè âàøåé ëîãèêè. Íåçàâèñèìî îò òîãî, êàêóþ ìîäåëü ïîâåäåíèÿ âû âûáðàëè, âû äîëæíû óäàëèòü ôàéë èç âðåìåííîé ïàïêè èëè ïåðåìåñòèòü åãî â äðóãóþ äèðåêòîðèþ. </simpara> <simpara>  ñëó÷àå, åñëè ïðè îòïðàâêå ôîðìû ôàéë âûáðàí íå áûë, PHP óñòàíîâèò ïåðåìåííóþ <varname>$_FILES['userfile']['size']</varname> çíà÷åíèåì 0, à ïåðåìåííóþ <varname>$_FILES['userfile']['tmp_name']</varname> - ïóñòîé ñòðîêîé. none. </simpara> <simpara> Ïî îêîí÷àíèþ ðàáîòû ñêðèïòà, â ñëó÷àå, åñëè ïðèíÿòûé ôàéë íå áûë ïåðåèìåíîâàí, èëè ïåðåìåùåí îí áóäåò àâòîìàòè÷åñêè óäàëåí èç âðåìåííîé ïàïêè. </simpara> </sect1> <sect1 id="features.file-upload.errors"> <title>Ðàçúÿñíåíèå ñîîáùåíèé îá îøèáêàõ</title> <simpara> Íà÷èíàÿ ñ PHP 4.2.0, PHP âîçâðàùàåò êîä îøèáêè íàðÿäó ñ äðóãèìè àòðèáóòàìè ïðèíÿòîãî ôàéëà. Îí ðàñïîëîæåí â ìàññèâå, ñîçäàâàåìîì PHP ïðè çàãðóçêå ôàéëà, è ìîæåò áûòü ïîëó÷åí ïðè îáðàùåíèè ïî êëþ÷ó <emphasis>['error']</emphasis>. Ãîâîðÿ äðóãèìè ñëîâàìè, êîä îøèáêè ìîæíî íàéòè â ïåðåìåííîé <varname>$_FILES['userfile']['error']</varname>. </simpara> <para> <variablelist> <varlistentry> <term><constant>UPLOAD_ERR_OK</constant></term> <listitem> <para> Çíà÷åíèå: 0; Îøèáîê íå âîçíèêàëî, ôàéë áûë óñïåøíî çàãðóæåí íà ñåðâåð. </para> </listitem> </varlistentry> <varlistentry> <term><constant>UPLOAD_ERR_INI_SIZE</constant></term> <listitem> <para> Çíà÷åíèå: 1; Ðàçìåð ïðèíÿòîãî ôàéëà ïðåâûñèë ìàêñèìàëüíî äîïóñòèìûé ðàçìåð, êîòîðûé çàäàí äèðåêòèâîé <link linkend="ini.upload-max-filesize">upload_max_filesize</link> êîíôèãóðàöèîííîãî ôàéëà &php.ini;. </para> </listitem> </varlistentry> <varlistentry> <term><constant>UPLOAD_ERR_FORM_SIZE</constant></term> <listitem> <para> Çíà÷åíèå: 2; Ðàçìåð çàãðóæàåìîãî ôàéëà ïðåâûñèë çíà÷åíèå <emphasis>MAX_FILE_SIZE</emphasis>, óêàçàííîå â HTML-ôîðìå. </para> </listitem> </varlistentry> <varlistentry> <term><constant>UPLOAD_ERR_PARTIAL</constant></term> <listitem> <para> Çíà÷åíèå: 3; Çàãðóæàåìûé ôàéë áûë ïîëó÷åí òîëüêî ÷àñòè÷íî. </para> </listitem> </varlistentry> <varlistentry> <term><constant>UPLOAD_ERR_NO_FILE</constant></term> <listitem> <para> Çíà÷åíèå: 4; Ôàéë íå áûë çàãðóæåí. </para> </listitem> </varlistentry> </variablelist> </para> <note> <para> Êîíñòàíòû áûëè äîáàâëåíû â PHP 4.3.0. </para> </note> </sect1> <sect1 id="features.file-upload.common-pitfalls"> <title>Íàèáîëåå ðàñïðîñòðàíåííûå îøèáêè</title> <simpara> Îïöèÿ <literal>MAX_FILE_SIZE</literal> íå äîëæíà ïîçâîëÿòü ïåðåäà÷ó ôàéëîâ, ðàçìåð êîòîðûõ ïðåâûøàåò ëèìèò, óñòàíîâëåííûé êîíôèãóðàöèîííîé äèðåêòèâîé <link linkend="ini.upload-max-filesize">upload_max_filesize</link>. Îãðàíè÷åíèå ïî óìîë÷àíèþ ñîñòàâëÿåò 2 ìåãàáàéòà. </simpara> <simpara>  ñëó÷àå, åñëè óñòàíîâëåíî îãðàíè÷åíèÿ ïàìÿòè, âàì ìîæåò ïîíàäîáèòüñÿ óâåëè÷èòü çíà÷åíèå îïöèè <link linkend="ini.memory-limit">memory_limit</link>. Óáåäèòåñü â òîì, ÷òî çíà÷åíèå <link linkend="ini.memory-limit">memory_limit</link> äîñòàòî÷íî âåëèêî. </simpara> <simpara>  ñëó÷àå, åñëè îïöèÿ <link linkend="ini.max-execution-time">max_execution_time</link> óñòàíîâëåíà ñëèøêîì ìàëåíüêèì çíà÷åíèåì, íåîáõîäèìîå âðåìÿ ðàáîòû ñêðèïòà ìîæåò ïðåâûøàòü ýòî çíà÷åíèå. Óáåäèòåñü â òîì, ÷òî çíà÷åíèå <literal>max_execution_time</literal> äîñòàòî÷íî âåëèêî. </simpara> <note> <simpara> Äèðåêòèâà <link linkend="ini.max-execution-time">max_execution_time</link> only êàñàåòñÿ èñêëþ÷èòåëüíî âðåìåíè, èñïîëüçóåìîãî íåïîñðåäñòâåííî ñàìèì ñêðèïòîì. Âðåìÿ, ïîòðà÷åííîå íà âíåøíèå äåéñòâèÿ, òàêèå êàê ñèñòåìíûå âûçîâû ïðè ïîìîùè ôóíêöèè <function>system</function> èëè <function>sleep</function>, îáðàùåíèÿ ê áàçå äàííûõ, à òàêæå âðåìÿ, ïîòðà÷åííîå íà çàãðóçêó ôàéëà è äðóãèå äåéñòâèÿ, ïðîèñõîäÿùèå âíå ñêðèïòà, íå ó÷èòûâàþòñÿ ïðè îïðåäåëåíèè ìàêñèìàëüíî äîïóñòèìîãî ïðîìåæóòêà âðåìåíè, îòâåäåííîãî äëÿ âûïîëíåíèÿ ñêðèïòà. </simpara> </note> <simpara> Äèðåêòèâà <link linkend="ini.max-input-time">max_input_time</link> óêàçûâàåò ìàêñèìàëüíî äîïóñòèìîå âðåìÿ â ñåêóíäàõ äëÿ ïîëó÷åíèÿ âõîäÿùèõ äàííûõ, â òîì ÷èñëå è çàãðóæàåìûõ ôàéëîâ.  ñëó÷àå, åñëè âû èìååòå äåëî ñ íåñêîëüêèìè èëè áîëüøèìè ôàéëàìè, ëèáî óäàëåííûå ïîëüçîâàòåëè èñïîëüçóþò ìåäëåííûé êàíàë, îãðàíè÷åíèå ïî óìîë÷àíèþ â <literal>60 ñåêóíä</literal> ìîæåò áûòü ïðåâûøåíî. </simpara> <simpara> Åñëè äèðåêòèâà <link linkend="ini.post-max-size">post_max_size</link> óñòàíîâëåíà ñëèøêîì ìàëåíüêèì çíà÷åíèåì, áîëüøèå ôàéëû íå ñìîãóò áûòü çàãðóæåíû íà ñåðâåð. Óáåäèòåñü, ÷òî çíà÷åíèå äèðåêòèâû <literal>post_max_size</literal> äîñòàòî÷íî âåëèêî. </simpara> <simpara> Åñëè íå ïðîâåðÿòü, ñ êàêèìè ôàéëàìè âû ðàáîòàåòå, ïîëüçîâàòåëè ìîãóò ïîëó÷èòü äîñòóï ê êîíôèäåíöèàëüíîé èíôîðìàöèè, ðàñïîëîæåííîé â äðóãèõ äèðåêòîðèÿõ. </simpara> <simpara> Ñëåäóò çàìåòèòü, ÷òî <productname>CERN httpd</productname> ìîæåò îòñå÷ü âñå, ÷òî èäåò ïîñëå ïåðâîãî ïðîáåëà â ïîëó÷àåìîì îò êëèåíòà çàãîëîâêå content-type. Åñëè ó âàñ èìåííî òàêîé ñëó÷àé, <productname>CERN httpd</productname> íå áóäåò ïîääåðæèâàòü âîçìîæíîñòü çàãðóçêè ôàéëîâ. </simpara> <simpara> Ïîñêîëüêó ðàçíûå ñèñòåìû ïî-ðàçíîìó ðàáîòàþò ñ ôàéëîâîé ñòðóêòóðîé, ó âàñ íåò íèêàêèõ ãàðàíòèé òîãî, ÷òî ôàéëû ñ ýêçîòè÷åñêèìè èìåíàìè (íàïðèìåð, êîòîðûå ñîäåðæàò ïðîáåëüíûå ñèìâîëû) áóäóò îáðàáîòàíû êîððåêòíî. </simpara> <simpara> Ðàçðàáîò÷èêè íå äîëæíû èñïîëüçîâàòü îäèíàêîâûå èìåíà äëÿ ïîëåé ââîäà è ïîëåé âûáîðà ôàéëà â ïðåäåëàõ îäíîé è òîé æå ôîðìû (íàïðèìåð, èñïîëüçóÿ èìÿ âèäà <literal>foo[]</literal>). </simpara> </sect1> <sect1 id="features.file-upload.multiple"> <title>Çàãðóçêà íà ñåðâåð íåñêîëüêèõ ôàéëîâ</title> <simpara> Çàãðóçêó íåñêîëüêèõ ôàéëîâ ìîæíî ðåàëèçîâàòü èñïîëüçóÿ, íàïðèìåð, ðàçëè÷íûå çíà÷åíèÿ <literal>name</literal> äëÿ òåãà <literal>input</literal>. </simpara> <simpara> Òàêæå ïðåäóñìîòðåíà âîçìîæíîñòü àâòîìàòè÷åñêîãî ïîëó÷åíèÿ îðãàíèçîâàííîé â ìàññèâ èíôîðìàöèè î íåñêîëüêèõ îäíîâðåìåííî çàãðóæàåìûõ ôàéëàõ. Äëÿ ðåàëèçàöèè òàêîé âîçìîæíîñòè èñïîëüçóéòå òîò æå ñèíòàêñèñ îòïðàâêè ìàññèâà èç HTML-ôîðìû, ÷òî è äëÿ ìíîæåñòâåííûõ ïîëåé <literal>select</literal> è <literal>checkbox</literal>: </simpara> <note> <para> Ïîääåðæêà çàãðóçêè íåñêîëüêèõ ôàéëîâ áûëà äîáàâëåíà â PHP 3.0.10. </para> </note> <para> <example> <title>Çàãðóçêà íåñêîëüêèõ ôàéëîâ</title> <programlisting role="html"> <![CDATA[ <form action="file-upload.php" method="post" enctype="multipart/form-data"> Send these files:<br /> <input name="userfile[]" type="file" /><br /> <input name="userfile[]" type="file" /><br /> <input type="submit" value="Send files" /> </form> ]]> </programlisting> </example> </para> <simpara>  ñëó÷àå, åñëè òàêàÿ ôîðìà áûëà îòïðàâëåíà, ìàññèâû <varname>$_FILES['userfile']</varname>, <varname>$_FILES['userfile']['name']</varname>, è <varname>$_FILES['userfile']['size']</varname> áóäóò èíèöèàëèçèðîâàíû (òî÷íî òàê æå, êàê è <varname>$HTTP_POST_FILES</varname> äëÿ PHP 4.1.0 è áîëåå ðàííèõ âåðñèé). Åñëè êîíôèãóðàöèîííàÿ äèðåêòèâà <link linkend="ini.register-globals">register_globals</link> óñòàíîâëåíà çíà÷åíèåì <literal>on</literal>, òàêæå áóäóò èíèöèàëèçèðîâàíû ñîïóòñòâóþùèå ãëîáàëüíûå ïåðåìåííûå. Êàæäàÿ èç òàêèõ ïåðåìåííûõ áóäåò ïðåäñòàâëÿòü ñîáîé ÷èñëåííî èíäåêñèðîâàííûé ìàññèâ ñîîòâåòñòâóþùèõ çíà÷åíèé äëÿ ïðèíÿòûõ ôàéëîâ. </simpara> <simpara> Íàïðèìåð, ïðåäïîëîæèì, ÷òî áûëè çàãðóæåíû ôàéëû <filename>/home/test/review.html</filename> è <filename>/home/test/xwp.out</filename>.  òàêîì ñëó÷àå ïåðåìåííàÿ <varname>$_FILES['userfile']['name'][0]</varname> áóäåò óñòàíîâëåíà çíà÷åíèåì <filename>review.html</filename>, à ïåðåìåííàÿ <varname>$_FILES['userfile']['name'][1]</varname> - çíà÷åíèåì <filename>xwp.out</filename>. Àíàëîãè÷íî, ïåðåìåííàÿ <varname>$_FILES['userfile']['size'][0]</varname> áóäåò ñîäåðæàòü ðàçìåð ôàéëà <filename>review.html</filename> è òàê äàëåå. </simpara> <simpara> Ïåðåìåííûå <varname>$_FILES['userfile']['name'][0]</varname>, <varname>$_FILES['userfile']['tmp_name'][0]</varname>, <varname>$_FILES['userfile']['size'][0]</varname> è <varname>$_FILES['userfile']['type'][0]</varname> òàêæå áóäóò èíèöèàëèçèðîâàíû. </simpara> </sect1> <sect1 id="features.file-upload.put-method"> <title>Ïîääåðæêà ìåòîäà PUT</title> <simpara> Ïîääåðæêà ìåòîäà PUT áûëà èçìåíåíà ïðè ïåðåõîäå îò PHP 3 ê PHP 4.  PHP 4 âû äîëæíû èñïîëüçîâàòü ñòàíäàðòíûé ïîòîê ââîäà äëÿ ÷òåíèÿ ôàéëà, ïåðåäàâàåìîãî ìåòîäîì HTTP PUT. </simpara> <para> <example> <title>Ñîõðàíåíèå çàãðóæåííîãî ïðè ïîìîùè HTTP PUT ôàéëà â PHP 4</title> <programlisting role="php"> <![CDATA[ <?php /* Äàííûå PUT íàõîäÿòñÿ â ïîòîêå stdin */ $putdata = fopen("php://stdin", "r"); /* Îòêðûâàåì ôàéë äëÿ çàïèñè */ $fp = fopen("myputfile.ext", "w"); /* ×èòàåì äàííûå áëîêàìè ðàçìåðîì â 1 KB è çàïèñûâàåì èõ â ôàéë */ while ($data = fread($putdata, 1024)) fwrite($fp, $data); /* Çàêðûâàåì ïîòîêè */ fclose($fp); fclose($putdata); ?> ]]> </programlisting> </example> </para> <note> <para> Âñÿ äîêóìåíòàöèÿ, ïðèâåäåííàÿ íèæå, êàñàåòñÿ èñêëþ÷èòåëüíî PHP 3. </para> </note> <para> PHP ïîääåðæèâàåò çàãðóçêó ôàéëîâ ìåòîäîì HTTP PUT, êîòîðûé èñïîëüçóåòñÿ â êëèåíòàõ <productname>Netscape Composer</productname> è <productname>W3C Amaya</productname>. Çàïðîñ PUT âûãëÿäèò ïðîùå, ÷åì â ñëó÷àå îáûêíîâåííîé çàãðóçêè ôàéëà íà ñåðâåð: <informalexample> <programlisting> PUT /path/filename.html HTTP/1.1 </programlisting> </informalexample> </para> <para> Òàêîé âûçîâ îçíà÷àåò, ÷òî óäàëåííûé êëèåíò õîòåë áû ñîõðàíèòü ôàéë ïîä èìåíåì <filename>/path/filename.html</filename> â äåðåâå êàòàëîãîâ âàøåãî âåá-ñåðâåðà. Î÷åâèäíî, ÷òî âîçìîæíîñòü êëèåíòà àâòîìàòè÷åñêè ïåðåçàïèñûâàòü ôàéëû âàøåãî âåá-ñåðâåðà ïðè ïîìîùè Apache èëè PHP íå ÿâëÿåòñÿ õîðîøèì ðåøåíèåì. Ïîýòîìó äëÿ òîãî, ÷òîáû îáðàáàòûâàòü òàêèå çàïðîñû, âàì íåîáõîäèìî óêàçàòü âåá-ñåðâåðó PHP-ñêðèïò, êîòîðîìó âû äîâåðÿåòå èõ îáðàáîòêó.  âåá-ñåðâåðå Apache âû ìîæåòå ñäåëàòü ýòî, èñïîëüçóÿ äèðåêòèâó <emphasis>Script</emphasis>. Îíà ìîæåò íàõîäèòüñÿ ïðàêòè÷åñêè â ëþáîì ìåñòå êîíôèãóðàöèîííîãî ôàéëà Apache. Êàê ïðàâèëî, ýòà äèðåêòèâà ðàñïîëîæåíà âíóòðè áëîêà &lt;Directory&gt; èëè æå âíóòðè áëîêà &lt;Virtualhost&gt;. Ñàìà çàïèñü âûãëÿäèò ñëåäóþùèì îáðàçîì: <informalexample> <programlisting> Script PUT /put.php </programlisting> </informalexample> </para> <simpara> Ýòî óêàçûâàåò âåá-ñåðâåðó Apache íà íåîáõîäèìîñòü ïåðåíàïðàâëÿòü ïî óêàçàííîìó àäðåñó âñå PUT-çàïðîñû, êîíòåêñò êîòîðûõ ñîâïàäàåò ñ êîíòåêñòîì, â êîòîðûì âû ðàçìåñòèëè ýòó ñòðîêó. Ïðåäïîëàãàåòñÿ, ÷òî ôàéëû ñ ðàñøèðåíèåì .php îáðàáàòûâàþòñÿ, êàê PHP-ñêðèïòû, è ÷òî ñàì PHP óñòàíîâëåí è ðàáîòàåò. </simpara> <simpara> Âíóòðè âàøåãî ôàéëà put.php file âû ìîæåòå ïîìåñòèòü ÷òî-íèáóäü ïîõîæåå íà ýòî: </simpara> <para> <informalexample><programlisting role="php"> <![CDATA[ <?php copy($PHP_UPLOADED_FILE_NAME, $DOCUMENT_ROOT . $REQUEST_URI); ?> ]]> </programlisting></informalexample> </para> <simpara> Ïðèâåäåííûé êîä ñêîïèðóåò ôàéë â ìåñòî, çàïðîøåííîå êëèåíòîì. Âîçìîæíî, âû çàõîòèòå âûïîëíèòü êàêóþ-ëèáî ïðîâåðêó è/èëè àóòåíòèôèöèðîâàòü ïîëüçîâàòåëÿ, ïðåæäå ÷åì âûïîëíÿòü êîïèðîâàíèå. Òðþê ñîñòîèò â òîì, ÷òî êîãäà PHP âèäèò PUT-çàïðîñ, îí ñîõðàíÿåò ïîëó÷åííûé ôàéë âî âðåìåííîé ïàïêå, êàê è ïðè <link linkend="features.file-upload.post-method">çàãðóçêå ìåòîäîì POST</link>. Ïî îêîí÷àíèè îáðàáîòêè çàïðîñà âðåìåííûé ôàéë óäàëÿåòñÿ. Ïîýòîìó âàø PHP-ñêðèïò, îáðàáàòûâàþùèé PUT-çàïðîñ, äîëæåí ñêîïèðîâàòü êóäà-ëèáî ïîëó÷åííûé ôàéë. Èìÿ âðåìåííîãî ôàéëà õðàíèòñÿ â ïåðåìåííîé <varname>$PHP_PUT_FILENAME</varname>, à ïðåäïîëàãàåìîå èìÿ ôàéëà ìîæíî íàéòè â ïåðåìåííîé <varname>$REQUEST_URI</varname> (ìîæåò áûòü äðóãèì íà âåá-ñåðâåðàõ, îòëè÷íûõ îò Apache). Çàïðàøèâàåìîå èìÿ ôàéëà óêàçûâàåòñÿ óäàëåííûì êëèåíòîì. Âû íå îáÿçàíû ñëåäîâàòü åãî óêàçàíèÿì. Íàïðèìåð, âû ìîæåòå ñêîïèðîâàòü âñå çàãðóæåííûå ôàéëû â îòäåëüíûé êàòàëîã. </simpara> </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ru/features/xforms.xml?r=1.1&p=1 Index: phpdoc-ru/features/xforms.xml +++ phpdoc-ru/features/xforms.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: young Status: ready --> <chapter id="features.xforms"> <title>Ðàáîòà ñ XForms</title> <para> <ulink url="&url.xforms;">XForms</ulink> ÿâëÿþòñÿ àëüòåðíàòèâîé òðàäèöèîííûì âåá-ôîðìàì, è ïîçâîëÿþò èñïîëüçîâàòü èõ íà ìíîæåñòâå ïëàòôîðì è áðàóçåðîâ, à òàêæå ðåàëèçîâûâàòü íåñòàíäàðòíûå ïðåäñòàâëåíèÿ ôîðì, íàïðèìåð, â âèäå PDF-äîêóìåíòà. </para> <para> Ïåðâîå ñóùåñòâåííîå îòëè÷èå XForms çàêëþ÷àåòñÿ â òîì, êàê ôîðìà îòñûëàåòñÿ êëèåíòó. Ðóêîâîäñòâî <ulink url="&url.xforms.htmlauthors;">XForms äëÿ HTML-âåðñòàëüùèêîâ</ulink> ñîäåðæèò äåòàëüíîå îïèñàíèå ñîçäàíèÿ XForms. Äëÿ òîãî, ÷òîáû î÷åðòèòü îñíîâíóþ èäåþ ðóêîâîäñòâà, ïðèâåäåì íåñêîëüêî ïðîñòûõ ïðèìåðîâ. </para> <example> <title>Ïðîñòàÿ XForms äëÿ ïîèñêîâîé ôîðìû</title> <programlisting role="html"> <![CDATA[ <h:html xmlns:h="http://www.w3.org/1999/xhtml" xmlns="http://www.w3.org/2002/xforms"> <h:head> <h:title>Search</h:title> <model> <submission action="http://example.com/search" method="post" id="s"/> </model> </h:head> <h:body> <h:p> <input ref="q"><label>Find</label></input> <submit submission="s"><label>Go</label></submit> </h:p> </h:body> </h:html> ]]> </programlisting> </example> <para> Ïðèâåäåííàÿ âûøå ôîðìà îòîáðàæàåò òåêñòîâîå ïîëå äëÿ ââîäà (íàçâàííîå <parameter>q</parameter>) è êíîïêó äëÿ îïðàâêè ôîðìû, ïðè íàæàòèè íà êîòîðóþ âñå ââåäåííûå äàííûå áóäóò îòïðàâëåíû ñêðèïòó, óêàçàííîìó â ïîëå <literal>action</literal>. </para> <para> Òóò ìû ïîäîøëè ê åùå îäíîìó ñóùåñòâåííîìó ðàçëè÷èþ ñ òî÷êè çðåíèÿ âàøåãî âåá-ïðèëîæåíèÿ. Ñòàíäàðòíàÿ HTML-ôîðìà îòïðàâëÿåò äàííûå êàê <literal>application/x-www-form-urlencoded</literal>, à XForms äëÿ ïåðåäà÷è äàííûõ èñïîëüçóåò ðàçìåòêó XML. </para> <para> Åñëè âû ðåøèëè ðàáîòàòü ñ XForms, ñêîðåå âñåãî âû çàõîòèòå ïîëó÷èòü îòïðàâëåííûå ïîëüçîâàòåëåì äàííûå â ôîðìàòå XML.  òàêîì ñëó÷àå îáðàòèòå âíèìàíèå íà ïåðåìåííóþ <varname>$HTTP_RAW_POST_DATA</varname>, â íåé ñîäåðæèòñÿ XML-äîêóìåíò, ñãåíåðèðîâàííûé áðàóçåðîì, êîòîðûé â äàëüíåéøåì ìîæíî îáðàáîòàòü ïðåäïî÷èòàåìûì âàìè äâèæêîì XSLT èëè ïàðñåðîì XML. </para> <para> Åñëè XML-ðàçìåòêà âàñ íå èíòåðåñóåò, è âû õîòèòå, ÷òîáû ïåðåäàâàåìûå äàííûå áûëè ïîìåùåíû â ñòàíäàðòíûé ìàññèâ <varname>$_POST</varname>, âû ìîæåòå óêàçàòü êëèåíòñêîìó áðàóçåðó íà íåîáõîäèìîñòü îòïðàâëÿòü äàííûå â ôîðìàòå <literal>application/x-www-form-urlencoded</literal>. Äëÿ ýòîãî óñòàíîâèòå àòðèáóò <parameter>method</parameter> çíà÷åíèåì <emphasis>urlencoded-post</emphasis>. </para> <example> <title>Èñïîëüçîâàíèå XForm ñîâìåñòíî ñ ìàññèâîì <varname>$_POST</varname></title> <programlisting role="html"> <![CDATA[ <h:html xmlns:h="http://www.w3.org/1999/xhtml" xmlns="http://www.w3.org/2002/xforms"> <h:head> <h:title>Search</h:title> <model> <submission action="http://example.com/search" method="urlencoded-post" id="s"/> </model> </h:head> <h:body> <h:p> <input ref="q"><label>Find</label></input> <submit submission="s"><label>Go</label></submit> </h:p> </h:body> </h:html> ]]> </programlisting> </example> <note> <simpara>  äîïîëíåíèå ê âûøåñêàçàííîìó ñëåäóåò çàìåòèòü, ÷òî áîëüøîå êîëè÷åñòâî áðàóçåðîâ íå ïîääåðæèâàþò XForms. Åñëè ïðèâåäåííûå ïðèìåðû ïîòåðïåëè íåóäà÷ó, ïðîâåðüòå âåðñèþ èñïîëüçóåìîãî âàìè áðàóçåðà. </simpara> </note> </chapter> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.ru (#348) next »