Podręcznik PHP
Poprzedni | Rozdział 3. Instalacja | Następny

# Serwery-IIS/PWS

Ten rozdział zawiera wskazówki dotyczące specyficznej dla IIS IIS (Microsoft Internet Information Server) instalacji PHP na PWS/IIS 3, PWS 4 lub nowszym i IIS 4 lub nowszym.

## Windows i PWS/IIS 3

Zalecaną metodą konfiguracji tych serweró jest użycie plików rejestru dołączonych do dystrybucji PHP 4 (pws-php4cgi.reg). Możesz chcieć wyedytować ten plik aby się upewnić, że rozszerzenia i katalogi instalacji PHP pasują do twojej konfiguracji. Możesz także wykonać poniższe kroki aby przeprowadzić instalację ręcznie.

Ostrzeżenie
Poniższe kroki prowadzą do bezpośredniej pracy na rejestrze Windows. Jeden błąd może pozostawić system w stanie niestabilnym. Wysoce zalecane jest zrobienie kopii zapasowej rejestru. Zespół PHP nie będzie odpowiedzialny w wypadku uszkodzenia rejestru.

- Uruchom Regedit.

- Przejdź do: `HKEY_LOCAL_MACHINE /System /CurrentControlSet /Services /W3Svc /Parameters /ScriptMap`.

- W menu Edycja wybierz: `Nowy->Wartość ciągu`.

- Wpisz rozszerzenia, które chcesz aby były przypisane do PHP, np. `.php`

- Podwójnie kliknij na nowej wartości ciągu i wpisz ścieżkę do `php.exe` w wartości pola, np. `c:\php\php.exe`.

- Ponów te kroki dla każdego rozszerzenia, które chcesz przypisać do skryptów PHP.

Poniższe kroki nie wpływają na serwer WWW i stosuje się je tylko jeśli chcesz aby istniała możliwość uruchamiania twoich skryptów PHP z linii poleceń (np. uruchamiając `c:\myscripts\test.php`) lub przez podwójne kliknięcie na nich w okienku katalogu. Możesz pominąć te kroki jeśli chcesz, żeby podwójne kliknięcie na skrypcie wywoływało edytor.

- Teraz przejdź do: `HKEY_CLASSES_ROOT`

- Z menu Edycja wybierz: `Nowy->Klucz`.

- Nazwij klucz rozszerzeniem które ustawiłeś w poprzednim punkcie, np. `.php`

- Zaznacz nowy klucz i w prawym panelu podwójnie kliknij na "wartość domyśłna" i wpisz `phpfile`.

- Powtórz ostatni krok dla każdego rozszerzenia które ustawiłeś w poprzednich punktach.

- Teraz stwórz kolejny `Nowy->Klucz` pod `HKEY_CLASSES_ROOT` i nazwij go `phpfile`.

- Zaznacz nowy klucz `phpfile` i w prawym panelu podwójnie kliknij na "wartość domyślna" i wpisz `PHP Script`.

- Kliknij prawym przyciskiem na kluczu `phpfile` i wybierz `Nowy->Klucz`, nazwij go `Shell`.

- Kliknij prawym przyciskiem na kluczu `Shell` i wybierze `Nowy->Klucz`, nazwij go `open`.

- Kliknij prawym przyciskiem na kluczu `open` i wybierz `Nowy->Klucz`, nazwij to `command`.

- Zaznacz nowy klucz `command`, w prawym panelu podwójnie kliknij na "wartość domyślna" i wpisz ścieżkę do `php.exe`, np. `c:\php\php.exe -q %1` . Nie zapomnij o `%1`.

- Wyjdź z progamu Regedit.

- Jeśli używasz PWS na systemie windows, uruchom system ponownie aby przeładować rejestr.

Użytkownicy serwerów PWS i IIS 3 mają teraz w pełni funkcjonalny system. Użytkownicy IIS 4 mogą skorzystać ze sprytnego narzędzia autorstwa Stevena Genusa aby skonfigurować swoje mapowania skryptów.

## Windows i PWS 4 lub nowszy

Instalując PHP na systemie Windows z PWS 4 lub nowszym, masz do wyboru 2 możliwości. Albo zainstalować PHP jako binaria CGI, lub jako moduł dll ISAPI.

Jeśli wybierzesz binaria CGI, wykonaj poniższą instrukcję. If you choose the CGI binary, do the following:

- Wyedytuj załączony plik `pws-php4cgi.reg` (zajrzyj do katalogu `sapi`) aby ustalić położenie twojego pliku php.exe. Znaki slash ('\') powinny zostać zamienione na sekwencje escape, na przykład: `[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\php.exe"`

- W PWS Manager, kliknij prawym przyciskiem na katalogu, do którego chcesz dodać obsługę PHP, i wybierz `Properties`. Zaznacz pole 'Execute' i potwierdź.

Jeśłi wybierzesz moduł ISAPI, wykonaj poniższą instrukcję:

- Wyedytuj załącziony plik `pws-php4isapi.reg` (zajrzyj do katalogu `sapi`) aby ustalić położenie twojego pliku `php4isapi.dll`. Znaki slash ('\') powinny być zamienione na sekwencje escape, na przykład: `[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\Script Map] ".php"="c:\\php\\sapi\\php4isapi.dll"`

- W PWS Manager, kliknij prawym przyciskiem na katalogu, do którego chcesz dodać obsługę PHP, i wybierz `Properties`. Zaznacz pole 'Execute' i potwierdź.

## Windows NT/2000/XP i IIS 4 lub nowszy

Aby zainstalować PHP na systemie NT/2000/XP Server z serwerm WWW IIS 4 lub nowszym, wypełnij poniższe instrukcje. Masz dwie możliwości korzystania z PHP: używając binariów CGI (`php.exe`) lub modułu ISAPI.

W obu przypadkach, musisz uruchomić Microsoft Management Console (może istnieć jako 'Internet Services Manager', w Windows NT 4.0 Option Pack lub w Control Panel=>Administrative Tools w Windows 2000/XP). Potem kliknij prawym przyciskiem na węźle twojego serwera WWW (najprawdopodobniej będzie to 'Default Web Server'), i wybierz 'Properties'.

Jeśli chcesz używać binariów CGI, wykonaj poniższe kroki:

- W 'Home Directory', 'Virtual Directory', lub 'Directory', kliknij na 'Configuration', a później wybierz zakładkę App Mappings.

- Wybierz Add, a w polu Executable, wpisz: `c:\php\php.exe` (zakładając, że odzipowałeś PHP do c:\php\).

- W polu Extension wpisz rozszerzenia nazw plików, które chcesz skojarzyć ze skryptami PHP. Pozostaw 'Method exclusions' niewypełnione i zaznacz pole 'Script engine'. Możesz także chcieć zaznaczyć pole 'Check that file exists' - za cenę małego zmniejszenia wydajności IIS (lub PWS) będzie sprawdzał czy skrypt istnieje i ustawi autoryzację przed uruchamianiem PHP. Oznacza to, że dosteniesz standardowy komunikat błędu 404 zamiast błędów CGI informujących, że PHP nie wysłało żadnych danych.

  Musisz wykonać powyższy krok dla każdego rozszerzenia, które chcesz skojarzyć ze skryptami PHP. Najczęściej spotykane są rozszerzenia `.php` and `.phtml`, jednakże dla wstecznej kompatybilności dobrze jest dodać także rozszerzenie `.php3`.

- Skonfiguruj odpowiednio kwerstie bezpieczeństwa (robi się to korzystając z programu Internet Service Manager) i jeśli twój NT Server używa system plików NTFS, dodaj prawa wykonywania dla I_USR_ do katalogu, który zawiera `php.exe`.

Aby użyć moduł ISAPI, wykonaj poniższe polecenia:

- Jeśli nie chcesz Autentyfikacji HTTP używając PHP, możesz (i powinieneś) pominąć ten krok. W ISAPI Filters, dodaj nowy filtr ISAPI. Użyj PHP jako nazwę filtra, i dopisz ścieżkę do pliku `php4isapi.dll`

- W 'Home Directory', kliknij na 'Configuration'. Dodaj nowy wpis do Application Mappings. Użyj ścieżkę do php4isapi.dll jako Executable, dopisz `.php` jako rozszerzenie, zostaw pole 'Method exclusions' puste, zaznacz pole 'Script engine'.

- Całkowicie zatrzymaj IIS (NET STOP iisadmin)

- Uruchom ponownie IIS (NET START w3svc)

Poprzedni | Spis treści | Następny
Serwery-Caudium | Początek rozdziału | Serwery-Netscape i iPlanet