cvs: phpdoc-pl /features http-auth.xml

From: Date: Sun, 15 Dec 2002 15:49:16 +0000
Subject: cvs: phpdoc-pl /features http-auth.xml
Groups: php.doc.pl 
Request: Send a blank email to doc-pl+get-87@lists.php.net to get a copy of this message
slawek Sun Dec 15 10:49:16 2002 EDT Modified files: /phpdoc-pl/features http-auth.xml Log: Updated to EN 1.29 Index: phpdoc-pl/features/http-auth.xml diff -u phpdoc-pl/features/http-auth.xml:1.12 phpdoc-pl/features/http-auth.xml:1.13 --- phpdoc-pl/features/http-auth.xml:1.12 Sat Jun 22 04:27:16 2002 +++ phpdoc-pl/features/http-auth.xml Sun Dec 15 10:49:16 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.24 Maintainer: slawek Status: ready --> -<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.29 Maintainer: slawek Status: ready --> +<!-- $Revision: 1.13 $ --> <chapter id="features.http-auth"> <title>Autoryzacja HTTP w PHP</title> @@ -10,45 +10,55 @@ funkcji <function>header</function> by wys³aæ do przegl±darki komunikat "Wymagana autoryzacja", co spowoduje wy¶wietlenie okienka z polami U¿ytkownik i Has³o. Po wype³nieniu przez u¿ytkownika tych pól, URL - zawieraj±cy skrypt PHP zostanie ponownie wywo³any ze zmiennymi - $PHP_AUTH_USER, $PHP_AUTH_PW i $PHP_AUTH_TYPE zawieraj±cymi odpowiednio - nazwê u¿ytkownika, has³o i typ autoryzacji. Obecnie obs³ugiwany jest - jedynie typ "Basic". Wiêcej informacji znajdziesz w opisie funkcji + zawieraj±cy skrypt PHP zostanie ponownie wywo³any z ustawionymi + <link linkend="reserved.variables">predefiniowanymi zmiennymi</link> + <varname>PHP_AUTH_USER</varname>, <varname>PHP_AUTH_PW</varname> i + <varname>PHP_AUTH_TYPE</varname> zawieraj±cymi odpowiednio + nazwê u¿ytkownika, has³o i typ autoryzacji. Zmienne te bêd± dostêpne w + tablicach <link linkend="reserved.variables.server">$_SERVER</link> oraz + <varname>$HTTP_SERVER_VARS</varname>. Obecnie obs³ugiwana jest jedynie + autoryzacja typu "Basic". Wiêcej informacji znajdziesz w opisie funkcji <function>header</function>.</simpara> <para> Przyk³adowy skrypt wymuszaj±cy autoryzacjê klienta: + </para> + <para> <example> <title>Autoryzacja 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 "Tekst do wys³ania, je¶li u¿ytkownik wci¶nie przycisk Anuluj\n"; + header('WWW-Authenticate: Basic realm="My Realm"'); + header('HTTP/1.0 401 Unauthorized'); + echo 'Tekst do wys³ania, je¶li u¿ytkownik wci¶nie przycisk Anuluj'; exit; } else { echo "<p>Hej {$_SERVER['PHP_AUTH_USER']}.</p>"; - echo "<p>Twoje has³o to {$_SERVER['$PHP_AUTH_PW']}.</p>"; + echo "<p>Twoje has³o to {$_SERVER['PHP_AUTH_PW']}.</p>"; } ?> ]]> </programlisting> - </example></para> + </example> + </para> <note> + <title>Kompatybilno¶æ</title> <para> Nale¿y uwa¿aæ z linijkami dodawanymi do nag³ówka HTTP. W celu zachowania maksymalnej zgodno¶ci ze wszystkimi klientami, s³owo Basic powinno zaczynaæ siê du¿± liter± "B", warto¶æ realm powinna byæ otoczona cudzys³owami (nie apostrofami), i dok³adnie jeden znak odstêpu powinien - poprzedzaæ kod 401 w linii "HTTP/1.0 401". + poprzedzaæ kod <emphasis>401</emphasis> w linii + <emphasis>HTTP/1.0 401</emphasis>. </para> </note> <para> - Zamiast wy¶wietlaæ warto¶ci $PHP_AUTH_USER i $PHP_AUTH_PW, zapewne - zechcesz sprawdziæ poprawno¶æ nazwy u¿ytkownika i has³a. Na przyk³ad + Zamiast wy¶wietlaæ warto¶æ <varname>PHP_AUTH_USER</varname> i + <varname>PHP_AUTH_PW</varname>, jak to zrobiono w powy¿szym przyk³adzie, + zechcesz zapewne sprawdziæ poprawno¶æ nazwy u¿ytkownika i has³a. Na przyk³ad poprzez zapytanie do bazy danych lub odnalezienie u¿ytkownika w pliku dbm. </para> @@ -64,10 +74,12 @@ wys³ane tradycyjnym zewnêtrznym mechanizmem, zmienne PHP_AUTH nie bêd± ustawiane, je¶li dla danej strony aktywna jest autoryzacja zewnêtrzna. W tym wypadku, aby uzyskaæ nazwê u¿ytkownika zautoryzowanego zewnêtrznie, - nale¿y skorzystaæ ze zmiennej $REMOTE_USER. + nale¿y skorzystaæ ze zmiennej <varname>REMOTE_USER</varname>. Zatem, + <varname>$_SERVER['REMOTE_USER']</varname>. </simpara> <note> + <title>Konfiguracja</title> <para> Aby wykryæ czy mia³a miejsce zewnêtrzna autoryzacja, PHP sprwadza obecno¶æ dyrektywy <literal>AuthType</literal>. Pamiêtaj zatem, by @@ -88,35 +100,36 @@ i has³a. Tej metody mo¿na u¿yæ do wylogowania u¿ytkownika po okre¶lonym czasie lub stworzenia przycisku "Wyloguj". </simpara> - <simpara></simpara> + <para> <example> - <title>Autoryzacja HTTP z wymuszeniem przelogowania</title> - <programlisting role="php"> + <title>Autoryzacja HTTP z wymuszeniem przelogowania</title> + <programlisting role="php"> <![CDATA[ <?php function authenticate() { - header( "WWW-Authenticate: Basic realm=\"Testowy system autoryzacji\""); - header( "HTTP/1.0 401 Unauthorized"); + header('WWW-Authenticate: Basic realm="Testowy system autoryzacji"'); + header('HTTP/1.0 401 Unauthorized'); echo "Musisz podaæ poprawny login i has³o by wej¶æ na tê stronê\n"; exit; } - if (!isset($_SERVER['PHP_AUTH_USER']) || ($SeenBefore == 1 && $OldAuth == $_SERVER['$PHP_AUTH_USER']))) { + if (!isset($_SERVER['PHP_AUTH_USER']) || ($_POST['SeenBefore'] == 1 && $_POST['OldAuth'] == $_SERVER['PHP_AUTH_USER'])) { authenticate(); } else { - echo "<p>Witaj: {$_SERVER['$PHP_AUTH_USER']}<br>"; + echo "<p>Witaj: {$_SERVER['PHP_AUTH_USER']}<br>"; echo "Poprzenio: {$_REQUEST['$OldAuth']}"; - echo "<form action='{$_SERVER['$PHP_SELF']}' METHOD='POST'>\n"; + 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='hidden' name='OldAuth' value='{$_SERVER['PHP_AUTH_USER']}'>\n"; echo "<input type='submit' value='Re Authenticate'>\n"; echo "</form></p>\n"; } ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> <simpara> Powy¿sza metoda nie jest wymagana przez autoryzacjê HTTP typu "Basic", wiêc nie mo¿na na niej polegaæ. Testy z przegl±dark± Lynx pokaza³y, ¿e

« previous php.doc.pl (#87) next »