cvs: phpdoc-pl /features http-auth.xml
| From: | Slawomir Pucia | 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