Підключення підтримки FastCGI в IIS

Модуль FastCGI початково відключений в IIS. Кроки для його підключення відрізняються в залежності від версії Windows.

Щоб включити підтримку FastCGI у Windows Vista SP1 та Windows 7:

Включення підтримки FastCGI у Windows Server 2008 та Windows Server 2008 R2:

Конфігурування IIS для обробки PHP-запитів

Скачайте та встановіть PHP у відповідності до інструкцій описаних на сторінці Ручне Встановлення

Зауваження:

При використанні IIS, рекомендується вибирати збірку PHP "Non-thread-safe". Ця збірка доступна на сторінці » PHP для Windows: Бінарники та Сирці.

fastcgi.impersonate = 1
fastcgi.logging = 0
cgi.fix_pathinfo=1
cgi.force_redirect = 0

В IIS підключити PHP можна або за допомогою інтерфейса для управління IIS (Менеджера Управління IIS), або використовуючи інструмент командного рядка.

Використання Менеджера Управління IIS для підключення PHP

Потрібно пройти наступні кроки:

1. Натисніть поєднання клавіш Win+R, потім у вікні, що з'явилось, введіть "inetmgr" та клікніть "Ok";

2. В інтерфейсі Менеджера IIS виберіть пункт "Сервер" в дереві "Підключення" (англ. Connections);

3. На сторінці "Огляд Можливостей" (англ. Features View) відкрийте "Співставління Обробників" (англ. Handler Mappings);

   

4. На панелі "Дії" (англ. Actions) клікніть "Додати Співставлення Модуля..." (англ. Add Module Mapping);

5. В діалоговому вікні, що з'явилось зробіть наступне:

   • Через кому, шляхи запитів, які потрібно обробляти. Накриклад, якщо потрібно обробляти всі файли з розширенням .php введіть: *.php
   • В полі "Модуль" введіть: FastCgiModule
   • В полі "Виконавчий файл" (англ. Executable) введіть: C:\[Шлях до папки, де встановлено PHP]\php-cgi.exe
   • В полі Ім'я (англ. Name) введіть: PHP_via_FastCGI

6. В цьому ж діалоговому вікні клікніть кнопку "Обмеження Запитів" (англ. Request Restrictions), а потім на закладці "Співставлення" (англ. "Mapping") виберіть варіанти, коли саме потрібно викликати даний обробник;

7. Після чого натискайте кнопки OK у всіх діалогових вікнах, щоб зберегти конфігурацію.

%windir%\system32\inetsrv\appcmd set config /section:system.webServer/fastCGI ^
/+[fullPath='c:\PHP\php-cgi.exe']

%windir%\system32\inetsrv\appcmd set config /section:system.webServer/handlers ^
/+[name='PHP_via_FastCGI', path='*.php',verb='*',modules='FastCgiModule',^
scriptProcessor='c:\PHP\php-cgi.exe',resourceType='Either']

Уособлення та доступ до файлової системи

Використовуючи IIS, рекомендується в PHP підключити уособлення FastCGI. Воно контролюється директивою fastcgi.impersonate у файлі php.ini. Коли уособлення включено, PHP буде виконувати всі операції на файловій системі від імені облікового запису користувача, якого визначено через систему автентифікації IIS. Це гарантує, що навіть коли один і той самий PHP-процес є спільним для різних веб сайтів, PHP-скрипти, на цих сайтах, не зможуть отримати доступ до файлів один одного, до поки відрізнятимуться їх облікові записи на кожному із цих сайтів в системі автентифікації IIS.

Наприклад в IIS 7, початково, включено анонімну автентифікацію, для якої використовується спеціальний вбудований обліковий запис користувача IUSR. Це означає, що для того, щоб IIS виконав PHP-скрипт, необхідно щоб користувач IUSR мав права на читання цього скрипта. Якщо PHP-скрипт повинен виконати певні операції над конкретним файлом або записати файл в певну папку, то користувач IUSR повинен мати права на ці дії.

Щоб призначити певний обліковий запис користувача для такої анонімної автентифікації в IIS 7, використовуйте наступну команду. Замініть початкову назву сайта "Default Web Site" на назву вашого сайта. У виведеному XML-елементі конфігурації знайдіть атрибут userName.

%windir%\system32\inetsrv\appcmd.exe list config "Default Web Site" ^
/section:anonymousAuthentication

<system.webServer>
  <security>
    <authentication>
      <anonymousAuthentication enabled="true" userName="IUSR" />
    </authentication>
   </security>
</system.webServer>

Зауваження:

Якщо атрибут userName не представлено в елементі anonymousAuthentication, або він має пустий рядок, то це означає, що сутність пулу застосунку використовується в якості анонімної сутності для цього веб-сайта.

Щоб змінювати права на файли та директорії, використовуйте команду icacls або звичайний інтерфейс Windows Explorer - тобто клікніть правою кнопкою миші на директорії або файлі та виберіть пункт "Властивості" (англ. Properties), після чого перейдіть на вкладку "Безпека" (англ. Security) та встановіть потрібні права.

icacls C:\inetpub\wwwroot\upload /grant IUSR:(OI)(CI)(M)

Встановлення index.php як початкового документа для IIS

Початковий документ використовується для HTTP-запитів, в яких не зазначено назву документа (а тільки назву директорії або й без неї). В PHP-застосунках для цих цілей, зазвичай, використовується index.php. Щоб додати index.php в якості початкового документа для IIS, використовуйте цю команду:

%windir%\system32\inetsrv\appcmd.exe set config ^
-section:system.webServer/defaultDocument /+"files.[value='index.php']" ^
/commit:apphost

Конфігурування Повторного Використання FastCGI та PHP

Сконфігуруйте налаштування IIS FastCGI для повторного використання PHP-процесів, за допомогою команди показаної нижче. Налаштування FastCGI instanceMaxRequests контролює - як за багато запитів буде оброблятись одиночним процесом php-cgi.exe перед тим, як IIS його видалить. Змінна оточення PHP PHP_FCGI_MAX_REQUESTS контролює - як за багато запитів може оброблятись одиночним процесом php-cgi.exe перед тим, як він почне свій новий цикл (перезапуститься). Переконайтесь, що значення вказане для FastCGI InstanceMaxRequests є меншим або рівним значенню вказаному для PHP_FCGI_MAX_REQUESTS.

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi ^
/[fullPath='c:\php\php-cgi.exe'].instanceMaxRequests:10000

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi ^
/+"[fullPath='C:\{php_folder}\php-cgi.exe'].environmentVariables.^
[name='PHP_FCGI_MAX_REQUESTS',value='10000']"

Налаштування FastCGI-таймауту

Збільшіть таймаут для FastCGI, якщо очікується тривала робота PHP-скриптів. Є два параметри, що контролюють таймаут - це activityTimeout та requestTimeout. Використовуйте команди, показані нижче, щоб змінити налаштування таймауту. Не забудьте замінити значення для параметра fullPath, щоб він містив абсолютний шлях до файла php-cgi.exe.

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi ^
/[fullPath='C:\php\php-cgi.exe',arguments=''].activityTimeout:"90"  /commit:apphost

%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/fastCgi ^
/[fullPath='C:\php\php-cgi.exe',arguments=''].requestTimeout:"90"  /commit:apphost

Зміна розташування файла php.ini

PHP шукає файл php.ini в декількох місцях, а тому можна змінити початковий шлях для файла php.ini, використовуючи змінну оточення PHPRC. Щоб повідомити PHP, що треба завантажувати конфігураційний файл з нового місця, запустіть команду, наведену нижче. Також потрібно вказати абсолютний шлях до директорії з файлом php.ini як значення для змінної оточення PHPRC.

appcmd.exe set config  -section:system.webServer/fastCgi ^
/+"[fullPath='C:\php\php.exe',arguments=''].environmentVariables.^
[name='PHPRC',value='C:\Some\Directory\']" /commit:apphost