Author: qwiat
Date: Sat Sep 9 01:46:48 2006
New Revision: 7743
Modified:
PLD-doc/book/pl_book__uslugi/pl_uslugi__apache.sec
Log:
- poszatkowanie dlugich sekcji na krotsze
- akualizacja opisu by pasowal do apache 2.2
- wydzielenie UserDir jako osobnej sekcji
- masa drobnych poprawek
Modified: PLD-doc/book/pl_book__uslugi/pl_uslugi__apache.sec
==============================================================================
--- PLD-doc/book/pl_book__uslugi/pl_uslugi__apache.sec (original)
+++ PLD-doc/book/pl_book__uslugi/pl_uslugi__apache.sec Sat Sep 9 01:46:48 2006
@@ -15,24 +15,34 @@
wskazuje Apache (a patche server) składa się z wielu
modułów. Można to zauważyć
już na pierwszy rzut oka. W tym rozdziale zostanie
opisana autoryzacja, obsługa
skryptów php, virtualhosts oraz ogólna jego
konfiguracja. Przedstawiona poniżej
- oparta została o apache z serii 2.x.
- Na początek powinieneś zainstalować takie pakiety
jak:</para>
- <itemizedlist>
- <listitem override='bullet'>
- <para>apache</para>
- </listitem>
- <listitem override='bullet'>
- <para>apache-mod_dir</para>
- </listitem>
- </itemizedlist>
- <para>Zakładam, że zapoznałeś się już z rozdziałem
- siódmym <literal>Zarządzanie pakietami</literal>, więc
przystąpię do krótkiego
- omówienia organizacji struktury katalogów Apache.
Tytułem wstępu pragnę jeszcze
+ oparta została o apache z serii 2.x.
+ </para>
+ </section>
+ <section id="uslugi_apache_instalacja">
+ <title>Instalacja</title>
+ <para>
+ Apache w PLD jest podzielony na wiele małych pakietów,
możemy dzięki instalować
+ tylko potrzebne moduły. Jeśli nie możemy się połapać w
tym gąszczu to możemy
+ posłużyć się metapakietem <filename>apache</filename>,
który za pośrednictwem
+ mechanizmu zależności zainstaluje najważniejsze pakiety.
+ <screen># poldek -i apache</screen>
+ Kiedy będziemy mieli zainstalowane wymagane pakiety,
będziemy mogli wstępnie przetestować
+ serwer, zatem uruchomimy usługę:
+ <screen># service httpd start</screen>
+ W katalogu <filename>/home/services/httpd</filename>
umieszczamy jakąś testową stronę WWW
+ którą nazwiemy np. test.html i sprawdzamy za pomocą
przeglądarki czy się prawidłowo wyświetla:
+ <screen>$ elinks localhost/test.html</screen>
+ Jeśli wszystko jest w porządku, to możemy przejść do
właściwej konfiguracji serwera.
+ </para>
+ </section>
+ <section id="uslugi_apache_pliki_konf">
+ <title>Pliki konfiguracji</title>
+ <para>Tytułem wstępu pragnę
powiedzieć, że niniejszy dokument nie może być
traktowany jako dokumentacja do Apache.
Ma on na celu ułatwienie użytkownikowi zapoznania się z
usługą oraz kilkoma jej
możliwościami. Po bardziej szczegółowe informacje
odsyłam do stron podręcznika
systemowego (man) oraz dokumentacji
- <ulink
url="http://httpd.apache.org/docs-2.0/";>on-line</ulink></para>
+ <ulink
url="http://httpd.apache.org/docs-2.2/";>on-line</ulink></para>
<itemizedlist>
<listitem>
<para><filename
class="directory">/etc/httpd/httpd.conf</filename></para>
@@ -62,34 +72,44 @@
<screen># rpm -ql apache |grep
^\/usr\/sbin</screen></para>
</listitem>
</itemizedlist>
- <para>Apache jest ponad to wyposażony w mechanizm loggera wraz
z
- <literal>logrotate</literal>, strony podręcznika
systemowego oraz pliki README.</para>
+ <para>
+ Aby nasz serwer obsługiwał dodatkowe funkcje musimy
zainstalować
+ dodatkowe moduły, wraz z modułami dostarczane, są pliki
konfiguracji
+ z potrzebnymi dyrektywami.
+ </para>
+ <para>
+ Po każdej zmianie konfiguracji w katalogu
+ <filename>/etc/httpd/httpd.conf</filename> konieczne
+ jest przeładowanie demona, aby na nowo odczytał swoje
+ pliki konfiguracji.
+ Użyjemy w tym celu odpowiedniego wywołania rc-skryptu:
+ <screen># service httpd restart</screen>
+ Jeśli będziemy modyfikować konfigurację działającego
+ serwera produkcyjnego, to dobrą praktyką jest
wcześniejsze
+ użycie programu <filename>apachectl</filename> z pakietu
+ <filename>apache-tools</filename> do sprawdzenia
poprawności
+ składni plików konfiguracji:
+<screen># apachectl configtest
+Syntax OK</screen>
+ </para>
+ <para>
+ Bardzo pożyteczną cechą Apache jest możliwość
+ tworzenia lokalnych plików konfiguracji, dzięki którym
+ możemy modyfikować niektóre opcje konfiguracji. Pliki te
+ mają nazwę <filename>.htaccess</filename> i może je
tworzyć
+ każdy kto ma tylko dostęp do katalogu ze stroną WWW.
Wygoda w
+ ich używaniu polega na tym, że nie ma potrzeby
restartowania
+ demona po każdorazowej ich modyfikacji.
+ </para>
</section>
+
<section id="uslugi_apache_konf">
<title>Podstawowa konfiguracja</title>
- <para>Głównym plikiem konfiguracyjnym jest
-
<filename>/etc/httpd/httpd.conf/10_httpd.conf</filename>. Zaraz po
zainstalowaniu
- demon jest wstępnie skonfigurowany i gotowy do
uruchomienia. Warto jednak zapoznać
- się ze specyfiką konfiguracji Apache. Podczas omawiania
zwrócę Twoją uwagę na to, co
- może Ci się przydać.</para>
- <para>Plik konfiguracyjny podzielony jest na dwie sekcje.</para>
- <itemizedlist>
- <listitem>
- <para><option>Global Environment</option></para>
- <para>Zdefiniowane są w niej takie
rzeczy
- jak parametry dotyczące obsługi klientów łączących się
z serwerem, numeru
- portu na ktorym ma on nasłuchiwać nadchodzących
połączeń, ilości
- procesów uruchamianych przez demona oraz wątków.
Szczegółowe informacje
- na ten temat znajdziesz w dokumentacji do Apache.
Również tutaj znajdują się
- dyrektywy ładujące moduły skompilowane jako DSO
(Dynamic Shared Object).
- W zasadzie bieżąca konfiguracja tej sekcji powinna być
na razie
- wystarczająca, więc nie trzeba nic w niej
zmieniać.</para>
-</listitem>
-<listitem>
- <para><option>'Main' server configuration</option></para>
- <para>Jak sama nazwa wskazuje, jest to główna sekcja pliku
konfiguracyjnego.
- Zaraz pod definicją grupy oraz użytkownika, na których
będzie pracował
- demon znajduje się poniższa opcja.</para>
+
+ <para>Głównym plikiem konfiguracyjnym jest
<filename>/etc/httpd/apache.conf</filename>.
+ Spośród wielu opcji w tym pliku zajmiemy się dwiema
podstawowymi:
+ </para>
+
<screen>ServerAdmin [EMAIL PROTECTED]</screen>
<para>Powinieneś tutaj wpisać kontaktowy adres e-mail do siebie
jako
administratora tego serwera.</para>
@@ -100,25 +120,45 @@
skonfigurowana na serwerze nazw opiekującym się Twoją
domeną. Jeżeli
nie posiadasz zarejestrowanej domeny, powinieneś wpisać
tutaj adres
IP.</para>
- <para>Następną opcją jest <option>DocumentRoot</option>.
Określa ona domyślny
+ <para>
+ Teraz zajmiemy się opcją <option>DocumentRoot</option>,
którą odnajdziemy w
+ <filename>/etc/httpd/conf.d/10_common.conf </filename>
+ Określa ona domyślny
katalog w którym będzie przechowywana strona
internetowa. Wpisując
nazwę lub adres IP określony przez
<option>ServerName</option> właśnie
z tego katalogu zostaną pobrane i wczytane przez
przeglądarkę pliki
strony.</para>
<screen>DocumentRoot "/home/services/httpd/html"</screen>
- <para>Domyślnie wszystkie rządania są tutaj skierowane. Ta
lokalizacja nie jest
+ <para>Domyślnie wszystkie żądania są tutaj skierowane. Ta
lokalizacja nie jest
obligatoryjna, więc nie musisz się jej trzymać. Może
zostać zmieniona przy
użyciu dowiązań symbolicznych lub aliasów wskazujących
w inne
miejsca.</para>
- <para>Następna opcja to <option>UserDir</option>. Definiuje ona
nazwę katalogu
- przechowującego strony użytkowników.</para>
+
+ <para>Zgodnie z obecnym standardem tworzenia stron
internetowych, domyślnym
+ plikiem który jest automatycznie wczytywany po
wpisaniu w
+ przeglądarce adresu jest
<literal>index</literal>, który w
+ zależności od konstrukcji strony może mieć
różne rozszerzenia. A
+ więc skąd Apache wie, co ma zostać wczytane
jako pierwsze? Do tego
+ właśnie służy pakiet
<literal>apache-mod_dir</literal>. Jego plikiem
+ konfiguracyjnym jest
+
<filename>/etc/httpd/httpd.conf/59_mod_dir.conf</filename></para>
+ <para> Poprzez dyrektywę
<option>DirectoryIndex</option> określa się czego i w
+ jakiej kolejności ma szukać przeglądarka.</para>
+<screen>DirectoryIndex index.html index.html.var index.htm index.shtml \
+ index.cgi index.php</screen>
+ <para>Oczywiście możemy podawać tutaj różne nazwy
plików startowych stron
+ w zależności od naszych potrzeb.</para>
+ </section>
+
+
+ <section id="uslugi_apache_userdir">
+ <title>Strony użytkowników</title>
+ <para>Opcja <option>UserDir</option> definiuje nazwę katalogu
+ przechowującego strony użytkowników wewnątrz ich
katalogów domowych.</para>
<screen>UserDir public_html</screen>
<para>Oczywiście jeżeli nie podoba Ci się ta nazwa możesz ją
zmienić, jednak należy
pamiętać o tym, aby nazwy katalogów ze stronami na
kontach użytkowników
odpowiadały temu co jest w pliku konfiguracyjnym.</para>
- <!--Ciesiel, luknij na to, Ty się znasz, żeby przykład, który
opisałem jakoś
- ładnie wyglądał w dokumentacji :-)
- -->
<para>Przykład: Użytkownik Jan Kowalski posiada konto o nazwie:
jan. W
<filename class="directory">/home/users/jan</filename>
jest jego katalog
domowy.
@@ -130,32 +170,15 @@
<literal>public_html</literal> powinien mieć
<emphasis>755</emphasis>.
Każdy katalog zawierający elementy strony powinien mieć
również uprawnienia
<emphasis>755</emphasis>. Pliki strony natomiast
- <emphasis>644</emphasis>. Należy teraz uruchomić usługę
aby dokonane
- przez nas zmiany odniosły skutek.</para>
- <screen># /etc/rc.d/init.d/httpd start</screen>
+ <emphasis>644</emphasis>.
+ </para>
<para>Zgodnie z dotychczasową konfiguracją Apache,
stronę Jana będzie można oglądać pod adresem:
- <ulink url="#">http://example.net/~jan</ulink>.</para>
- <para>Zgodnie z obecnym standardem tworzenia stron
internetowych, domyślnym
- plikiem który jest automatycznie wczytywany po
wpisaniu w
- przeglądarce adresu jest
<literal>index</literal>, który w
- zależności od konstrukcji strony może mieć
różne rozszerzenia. A
- więc skąd Apache wie, co ma zostać wczytane
jako pierwsze? Do tego
- właśnie służy pakiet
<literal>apache-mod_dir</literal>. Jego plikiem
- konfiguracyjnym jest
- </para>
- <para>
-
<filename>/etc/httpd/httpd.conf/59_mod_dir.conf</filename>
- </para>
- <para> Poprzez dyrektywę
<option>DirectoryIndex</option> określa się czego i w
- jakiej kolejności ma szukać przeglądarka.</para>
- <screen>DirectoryIndex index.html index.html.var
index.htm index.shtml \
- index.cgi index.php</screen>
- <para>Oczywiście możemy podawać tutaj różne nazwy
plików startowych stron
- w zależności od naszych potrzeb.</para>
-</listitem>
- </itemizedlist>
+ <literal>http://example.net/~jan</literal>.
+ </para>
</section>
+
+
<section id="uslugi_apache_vhost">
<title>Virtual Hosts - wiele nazw na jednym serwerze</title>
<para>Mechanizm hostów wirtualnych jest prosty w konfiguracji.
Musi się opierać
_______________________________________________
pld-cvs-commit mailing list
[email protected]
http://lists.pld-linux.org/mailman/listinfo/pld-cvs-commit
