cvs: phpdoc-ru /features connection-handling.xml http-auth.xml
| From: | Antony Dovgal | Date: | Wed, 28 Apr 2004 07:51:00 +0000 |
| Subject: | cvs: phpdoc-ru /features connection-handling.xml http-auth.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-320@lists.php.net to get a copy of this message | ||
tony2001 Wed Apr 28 03:51:00 2004 EDT
Added files:
/phpdoc-ru/features connection-handling.xml http-auth.xml
Log:
add files translated by young
http://cvs.php.net/co.php/phpdoc-ru/features/connection-handling.xml?r=1.1&p=1 Index: phpdoc-ru/features/connection-handling.xml +++ phpdoc-ru/features/connection-handling.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.14 Maintainer: young Status: ready --> <chapter id="features.connection-handling"> <title>Ðàáîòà ñ ñîåäèíåíèÿìè</title> <note> <para>Âñÿ ïîñëåäóþùàÿ èíôîðìàöèÿ ïðèìåíèìà ê âåðñèÿì 3.0.7 è íèæå.</para> </note> <para> Ñòàòóñ ñîåäèíåíèÿ ñîõðàíÿåòñÿ âíóòðåííèìè ìåõàíèçìàìè PHP. Íèæå ïåðå÷èñëåíû òðè âîçìîæíûå ñîñòîÿíèÿ: <itemizedlist> <listitem><simpara>0 - NORMAL</simpara></listitem> <listitem><simpara>1 - ABORTED</simpara></listitem> <listitem><simpara>2 - TIMEOUT</simpara></listitem> </itemizedlist> </para> <simpara> Âî âðåìÿ øòàòíîãî âûïîëíåíèÿ PHP-ñêðèïòà óñòàíîâëåí ñòàòóñ NORMAL.  ñëó÷àå, åñëè óäàëåííûé êëèåíò ðàçîðâàë ñîåäèíåíèå, ñòàòóñ èçìåíÿåòñÿ íà ABORTED. ×àùå âñåãî îòñîåäèíåíèå óäàëåííîãî êëèåíòà ïðîèñõîäèò ïðè íàæàòèè êíîïêè "Stop" â áðàóçåðå.  ñëó÷àå, åñëè äîñòèãàåòñÿ óñòàíîâëåííûé âðåìåííîé ëèìèò (îçíàêîìüòåñü ñ ôóíêöèåé <function>set_time_limit</function>), áóäåò óñòàíîâëåí ñòàòóñ TIMEOUT. </simpara> <simpara> Âû ìîæåòå ðåøàòü, ïðèâîäèò ëè îòêëþ÷åíèå êëèåíòà ê çàâåðøåíèþ âàøåãî ñêðèïòà. Èíîãäà áûâàåò íåîáõîäèìî, ÷òîáû ñêðèïò âûïîëíèëñÿ äî êîíöà, äàæå åñëè îòñóòñòâóåò óäàëåííûé áðàóçåð, êîòîðîìó àäðåñîâàí âåñü âûâîä. Ïî óìîë÷àíèþ ñêðèïò çàâåðøàåò ñâîþ ðàáîòó ïðè îòêëþ÷åíèè êëèåíòà. Ýòî ïîâåäåíèå ìîæåò áûòü èçìåíåíî ïðè ïîìîùè îïöèè ignore_user_abort â êîíôèãóðàöèîííîì ôàéëå &php.ini;. Òàêîãî æå ðåçóëüòàòà ìîæíî äîáèòüñÿ, óêàçàâ "php_value ignore_user_abort" â êîíôèãóðàöèîííîì ôàéëå Apache èëè âîñïîëüçîâàâøèñü ôóíêöèåé <function>ignore_user_abort</function>. Åñëè âû ÿâíî íå óêàçàëè íà íåîáõîäèìîñòü èãíîðèðîâàòü ðàçðûâ ñîåäèíåíèÿ ñ êëèåíòîì, âûïîëíåíèå ñêðèïòà áóäåò ïðåðâàíî. Èñêëþ÷åíèåì ÿâëÿåòñÿ òîò ñëó÷àé, åñëè èñïîëüçóÿ <function>register_shutdown_function</function>, âû óêàçàëè ñïåöèàëüíóþ ôóíêöèþ, âûçûâàåìóþ ïðè çàâåðøåíèè ñêðèïòà.  òàêîì ñëó÷àå ïîñëå òîãî, êàê ïîëüçîâàòåëü íàæàë êíîïêó "Stop" â ñâîåì áðàóçåðå, ïðè ïåðâîé æå ïîïûòêå ÷òî-ëèáî âûâåñòè PHP îáíàðóæèâàåò, ÷òî ñîåäèíåíèå ñ êëèåíòîì áûëî óòåðÿíî, è âûçûâàåò çàâåðøàþùóþ ôóíêöèþ. Ýòà ôóíêöèÿ òàêæå âûçûâàåòñÿ ïðè íîðìàëüíîì çàâåðøåíèè ðàáîòû âàøåãî ñêðèïòà, ïîýòîìó äëÿ òîãî, ÷òîáû âûïîëíèòü íåêîòîðûå ñïåöèôè÷åñêèå äåéñòâèÿ ïðè îòñîåäèíåíèè êëèåíòà, âàì ïîíàäîáèòñÿ ôóíêöèÿ <function>connection_aborted</function>, êîòîðàÿ âîçâðàùàåò &true;, åñëè ñîåäèíåíèå áûëî ðàçîðâàíî. </simpara> <simpara> Âûïîëíåíèå âàøåãî ñêðèïòà òàêæå ìîæåò áûòü ïðåðâàíî âñòðîåííûì òàéìåðîì. Ñòàíäàðòíîå îãðàíè÷åíèå ïî âðåìåíè ñîñòàâëÿåò 30 ñåêóíä, èçìåíèòü åãî ìîæíî ïðè ïîìîùè äèðåêòèâû max_execution_time â êîíôèãóðàöèîííîì ôàéëå &php.ini;. Òàêîãî æå ðåçóëüòàòà ìîæíî äîñòè÷ü, äîáàâèâ "php_value max_execution_time" â êîíôèãóðàöèîííûé ôàéë Apache èëè âîñïîëüçîâàâùèñü ôóíêöèåé <function>set_time_limit</function>. Ïðè äîñòèæåíèè ñêðèïòîì âðåìåííîãî ëèìèòà âûïîëíåíèå ñêðèïòà ïðåðûâàåòñÿ è âûçûâàåòñÿ çàâåðøàþùàÿ ôóíêöèÿ, åñëè îíà áûëà óêàçàíà. Óòî÷íèòü ïðè÷èíó çàâåðøåíèÿ ñêðèïòà âû ìîæåòå ïðè ïîìîùè ôóíêöèè <function>connection_timeout</function>, êîòîðàÿ âîçâðàùàåò &true;, åñëè ñêðèïò áûë ïðåðâàí ïî äîñòèæåíèþ âðåìåííîãî îãðàíè÷åíèÿ. </simpara> <simpara> Åäèíñòâåííîå, ÷òî ñëåäóåò çàìåòèòü - ÷òî îáà ñòàòóñà: ABORTED è TIMEOUT,- ìîãóò áûòü óñòàíîâëåíû îäíîâðåìåííî. Ýòî ìîæåò ïðîèçîéòè â òîì ñëó÷àå, åñëè âû ÿâíî óêàçàëè íåîáõîäèìîñòü èãíîðèðîâàòü îòñîåäèíåíèå óäàëåííîãî êëèåíòà.  òàêîì ñëó÷àå ïîñëå ðàçðûâà ñîåäèíåíèÿ, îòìåòèâ ýòîò ôàêò, PHP ïðîäîëæèò âûïîëíåíèå ñêðèïòà, è ïðè äîñòèæåíèè âðåìåííîãî ëèìèòà áóäåò âûçâàíà çàâåðøàþùàÿ ôóíêöèÿ, åñëè òàêîâàÿ áûëà óêàçàíà.  ýòîé òî÷êå âû ìîæåòå îáíàðóæèòü, ÷òî è <function>connection_timeout</function>, è <function>connection_aborted</function> âîçâðàùàþò &true;. Âû òàêæå ìîæåòå ïðîâåðèòü îáà ñòàòóñà îäíîâðåìåííî, âûçâàâ ôóíêöèþ <function>connection_status</function>, êîòîðàÿ âîçâðàùàåò áèòîâûå çíà÷åíèÿ äëÿ àêòèâíûõ ñòàòóñîâ.  ñëó÷àå, åñëè îáà ñòàòóñà àêòèâíû, îíà, ê ïðèìåðó, âåðíåò çíà÷åíèå 3. </simpara> </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/http-auth.xml?r=1.1&p=1 Index: phpdoc-ru/features/http-auth.xml +++ phpdoc-ru/features/http-auth.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.38 Maintainer: young Status: ready --> <chapter id="features.http-auth"> <title>HTTP-Àóòåíòèôèêàöèÿ â PHP</title> <simpara> HTTP-Àóòåíòèôèêàöèÿ â PHP âîçìîæíà òîëüêî â òîì ñëó÷àå, êîãäà îí âûïîëíÿåòñÿ êàê ìîäóëü âåá-ñåðâåðà Apache, è, ñîîòâåòñòâåííî, íåäîñòóïíà äëÿ CGI-âåðñèè. Âàø ñêðèïò ìîæåò èñïîëüçîâàòü ôóíêöèþ <function>header</function> äëÿ òîãî, ÷òîáû îòïðàâèòü áðàóçåðó êëèåíòà ñîîáùåíèå "Authentication Required", ÷òî â ñâîþ î÷åðåäü ïðèâåäåò ê ïîÿâëåíèþ äèàëîãîâîãî îêíà äëÿ ââîäà èìåíè ïîëüçîâàòåëÿ è ïàðîëÿ. Ïîñëå òîãî êàê êëèåíò ââåë ñâîå èìÿ è ïàðîëü, ñêðèïò áóäåò âûçâàí ïîâòîðíî, íî óæå ñ <link linkend="reserved.variables">ïðåäîïðåäåëåííûìè ïåðåìåííûìè</link> <varname>PHP_AUTH_USER</varname>, <varname>PHP_AUTH_PW</varname> è <varname>AUTH_TYPE</varname>, êîòîðûå ñîîòâåòñòâåííî ñîäåðæàò èìÿ ïîëüçîâàòåëÿ, ïàðîëü è òèï àóòåíòèôèêàöèè. Ýòè ïåðåìåííûå ìîãóò áûòü íàéäåíû â ìàññèâå <link linkend="reserved.variables.server">$_SERVER</link> è <varname>$HTTP_SERVER_VARS</varname>.  íàñòîÿùåå âðåìÿ ïîääåðæèâàåòñÿ òîëüêî "Basic"-àóòåíòèôèêàöèÿ. Òàêæå âû ìîæåòå îçíàêîìèòñÿ ñ áîëåå äåòàëüíûì îïèñàíèåì ôóíêöèè <function>header</function>. </simpara> <note> <title>Çàìå÷àíèå êàñàòåëüíî âåðñèè PHP</title> <para> <link linkend="language.variables.superglobals">Cóïåðãëîáàëüíûå ïåðåìåííûå</link>, òàêèå êàê <link linkend="reserved.variables.server">$_SERVER</link>, äîñòóïíû, íà÷èíàÿ ñ <ulink url="&url.php.release4.1.0;">4.1.0</ulink>. Ìàññèâ <varname>$HTTP_SERVER_VARS</varname> äîñòóïåí â PHP 3 è âûøå. </para> </note> <para> Ïðèìåð ôðàãìåíòà ñêðèïòà, êîòîðûé âûíóæäàåò êëèåíòà àâòîðèçèðîâàòüñÿ äëÿ ïðîñìîòðà ñòðàíèöû: </para> <para> <example> <title>Ïðèìåð HTTP-àóòåíòèôèêàöèè</title> <programlisting role="php"> <![CDATA[ <?php if (!isset($_SERVER['PHP_AUTH_USER'])) { header('WWW-Authenticate: Basic realm="My Realm"'); header('HTTP/1.0 401 Unauthorized'); echo 'Òåêñò, îòïðàâëÿåìûé â òîì ñëó÷àå, åñëè ïîëüçîâàòåëü íàæàë êíîïêó Cancel'; exit; } else { echo "<p>Hello {$_SERVER['PHP_AUTH_USER']}.</p>"; echo "<p>Âû ââåëè ïàðîëü {$_SERVER['PHP_AUTH_PW']}.</p>"; } ?> ]]> </programlisting> </example> </para> <note> <title>Çàìå÷àíèå êàñàòåëüíî ñîâìåñòèìîñòè</title> <para> Áóäüòå îñîáåííî âíèìàòåëüíû ïðè óêàçàíèè HTTP-çàãîëîâêîâ. Äëÿ òîãî, ÷òîáû ãàðàíòèðîâàòü ìàêñèìàëüíóþ ñîâìåñòèìîñòü ñ íàèáîëüøèì êîëè÷åñòâîì ðàçëè÷íûõ êëèåíòîâ, ñëîâî "Basic" äîëæíî áûòü íàïèñàíî ñ áîëüøîé áóêâû "B", ðåãèîí (realm) äîëæåí áûòü âçÿò â äâîéíûé (íå îäèíàðíûå!) êàâû÷êè, è ðîâíî îäèí ïðîáåë äîëæåí ïðåäøåñòâîâàòü êîäó <emphasis>401</emphasis> â çàãîëîâêå <emphasis>HTTP/1.0 401</emphasis>. </para> </note> <para> Âìåñòî ïðîñòîãî îòîáðàæåíèÿ íà ýêðàíå ïåðåìåííûõ <varname>PHP_AUTH_USER</varname> è <varname>PHP_AUTH_PW</varname>, âàì, âîçìîæíî, ïîíàäîáèòñÿ ïðîâåðèòü èõ êîððåêòíîñòü. Èñïîëüçóéòå äëÿ ýòîãî çàïðîñ ê áàçå äàííûõ èëè ïîèñê ïîëüçîâàòåëÿ â dbm-ôàéëå. </para> <para> Âû ìîæåòå ïðîíàáëþäàòü îñîáåííîñòè ðàáîòû áðàóçåðà Internet Explorer. Îí î÷åíü òðåáîâàòåëåí ê ïàðàìåòðó ïåðåäàâàåìûõ çàãîëîâêîâ. Óêàçàíèå çàãîëîâêà <emphasis>WWW-Authenticate</emphasis> ïåðåä îòïðàâêîé ñòàòóñà <literal>HTTP/1.0 401</literal> ÿâëÿåòñÿ íåáîëüøîé õèòðîñòüþ. </para> <simpara> Íà÷èíàÿ ñ PHP 4.3.0, äëÿ òîãî, ÷òîáû ïðåäîòâðàòèòü íàïèñàíèå êåì-ëèáî ñêðèïòà, ðàñêðûâàþùåãî ïàðîëü ê ñòðàíèöå, êîòîðàÿ èñïîëüçóåò âíåøíþþ àóòåíòèôèêàöèþ, ïåðåìåííûå <varname>PHP_AUTH</varname> íå óñòàíàâëèâàþòñÿ â ñëó÷àå, åñëè äàííàÿ ñòðàíèöà èñïîëüçóåò âíåøíþþ àóòåíòèôèêàöèþ è óñòàíîâëåí &safemode;. Íåñìîòðÿ íà ýòî, ïåðåìåííàÿ <varname>REMOTE_USER</varname> ìîæåò èñïîëüçîâàòüñÿ äëÿ àóòåíòèôèêàöèè ïîëüçîâàòåëÿ, ïðîøåäøåãî âíåøíþþ àóòåíòèôèêàöèþ. Òàêèì îáðàçîì, âû âñåãäà ìîæåòå âîñïîëüçîâàòüñÿ ïåðåìåííîé <varname>$_SERVER['REMOTE_USER']</varname>. </simpara> <note> <title>Çàìå÷àíèå êàñàòåëüíî êîíôèãóðàöèè</title> <para> PHP èñïîëüçóåò óêàçàíèå äèðåêòèâû <literal>AuthType</literal> äëÿ óêàçàíèÿ òîãî, èñïîëüçóåòñÿ âíåøíÿÿ àóòåíòèôèêàöèÿ èëè íåò. </para> </note> <simpara> Ñëåäóåò çàìåòèòü, ÷òî âñå âûøåñêàçàííîå íå ïðåäîòâðàùàåò ïîõèùåíèÿ ïàðîëåé ê ñòðàíèöàì, òðåáóþùèì àâòîðèçàöèþ, êåì-ëèáî, êòî êîíòðîëèðóåò ñòðàíèöû áåç àâòîðèçàöèè, ðàñïîëîæåííûå íà òîì æå ñåðâåðå. </simpara> <simpara> È Netscape Navigator è Internet Explorer î÷èùàþò êåø àóòåíòèôèêàöèè òåêóùåãî îêíà äëÿ çàäàííîãî ðåãèîíà (realm) ïðè ïîëó÷åíèè îò ñåðâåðà. Ýòî ìîæåò èñïîëüçîâàòüñÿ äëÿ ðåàëèçàöèè ïðèíóäèòåëüíîãî âûõîäà ïîëüçîâàòåëÿ è ïîâòîðíîãî îòîáðàæåíèÿ äèàëîãîâîãî îêíà äëÿ ââîäà èìåíè ïîëüçîâàòåëÿ è ïàðîëÿ. Íåêîòîðûå ðàçðàáîò÷èêè èñïîëüçóþò ýòî äëÿ îãðàíè÷åíèÿ àâòîðèçàöèè ïî âðåìåíè èëè äëÿ ïðåäîñòàâëåíèÿ êíîïêè "Âûõîä". </simpara> <para> <example> <title>Ïðèìåð HTTP-àóòåíòèôèêàöèè ñ ïðèíóäèòåëüíûì ââîäîì íîâîé ïàðû ëîãèí/ïàðîëü</title> <programlisting role="php"> <![CDATA[ <?php function authenticate() { header('WWW-Authenticate: Basic realm="Test Authentication System"'); header('HTTP/1.0 401 Unauthorized'); echo "Âû äîëæíû ââåñòè êîððåêòíûé ëîãèí è ïàðîëü äëÿ ïîëó÷åíèÿ äîñòóïà ê ðåñóðñó \n"; exit; } if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); } else { echo "<p>Äîáðî ïîæàëîâàòü: {$_SERVER['PHP_AUTH_USER']}<br />"; echo "Ïðåäûäóùèé ëîãèí: {$_REQUEST['OldAuth']}"; echo "<form action='{$_SERVER['PHP_SELF']}' METHOD='post'>\n"; echo "<input type='hidden' name='SeenBefore' value='1' />\n"; echo "<input type='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}' />\n"; echo "<input type='submit' value='Àâòîðèçîâàòüñÿ ïîâòîðíî' />\n"; echo "</form></p>\n"; } ?> ]]> </programlisting> </example> </para> <simpara> Ýòî ïîâåäåíèå íå ðåãëàìåíòèðóåòñÿ ñòàíäàðòàìè HTTP Basic-àóòåíòèôèêàöèè, ñëåäîâàòåëüíî, âû íå äîëæíû çàâèñåòü îò ýòîãî. Êàê ïîêàçàëè òåñòû, áðàóçåð Lynx íå î÷èùàåò êåø àâòîðèçàöèè ïðè ïîëó÷åíèè îò ñåðâåðà ñòàòóñà 401, è, íàæàâ ïîñëåäîâàòåëüíî "Back", à çàòåì "Forward" âîçìîæíî îòêðûòü òàêóþ ñòðàíèöó, ïðè óñëîâèè, ÷òî òðåáóåìûå àòðèáóòû àâòîðèàçàöèè íå èçìåíèëèñü. Îäíàêî, ïîëüçîâàòåëü ìîæåò íàæàòü êëàâèøó '_' äëÿ î÷èñòêè êåøà àóòåíòèôèêàöèè. </simpara> <simpara> Òàêæå ñëåäóåò çàìåòèòü, ÷òî äî âåðñèè PHP 4.3.3, HTTP-àóòåíòèôèêàöèÿ íå ðàáîòàëà íà ñåðâåðàõ ïîä óïðàâëåíèåì Microsoft IIS, åñëè PHP áûë óñòàíîâëåí êàê CGI-ìîäóëü, â ñèëó íåêîòîðûõ îãðàíè÷åíèé IIS. Äëÿ òîãî, ÷òîáû äîáèòüñÿ êîððåêòíîé ðàáîòû â PHP 4.3.3+, âû äîëæíû îòðåäàêòèðîâàòü êîíôèãóðàöèîííóþ íàñòðîéêó IIS ïîä íàçâàíèåì "Directory Security". Ùåëêíèòå íà íàäïèñè "Edit" è óñòàíîâèòå îïöèþ "Anonymous Access", âñå îñòàëüíûå ïîëÿ äîëæíû îñòàòüñÿ íåîòìå÷åííûìè. </simpara> <simpara> Åùå îäíî îãðàíè÷åíèå, åñëè âû èñïîëüçóåòå IIS ïîñðåäñòâîì ISAPI: ïåðåìåííûå <literal>PHP_AUTH_*</literal> íå îïðåäåëåíû, íî â òî æå âðåìÿ äîñòóïíà ïåðåìåííàÿ <literal>HTTP_AUTHORIZATION</literal>. Ïðèìåð êîäà, êîòîðûé âû ìîãëè áû èñïîëüçîâàòü: <literal>list($user, $pw) = explode(':', base64_decode(substr($_SERVER['HTTP_AUTHORIZATION'], 6)));</literal> </simpara> <note> <title>Çàìå÷àíèå êàñàòåëüíî IIS:</title> <simpara> Äëÿ òîãî, ÷òîáû HTTP-àóòåíòèôèêàöèÿ êîððåêòíî ðàáîòàëà â IIS, â êîíôèãóðàöèè PHP îïöèÿ <link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link> äîëæíà áûòü óñòàíîâëåíà çíà÷åíèåì <literal>0</literal> (çíà÷åíèå ïî óìîë÷àíèþ). </simpara> </note> <note> <para>  ñëó÷àå, åñëè èñïîëüçóåòñÿ <link linkend="ini.safe-mode">çàùèùåííûé ðåæèì</link>, UID òåêóùåãî ñêðèïòà áóäåò äîáàâëåí â <literal>realm</literal>-÷àñòü çàãîëîâêà <literal>WWW-Authenticate</literal>. </para> </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 -->
http://cvs.php.net/co.php/phpdoc-ru/features/connection-handling.xml?r=1.1&p=1 Index: phpdoc-ru/features/connection-handling.xml +++ phpdoc-ru/features/connection-handling.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.14 Maintainer: young Status: ready --> <chapter id="features.connection-handling"> <title>Ðàáîòà ñ ñîåäèíåíèÿìè</title> <note> <para>Âñÿ ïîñëåäóþùàÿ èíôîðìàöèÿ ïðèìåíèìà ê âåðñèÿì 3.0.7 è íèæå.</para> </note> <para> Ñòàòóñ ñîåäèíåíèÿ ñîõðàíÿåòñÿ âíóòðåííèìè ìåõàíèçìàìè PHP. Íèæå ïåðå÷èñëåíû òðè âîçìîæíûå ñîñòîÿíèÿ: <itemizedlist> <listitem><simpara>0 - NORMAL</simpara></listitem> <listitem><simpara>1 - ABORTED</simpara></listitem> <listitem><simpara>2 - TIMEOUT</simpara></listitem> </itemizedlist> </para> <simpara> Âî âðåìÿ øòàòíîãî âûïîëíåíèÿ PHP-ñêðèïòà óñòàíîâëåí ñòàòóñ NORMAL.  ñëó÷àå, åñëè óäàëåííûé êëèåíò ðàçîðâàë ñîåäèíåíèå, ñòàòóñ èçìåíÿåòñÿ íà ABORTED. ×àùå âñåãî îòñîåäèíåíèå óäàëåííîãî êëèåíòà ïðîèñõîäèò ïðè íàæàòèè êíîïêè "Stop" â áðàóçåðå.  ñëó÷àå, åñëè äîñòèãàåòñÿ óñòàíîâëåííûé âðåìåííîé ëèìèò (îçíàêîìüòåñü ñ ôóíêöèåé <function>set_time_limit</function>), áóäåò óñòàíîâëåí ñòàòóñ TIMEOUT. </simpara> <simpara> Âû ìîæåòå ðåøàòü, ïðèâîäèò ëè îòêëþ÷åíèå êëèåíòà ê çàâåðøåíèþ âàøåãî ñêðèïòà. Èíîãäà áûâàåò íåîáõîäèìî, ÷òîáû ñêðèïò âûïîëíèëñÿ äî êîíöà, äàæå åñëè îòñóòñòâóåò óäàëåííûé áðàóçåð, êîòîðîìó àäðåñîâàí âåñü âûâîä. Ïî óìîë÷àíèþ ñêðèïò çàâåðøàåò ñâîþ ðàáîòó ïðè îòêëþ÷åíèè êëèåíòà. Ýòî ïîâåäåíèå ìîæåò áûòü èçìåíåíî ïðè ïîìîùè îïöèè ignore_user_abort â êîíôèãóðàöèîííîì ôàéëå &php.ini;. Òàêîãî æå ðåçóëüòàòà ìîæíî äîáèòüñÿ, óêàçàâ "php_value ignore_user_abort" â êîíôèãóðàöèîííîì ôàéëå Apache èëè âîñïîëüçîâàâøèñü ôóíêöèåé <function>ignore_user_abort</function>. Åñëè âû ÿâíî íå óêàçàëè íà íåîáõîäèìîñòü èãíîðèðîâàòü ðàçðûâ ñîåäèíåíèÿ ñ êëèåíòîì, âûïîëíåíèå ñêðèïòà áóäåò ïðåðâàíî. Èñêëþ÷åíèåì ÿâëÿåòñÿ òîò ñëó÷àé, åñëè èñïîëüçóÿ <function>register_shutdown_function</function>, âû óêàçàëè ñïåöèàëüíóþ ôóíêöèþ, âûçûâàåìóþ ïðè çàâåðøåíèè ñêðèïòà.  òàêîì ñëó÷àå ïîñëå òîãî, êàê ïîëüçîâàòåëü íàæàë êíîïêó "Stop" â ñâîåì áðàóçåðå, ïðè ïåðâîé æå ïîïûòêå ÷òî-ëèáî âûâåñòè PHP îáíàðóæèâàåò, ÷òî ñîåäèíåíèå ñ êëèåíòîì áûëî óòåðÿíî, è âûçûâàåò çàâåðøàþùóþ ôóíêöèþ. Ýòà ôóíêöèÿ òàêæå âûçûâàåòñÿ ïðè íîðìàëüíîì çàâåðøåíèè ðàáîòû âàøåãî ñêðèïòà, ïîýòîìó äëÿ òîãî, ÷òîáû âûïîëíèòü íåêîòîðûå ñïåöèôè÷åñêèå äåéñòâèÿ ïðè îòñîåäèíåíèè êëèåíòà, âàì ïîíàäîáèòñÿ ôóíêöèÿ <function>connection_aborted</function>, êîòîðàÿ âîçâðàùàåò &true;, åñëè ñîåäèíåíèå áûëî ðàçîðâàíî. </simpara> <simpara> Âûïîëíåíèå âàøåãî ñêðèïòà òàêæå ìîæåò áûòü ïðåðâàíî âñòðîåííûì òàéìåðîì. Ñòàíäàðòíîå îãðàíè÷åíèå ïî âðåìåíè ñîñòàâëÿåò 30 ñåêóíä, èçìåíèòü åãî ìîæíî ïðè ïîìîùè äèðåêòèâû max_execution_time â êîíôèãóðàöèîííîì ôàéëå &php.ini;. Òàêîãî æå ðåçóëüòàòà ìîæíî äîñòè÷ü, äîáàâèâ "php_value max_execution_time" â êîíôèãóðàöèîííûé ôàéë Apache èëè âîñïîëüçîâàâùèñü ôóíêöèåé <function>set_time_limit</function>. Ïðè äîñòèæåíèè ñêðèïòîì âðåìåííîãî ëèìèòà âûïîëíåíèå ñêðèïòà ïðåðûâàåòñÿ è âûçûâàåòñÿ çàâåðøàþùàÿ ôóíêöèÿ, åñëè îíà áûëà óêàçàíà. Óòî÷íèòü ïðè÷èíó çàâåðøåíèÿ ñêðèïòà âû ìîæåòå ïðè ïîìîùè ôóíêöèè <function>connection_timeout</function>, êîòîðàÿ âîçâðàùàåò &true;, åñëè ñêðèïò áûë ïðåðâàí ïî äîñòèæåíèþ âðåìåííîãî îãðàíè÷åíèÿ. </simpara> <simpara> Åäèíñòâåííîå, ÷òî ñëåäóåò çàìåòèòü - ÷òî îáà ñòàòóñà: ABORTED è TIMEOUT,- ìîãóò áûòü óñòàíîâëåíû îäíîâðåìåííî. Ýòî ìîæåò ïðîèçîéòè â òîì ñëó÷àå, åñëè âû ÿâíî óêàçàëè íåîáõîäèìîñòü èãíîðèðîâàòü îòñîåäèíåíèå óäàëåííîãî êëèåíòà.  òàêîì ñëó÷àå ïîñëå ðàçðûâà ñîåäèíåíèÿ, îòìåòèâ ýòîò ôàêò, PHP ïðîäîëæèò âûïîëíåíèå ñêðèïòà, è ïðè äîñòèæåíèè âðåìåííîãî ëèìèòà áóäåò âûçâàíà çàâåðøàþùàÿ ôóíêöèÿ, åñëè òàêîâàÿ áûëà óêàçàíà.  ýòîé òî÷êå âû ìîæåòå îáíàðóæèòü, ÷òî è <function>connection_timeout</function>, è <function>connection_aborted</function> âîçâðàùàþò &true;. Âû òàêæå ìîæåòå ïðîâåðèòü îáà ñòàòóñà îäíîâðåìåííî, âûçâàâ ôóíêöèþ <function>connection_status</function>, êîòîðàÿ âîçâðàùàåò áèòîâûå çíà÷åíèÿ äëÿ àêòèâíûõ ñòàòóñîâ.  ñëó÷àå, åñëè îáà ñòàòóñà àêòèâíû, îíà, ê ïðèìåðó, âåðíåò çíà÷åíèå 3. </simpara> </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/http-auth.xml?r=1.1&p=1 Index: phpdoc-ru/features/http-auth.xml +++ phpdoc-ru/features/http-auth.xml <?xml version="1.0" encoding="windows-1251"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.38 Maintainer: young Status: ready --> <chapter id="features.http-auth"> <title>HTTP-Àóòåíòèôèêàöèÿ â PHP</title> <simpara> HTTP-Àóòåíòèôèêàöèÿ â PHP âîçìîæíà òîëüêî â òîì ñëó÷àå, êîãäà îí âûïîëíÿåòñÿ êàê ìîäóëü âåá-ñåðâåðà Apache, è, ñîîòâåòñòâåííî, íåäîñòóïíà äëÿ CGI-âåðñèè. Âàø ñêðèïò ìîæåò èñïîëüçîâàòü ôóíêöèþ <function>header</function> äëÿ òîãî, ÷òîáû îòïðàâèòü áðàóçåðó êëèåíòà ñîîáùåíèå "Authentication Required", ÷òî â ñâîþ î÷åðåäü ïðèâåäåò ê ïîÿâëåíèþ äèàëîãîâîãî îêíà äëÿ ââîäà èìåíè ïîëüçîâàòåëÿ è ïàðîëÿ. Ïîñëå òîãî êàê êëèåíò ââåë ñâîå èìÿ è ïàðîëü, ñêðèïò áóäåò âûçâàí ïîâòîðíî, íî óæå ñ <link linkend="reserved.variables">ïðåäîïðåäåëåííûìè ïåðåìåííûìè</link> <varname>PHP_AUTH_USER</varname>, <varname>PHP_AUTH_PW</varname> è <varname>AUTH_TYPE</varname>, êîòîðûå ñîîòâåòñòâåííî ñîäåðæàò èìÿ ïîëüçîâàòåëÿ, ïàðîëü è òèï àóòåíòèôèêàöèè. Ýòè ïåðåìåííûå ìîãóò áûòü íàéäåíû â ìàññèâå <link linkend="reserved.variables.server">$_SERVER</link> è <varname>$HTTP_SERVER_VARS</varname>.  íàñòîÿùåå âðåìÿ ïîääåðæèâàåòñÿ òîëüêî "Basic"-àóòåíòèôèêàöèÿ. Òàêæå âû ìîæåòå îçíàêîìèòñÿ ñ áîëåå äåòàëüíûì îïèñàíèåì ôóíêöèè <function>header</function>. </simpara> <note> <title>Çàìå÷àíèå êàñàòåëüíî âåðñèè PHP</title> <para> <link linkend="language.variables.superglobals">Cóïåðãëîáàëüíûå ïåðåìåííûå</link>, òàêèå êàê <link linkend="reserved.variables.server">$_SERVER</link>, äîñòóïíû, íà÷èíàÿ ñ <ulink url="&url.php.release4.1.0;">4.1.0</ulink>. Ìàññèâ <varname>$HTTP_SERVER_VARS</varname> äîñòóïåí â PHP 3 è âûøå. </para> </note> <para> Ïðèìåð ôðàãìåíòà ñêðèïòà, êîòîðûé âûíóæäàåò êëèåíòà àâòîðèçèðîâàòüñÿ äëÿ ïðîñìîòðà ñòðàíèöû: </para> <para> <example> <title>Ïðèìåð HTTP-àóòåíòèôèêàöèè</title> <programlisting role="php"> <![CDATA[ <?php if (!isset($_SERVER['PHP_AUTH_USER'])) { header('WWW-Authenticate: Basic realm="My Realm"'); header('HTTP/1.0 401 Unauthorized'); echo 'Òåêñò, îòïðàâëÿåìûé â òîì ñëó÷àå, åñëè ïîëüçîâàòåëü íàæàë êíîïêó Cancel'; exit; } else { echo "<p>Hello {$_SERVER['PHP_AUTH_USER']}.</p>"; echo "<p>Âû ââåëè ïàðîëü {$_SERVER['PHP_AUTH_PW']}.</p>"; } ?> ]]> </programlisting> </example> </para> <note> <title>Çàìå÷àíèå êàñàòåëüíî ñîâìåñòèìîñòè</title> <para> Áóäüòå îñîáåííî âíèìàòåëüíû ïðè óêàçàíèè HTTP-çàãîëîâêîâ. Äëÿ òîãî, ÷òîáû ãàðàíòèðîâàòü ìàêñèìàëüíóþ ñîâìåñòèìîñòü ñ íàèáîëüøèì êîëè÷åñòâîì ðàçëè÷íûõ êëèåíòîâ, ñëîâî "Basic" äîëæíî áûòü íàïèñàíî ñ áîëüøîé áóêâû "B", ðåãèîí (realm) äîëæåí áûòü âçÿò â äâîéíûé (íå îäèíàðíûå!) êàâû÷êè, è ðîâíî îäèí ïðîáåë äîëæåí ïðåäøåñòâîâàòü êîäó <emphasis>401</emphasis> â çàãîëîâêå <emphasis>HTTP/1.0 401</emphasis>. </para> </note> <para> Âìåñòî ïðîñòîãî îòîáðàæåíèÿ íà ýêðàíå ïåðåìåííûõ <varname>PHP_AUTH_USER</varname> è <varname>PHP_AUTH_PW</varname>, âàì, âîçìîæíî, ïîíàäîáèòñÿ ïðîâåðèòü èõ êîððåêòíîñòü. Èñïîëüçóéòå äëÿ ýòîãî çàïðîñ ê áàçå äàííûõ èëè ïîèñê ïîëüçîâàòåëÿ â dbm-ôàéëå. </para> <para> Âû ìîæåòå ïðîíàáëþäàòü îñîáåííîñòè ðàáîòû áðàóçåðà Internet Explorer. Îí î÷åíü òðåáîâàòåëåí ê ïàðàìåòðó ïåðåäàâàåìûõ çàãîëîâêîâ. Óêàçàíèå çàãîëîâêà <emphasis>WWW-Authenticate</emphasis> ïåðåä îòïðàâêîé ñòàòóñà <literal>HTTP/1.0 401</literal> ÿâëÿåòñÿ íåáîëüøîé õèòðîñòüþ. </para> <simpara> Íà÷èíàÿ ñ PHP 4.3.0, äëÿ òîãî, ÷òîáû ïðåäîòâðàòèòü íàïèñàíèå êåì-ëèáî ñêðèïòà, ðàñêðûâàþùåãî ïàðîëü ê ñòðàíèöå, êîòîðàÿ èñïîëüçóåò âíåøíþþ àóòåíòèôèêàöèþ, ïåðåìåííûå <varname>PHP_AUTH</varname> íå óñòàíàâëèâàþòñÿ â ñëó÷àå, åñëè äàííàÿ ñòðàíèöà èñïîëüçóåò âíåøíþþ àóòåíòèôèêàöèþ è óñòàíîâëåí &safemode;. Íåñìîòðÿ íà ýòî, ïåðåìåííàÿ <varname>REMOTE_USER</varname> ìîæåò èñïîëüçîâàòüñÿ äëÿ àóòåíòèôèêàöèè ïîëüçîâàòåëÿ, ïðîøåäøåãî âíåøíþþ àóòåíòèôèêàöèþ. Òàêèì îáðàçîì, âû âñåãäà ìîæåòå âîñïîëüçîâàòüñÿ ïåðåìåííîé <varname>$_SERVER['REMOTE_USER']</varname>. </simpara> <note> <title>Çàìå÷àíèå êàñàòåëüíî êîíôèãóðàöèè</title> <para> PHP èñïîëüçóåò óêàçàíèå äèðåêòèâû <literal>AuthType</literal> äëÿ óêàçàíèÿ òîãî, èñïîëüçóåòñÿ âíåøíÿÿ àóòåíòèôèêàöèÿ èëè íåò. </para> </note> <simpara> Ñëåäóåò çàìåòèòü, ÷òî âñå âûøåñêàçàííîå íå ïðåäîòâðàùàåò ïîõèùåíèÿ ïàðîëåé ê ñòðàíèöàì, òðåáóþùèì àâòîðèçàöèþ, êåì-ëèáî, êòî êîíòðîëèðóåò ñòðàíèöû áåç àâòîðèçàöèè, ðàñïîëîæåííûå íà òîì æå ñåðâåðå. </simpara> <simpara> È Netscape Navigator è Internet Explorer î÷èùàþò êåø àóòåíòèôèêàöèè òåêóùåãî îêíà äëÿ çàäàííîãî ðåãèîíà (realm) ïðè ïîëó÷åíèè îò ñåðâåðà. Ýòî ìîæåò èñïîëüçîâàòüñÿ äëÿ ðåàëèçàöèè ïðèíóäèòåëüíîãî âûõîäà ïîëüçîâàòåëÿ è ïîâòîðíîãî îòîáðàæåíèÿ äèàëîãîâîãî îêíà äëÿ ââîäà èìåíè ïîëüçîâàòåëÿ è ïàðîëÿ. Íåêîòîðûå ðàçðàáîò÷èêè èñïîëüçóþò ýòî äëÿ îãðàíè÷åíèÿ àâòîðèçàöèè ïî âðåìåíè èëè äëÿ ïðåäîñòàâëåíèÿ êíîïêè "Âûõîä". </simpara> <para> <example> <title>Ïðèìåð HTTP-àóòåíòèôèêàöèè ñ ïðèíóäèòåëüíûì ââîäîì íîâîé ïàðû ëîãèí/ïàðîëü</title> <programlisting role="php"> <![CDATA[ <?php function authenticate() { header('WWW-Authenticate: Basic realm="Test Authentication System"'); header('HTTP/1.0 401 Unauthorized'); echo "Âû äîëæíû ââåñòè êîððåêòíûé ëîãèí è ïàðîëü äëÿ ïîëó÷åíèÿ äîñòóïà ê ðåñóðñó \n"; exit; } if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); } else { echo "<p>Äîáðî ïîæàëîâàòü: {$_SERVER['PHP_AUTH_USER']}<br />"; echo "Ïðåäûäóùèé ëîãèí: {$_REQUEST['OldAuth']}"; echo "<form action='{$_SERVER['PHP_SELF']}' METHOD='post'>\n"; echo "<input type='hidden' name='SeenBefore' value='1' />\n"; echo "<input type='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}' />\n"; echo "<input type='submit' value='Àâòîðèçîâàòüñÿ ïîâòîðíî' />\n"; echo "</form></p>\n"; } ?> ]]> </programlisting> </example> </para> <simpara> Ýòî ïîâåäåíèå íå ðåãëàìåíòèðóåòñÿ ñòàíäàðòàìè HTTP Basic-àóòåíòèôèêàöèè, ñëåäîâàòåëüíî, âû íå äîëæíû çàâèñåòü îò ýòîãî. Êàê ïîêàçàëè òåñòû, áðàóçåð Lynx íå î÷èùàåò êåø àâòîðèçàöèè ïðè ïîëó÷åíèè îò ñåðâåðà ñòàòóñà 401, è, íàæàâ ïîñëåäîâàòåëüíî "Back", à çàòåì "Forward" âîçìîæíî îòêðûòü òàêóþ ñòðàíèöó, ïðè óñëîâèè, ÷òî òðåáóåìûå àòðèáóòû àâòîðèàçàöèè íå èçìåíèëèñü. Îäíàêî, ïîëüçîâàòåëü ìîæåò íàæàòü êëàâèøó '_' äëÿ î÷èñòêè êåøà àóòåíòèôèêàöèè. </simpara> <simpara> Òàêæå ñëåäóåò çàìåòèòü, ÷òî äî âåðñèè PHP 4.3.3, HTTP-àóòåíòèôèêàöèÿ íå ðàáîòàëà íà ñåðâåðàõ ïîä óïðàâëåíèåì Microsoft IIS, åñëè PHP áûë óñòàíîâëåí êàê CGI-ìîäóëü, â ñèëó íåêîòîðûõ îãðàíè÷åíèé IIS. Äëÿ òîãî, ÷òîáû äîáèòüñÿ êîððåêòíîé ðàáîòû â PHP 4.3.3+, âû äîëæíû îòðåäàêòèðîâàòü êîíôèãóðàöèîííóþ íàñòðîéêó IIS ïîä íàçâàíèåì "Directory Security". Ùåëêíèòå íà íàäïèñè "Edit" è óñòàíîâèòå îïöèþ "Anonymous Access", âñå îñòàëüíûå ïîëÿ äîëæíû îñòàòüñÿ íåîòìå÷åííûìè. </simpara> <simpara> Åùå îäíî îãðàíè÷åíèå, åñëè âû èñïîëüçóåòå IIS ïîñðåäñòâîì ISAPI: ïåðåìåííûå <literal>PHP_AUTH_*</literal> íå îïðåäåëåíû, íî â òî æå âðåìÿ äîñòóïíà ïåðåìåííàÿ <literal>HTTP_AUTHORIZATION</literal>. Ïðèìåð êîäà, êîòîðûé âû ìîãëè áû èñïîëüçîâàòü: <literal>list($user, $pw) = explode(':', base64_decode(substr($_SERVER['HTTP_AUTHORIZATION'], 6)));</literal> </simpara> <note> <title>Çàìå÷àíèå êàñàòåëüíî IIS:</title> <simpara> Äëÿ òîãî, ÷òîáû HTTP-àóòåíòèôèêàöèÿ êîððåêòíî ðàáîòàëà â IIS, â êîíôèãóðàöèè PHP îïöèÿ <link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link> äîëæíà áûòü óñòàíîâëåíà çíà÷åíèåì <literal>0</literal> (çíà÷åíèå ïî óìîë÷àíèþ). </simpara> </note> <note> <para>  ñëó÷àå, åñëè èñïîëüçóåòñÿ <link linkend="ini.safe-mode">çàùèùåííûé ðåæèì</link>, UID òåêóùåãî ñêðèïòà áóäåò äîáàâëåí â <literal>realm</literal>-÷àñòü çàãîëîâêà <literal>WWW-Authenticate</literal>. </para> </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 -->