Php для windows server 2003

1. 1

   Сначала необходимо установить IIS 6.0. (IIS 5.1 на XP)

2. 

   Картинка с сайта: ru.wikihow.com

   перейдите в Control panel > Add remove programs. Нажмите на кнопку «Add/Remove Windows Components». Включите опцию «Internet Information Services». В Windows7: перейдите в Start -> Control Panel -> Programs and Features -> Turn Windows Features On or Off. Убедитесь, что все варианты, показанные на рисунке ниже, включены.

3. 

   Картинка с сайта: ru.wikihow.com

   Теперь вы должны получить нужные файлы для php5. Зайдите на страницу http://www.php.net/downloads.php и скачайте пакет zip ниже «Windows Binaries». Не приобретайте программу установки! Кроме того, в то время как вы здесь, вы должны будете получить «Collection of PECL modules» также под Windows Binaries.

4. 

   Картинка с сайта: ru.wikihow.com

   После загрузки извлеките первый загруженный файл и поместите файлы в «C:\php». Извлеките модули PECL в «C:\php\ext».

5. 

   Картинка с сайта: ru.wikihow.com

   \php\php.ini-recommended в C:\php\php.ini, а затем скопируйте его в C:\Windows

6. 

   Картинка с сайта: ru.wikihow.com

   Откройте файл php.ini, который у вас есть сейчас, и раскомментированный cgi.force_redirect in php.ini и установите его в 0
   

7. 

   Картинка с сайта: ru.wikihow.com

   Если ваш почтовый сервер находится в другом месте, вы можете указать его здесь. Также установите эту строку в качестве этого чуть ниже вышеуказанного: sendmail_from = someone@yourhost.com

8. 

   Картинка с сайта: ru.wikihow.com

   \php\sessions» и создайте каталог C:\php\sessions

9. 

   Картинка с сайта: ru.wikihow.com

   \PHP\ext».

10. 

    Картинка с сайта: ru.wikihow.com

    extension=php_mssql.dll
    extension=php_msql.dll
    extension=php_mysql.dll
    extension=php_mysqli.dll
    extension=php_java.dll
    extension=php_ldap.dll
    extension=php_iisfunc.dll
    extension=php_imap.dll
    extension=php_filepro.dll
    extension=php_gd2.dll
    extension=php_gettext.dll
    extension=php_dba.dll
    extension=php_dbase.dll
    extension=php_dbx.dll
    extension=php_mbstring.dll
    extension=php_pdf.dll
    extension=php_pgsql.dll
    extension=php_sockets.dll
    extension=php_xmlrpc.dll
    extension=php_xsl.dll
    extension=php_zip.dll

    Остальные требуют большего внимания, и это выходит за рамки данного руководства.Некоторых пунктов может не быть там. В этом случае просто скопируйте строку в ваш файл .ini.

12. Введите следующую информацию в соответствующие текстовые поля, а затем нажмите кнопку OK.

    Реклама

Об этой статье

Эту страницу просматривали 6526 раз.

Структура и содержание пакета PHP

Распакуйте содержимое zip архива в директорию на ваш выбор, например, C:\PHP\.
Структура папок и файлов, извлеченных из архива, будет выглядеть следующим образом:

c:\php
   |
   +--dev
   |  |
   |  |-php5ts.lib                 -- версия php5.lib без поддержки многопоточности
   |
   +--ext                          -- DLL модули для PHP
   |  |
   |  |-php_bz2.dll
   |  |
   |  |-php_cpdf.dll
   |  |
   |  |-...
   |
   +--extras                       -- пустой
   |
   +--pear                         -- начальная копия PEAR
   |
   |
   |-go-pear.bat                   -- скрипт установки PEAR
   |
   |-...
   |
   |-php-cgi.exe                   -- исполняемый файл CGI
   |
   |-php-win.exe                   -- выполняет скрипты без открытой консоли
   |
   |-php.exe                       -- Исполняемый файл PHP для командной строки (CLI)
   |
   |-...
   |
   |-php.ini-development           -- настройки php.ini по умолчанию
   |
   |-php.ini-production            -- рекомендуемые настройки php.ini
   |
   |-php5apache2_2.dll             -- есть только в многопоточной версии
   |
   |-php5apache2_2_filter.dll      -- есть только в многопоточной версии
   |
   |-...
   |
   |-php5ts.dll                    -- ядро PHP DLL ( php5.dll в версии без поддержки многопоточности)
   | 
   |-...

Ниже представлен список модулей и исполняемых файлов, включенных в PHP zip
дистрибутив:

• go-pear.bat — скрипт установки PEAR. Подробнее смотрите
  » Установка (PEAR).

• php-cgi.exe — исполняемый файл CGI, который может быть использован во время запуска PHP
  на IIS через CGI или FastCGI.

• php-win.exe — исполняемый файл PHP для выполнения PHP скриптов без использования консоли
  (например, приложения PHP, использующие Windows GUI).

• php.exe — исполняемый файл PHP для выполнения PHP скриптов в консоли (CLI).

• php5apache2_2.dll — модуль Apache 2.2.X.

• php5apache2_2_filter.dll — фильтр Apache 2.2.X.

Изменение файла php.ini

После того, как содержимое пакета php извлечено, создайте копию php.ini-production с именем php.ini
в той же папке. Если необходимо, также возможно разместить php.ini в любом другом месте по вашему выбору,
но это потребует дополнительной настройки, которая приводится в разделе Настройка PHP.

Файл php.ini содержит правила исполнения PHP и инструкции по работе с
окружением, в котором он запускается. Ниже приводятся некоторые из настроек php.ini,
которые могут улучшить работу PHP в Windows. Некоторые из них необязательные. Есть
много других директив, которые могут быть полезны в вашем окружении — обращайтесь к
списку директив php.ini за более подробной информацией.

Обязательные директивы:

• extension_dir = <путь к директории модулей> — extension_dir
  указывает директорию, где расположены модули PHP. Путь может быть абсолютным
  (например, «C:\PHP\ext») или относительным (например, «.\ext»). Используемые в php.ini модули
  должны быть расположены в extension_dir.

• extension = xxxxx.dll — Для каждого подключаемого модуля необходимо указать директиву «extension=».
  Модули из extension_dir, отмеченные такой директивой, загружаются при старте PHP.

• log_errors = On — в PHP есть механизм ведения лога ошибок, который может использоваться для сохранения ошибок в файле
  или для отправки в сервис (например syslog). Механизм также использует значение директивы error_log. Когда PHP исполняется службой IIS,
  log_errors должен быть включен с корректным error_log.

• error_log = <пусть к файлу лога ошибок> — error_log нужен для обозначения абсолютного
  или относительного пути к файлу, в который протоколируются ошибки PHP. Этот файл должен доступным для записи веб-сервером.
  Самые распространенные места размещения этого файла — различные временные TEMP директории, например, «C:\inetpub\temp\php-errors.log».

• cgi.force_redirect = 0 — Эта директива необходима для исполнения под IIS.
  Это механизм защиты директории, требуемый многими другими веб-серверами. Однако, включение его под IIS
  вызовет ошибки ядра PHP в Windows.

• cgi.fix_pathinfo = 1 — Обеспечивает поддержку PATH_INFO согласно спецификации CGI.
  IIS FastCGI использует эту настройку.

• fastcgi.impersonate = 1 — FastCGI под IIS поддерживает способность идентифицировать
  маркеры безопасности вызывающего клиента. Это позволяет IIS определять контекст безопасности, под которые выполняется запрос.

• fastcgi.logging = 0 — Запись логов FastCGI должна быть выключена в IIS. Если запись включена,
  тогда все сообщения любых классов распознаются FastCGI как ошибки, что приведет IIS к выбрасыванию исключения HTTP 500.

Опциональные директивы

• max_execution_time = ## — Эта директива указывает максимальное время выполнения любого скрипта PHP.
  По умолчанию равна 30 секундам. Следует увеличить это значение, если приложение PHP должно выполняться дольше.

• memory_limit = ###M — Количество памяти, доступное процессу PHP, в Мб.
  По умолчанию 128, что достаточно для большинства PHP приложений. Некоторым сложным приложениям может потребоваться больше памяти.

• display_errors = Off — Директива определяет, какие ошибки следует возвращать веб-серверу для
  дальнейшего протоколирования. При значении «On» PHP сообщает обо всех видах ошибок, которые
  приводятся в директиве error_reporting.
  По соображениям безопасности рекомендуется установить в «Off» на рабочих серверах, чтобы исключить передачу
  вывода ошибок конечному пользователю, так как они могут содержат информацию, угрожающую безопасности приложения.

• open_basedir = <пути к директориям, разделенные точкой с запятой>, например
  openbasedir=»C:\inetpub\wwwroot;C:\inetpub\temp». Эта директива указывает пути к директориям, в которых PHP
  разрешены операции с файловой системой. Любая операция с файлами и директориями вне указанных путей будет приводить к ошибке.
  Эта директива особенно полезна для предотвращения доступа к установленному PHP в окружениях разделяемых хостингов для предотвращения
  доступа PHP скриптов к любым файлам вне корневой директории веб сайта.

• upload_max_filesize = ###M и post_max_size = ###M —
  Максимальный разрешенный размер загруженного файла и присланных данных соответственно. Значения этих директив должны быть
  увеличены, если приложения PHP должны обрабатывать большие загружаемые файлы, например, изображения или видеофайлы.

После установки PHP в вашей системе, следующим шагом будет выбор веб-сервера и его дальнейшая
настройка для работы с PHP. Выберите конкретный веб-сервер в оглавлении к данному материалу.

Помимо запуска PHP с помощью веб-сервера, PHP может быть запущен из командной строки
как .BAT скрипт. За более подробной информацией обращайтесь к материалу
Консоль PHP на Microsoft Windows.

Configuring IIS to process PHP requests

Download and install PHP in accordance to the instructions described in
manual installation steps

Замечание:

Non-thread-safe build of PHP is recommended when using IIS. The non-thread-safe
builds are available at » PHP for Windows:
Binaries and Sources Releases.

Configure the CGI- and FastCGI-specific settings in php.ini file as shown below:

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

Download and install the » Microsoft FastCGI Extension for IIS 5.1 and 6.0.
The extension is available for 32-bit and 64-bit platforms — select the right download package for your platform.

Configure the FastCGI extension to handle PHP-specific requests by running the command shown below.
Replace the value of the «-path» parameter with the absolute file path to the
php-cgi.exe file.

cscript %windir%\system32\inetsrv\fcgiconfig.js -add -section:"PHP" ^
-extension:php -path:"C:\PHP\php-cgi.exe"

This command will create an IIS script mapping for *.php file extension, which will result in all URLs
that end with .php being handled by FastCGI extension. Also, it will configure FastCGI extension to
use the executable php-cgi.exe to process the PHP requests.

Замечание:

At this point the required installation and configuration steps are completed. The remaining
instructions below are optional but highly recommended for achieving optimal functionality
and performance of PHP on IIS.

Impersonation and file system access

It is recommended to enable FastCGI impersonation in PHP when using IIS. This
is controlled by the fastcgi.impersonate directive in php.ini file. When
impersonation is enabled, PHP will perform all the file system operations on
behalf of the user account that has been determined by IIS authentication. This
ensures that even if the same PHP process is shared across different IIS web
sites, the PHP scripts in those web sites will not be able to access each
others’ files as long as different user accounts are used for IIS authentication
on each web site.

For example IIS 5.1 and IIS 6.0, in its default configuration, has anonymous authentication enabled
with built-in user account IUSR_<MACHINE_NAME> used as a default identity. This means that in
order for IIS to execute PHP scripts, it is necessary to grant IUSR_<MACHINE_NAME> account
read permission on those scripts. If PHP applications need to perform write operations on certain
files or write files into some folders then IUSR_<MACHINE_NAME> account should have write permission to those.

To determine which user account is used by IIS anonymous authentication, follow these steps:

To modify the permissions settings on files and folders, use the Windows Explorer user interface
or icacls command.

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

Set index.php as a default document in IIS

The IIS default documents are used for HTTP requests that do not specify a document name. With PHP applications,
index.php usually acts as a default document. To add index.php to the list of
IIS default documents, follow these steps:

FastCGI and PHP Recycling configuration

Configure IIS FastCGI extension settings for recycling of PHP processes by using the commands shown below.
The FastCGI setting instanceMaxRequests controls how many requests will be processed by a single
php-cgi.exe process before FastCGI extension shuts it down. The PHP environment variable
PHP_FCGI_MAX_REQUESTS controls how many requests a single php-cgi.exe process
will handle before it recycles itself. Make sure that the value specified for FastCGI InstanceMaxRequests
setting is less than or equal to the value specified for PHP_FCGI_MAX_REQUESTS.

cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
-InstanceMaxRequests:10000

cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
-EnvironmentVars:PHP_FCGI_MAX_REQUESTS:10000

Configuring FastCGI timeout settings

Increase the timeout settings for FastCGI extension if there are applications that have long running PHP scripts.
The two settings that control timeouts are ActivityTimeout and RequestTimeout.
Refer to » Configuring FastCGI Extension for IIS 6.0 for more
information about those settings.

Changing the Location of php.ini file

PHP searches for php.ini file in
several locations and it is
possible to change the default locations of php.ini
file by using PHPRC environment variable. To instruct PHP
to load the configuration file from a custom location run the command shown below.
The absolute path to the directory with php.ini file should be
specified as a value of PHPRC environment variable.

cscript %windir%\system32\inetsrv\fcgiconfig.js -set -section:"PHP" ^
-EnvironmentVars:PHPRC:"C:\Some\Directory\"

Включение поддержки FastCGI в IIS

Модуль FastCGI при установке IIS по умолчанию отключён. Способы включения его различаются
в зависимости от версии используемой Windows.

Для включения поддержки FastCGI на Windows Vista SP1 и Windows 7:

Чтобы включить поддержку FastCGI на Windows Server 2008 и Windows Server 2008 R2:

Настройка IIS для обработки PHP запросов

Скачайте и установите PHP в соответствии с инструкциями, приведёнными в
описании установки

Замечание:

При использовании IIS рекомендуется использовать потоко-небезопасную (Non-thread-safe) сборку PHP,
которая доступна по ссылке » PHP для Windows:
Установочные файлы и исходный код.

Измените CGI и FastCGI настройки в файле php.ini как показано ниже:

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

Настройте IIS обработчик для PHP, используя Интерфейс управления IIS
или через командную строку.

%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 рекомендуется включить представление FastCGI в PHP. Это контролируется директивой
fastcgi.impersonate в php.ini файле.
Когда имперсонация включена, PHP будет выполнять все операции с файловой системой под аккаунтом,
который был определён при аутентификации IIS. Это гарантирует, что при общем PHP процессе для всех
сайтов IIS, PHP скрипты этих сайтов не будут иметь доступ к файлам друг друга до тех пор, пока IIS использует
различные учетные записи для каждого из сайтов.

Для примера, в настройках по умолчанию IIS 7, включена анонимная аутентификация под стандартным пользователем
IUSR. Это значит, что давая разрешение IIS выполнить PHP скрипт, так же необходимо дать права на чтение
этого скрипта аккаунту IUSR.
Если PHP приложению необходимо выполнить запись в некоторые файлы или папки, тогда аккаунту IUSR следует дать
права на запись в них.

Чтобы решить какой пользователь используется для идентификации в IIS 7, можно использовать следующие команды.
Замените «Default Web Site» на имя IIS сайта, с которым вы работаете. На выходе, в
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,
или установлен как пустая строка, это значит, что удостоверение пула приложений используется как анонимное
для этого веб-сайта.

Для изменения настроек доступа для файлов или папок, используйте интерфейс пользователя в проводнике Windows
или команду icacls.

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

Установка index.php как документа по умолчанию в IIS

По умолчанию в 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

Установка PHP как модуля Apache

Необходимо добавить следующие строки в файл Apache httpd.conf:

# Add to the end of the LoadModule section
# Don't forget to copy this file from the sapi directory!
LoadModule php4_module "C:/php/php4apache.dll"

# Add to the end of the AddModule section
AddModule mod_php4.c

# Add to the end of the LoadModule section
LoadModule php5_module "C:/php/php5apache.dll"

# Add to the end of the AddModule section
AddModule mod_php5.c

# Add this line inside the <IfModule mod_mime.c> conditional brace
AddType application/x-httpd-php .php

# For syntax highlighted .phps files, also add
AddType application/x-httpd-php-source .phps

Установка как бинарного CGI файла

Если PHP распакован в C:\php\ как описано
в разделе Manual
Installation Steps, необходимо добавить следующие строки
в конфигурационный файл Apache:

ScriptAlias /php/ "c:/php/"
AddType application/x-httpd-php .php

# For PHP 4
Action application/x-httpd-php "/php/php.exe"

# For PHP 5
Action application/x-httpd-php "/php/php-cgi.exe"

# specify the directory where php.ini is
SetEnv PHPRC C:/php

Заметьте, что вторая строка в списке выше уже находится в httpd.conf,
но она закомментирована. Кроме того, не забудьте заменить c:/php/
на ваш настоящий путь к PHP.

В случае установки PHP как CGI нет такой удобной опции для подсветки синтаксиса
исходников PHP как при установке в виде модуля. Если вы хотите использовать ее,
необходимо использовать функцию highlight_file().
Для этого просто создайте PHP скрипт со следующим кодом:
<?php highlight_file('some_php_script.php'); ?>.

Установка PHP как обработчика под Apache

Вам необходимо добавить следующие строки в ваш конфигурационный файл Apache
httpd.conf для загрузки PHP-модуля для Apache 2.x:

#
LoadModule php5_module "c:/php/php5apache2.dll"
AddHandler application/x-httpd-php .php

# конфигурирование пути к php.ini
PHPIniDir "C:/php"

Замечание:

Не забудьте указать актуальный путь к директории PHP вместо
C:/php/ в приведенном примере. Позаботьтесь, чтобы
в директиве LoadModule использовались либо php5apache2.dll либо
php5apache2_2.dll и удостоверьтесь, что указанный файл
фактически находится по пути, который вы указали в директиве.

Приведенная выше конфигурация позволит PHP обработать любой файл, который имеет
расширение .php, даже если имеются другие расширения. К примеру, файл с именем
example.php.txt будет запущен обработчиком PHP. Чтобы гарантировать,
что только файлы, которые имеют расширение.php
будут запущены, используйте следующую конфигурацию:

<FilesMatch \.php$>
      SetHandler application/x-httpd-php
 </FilesMatch>

Запуск PHP как CGI

Вы должны обратиться к документации » Apache CGI
для более полного понимания о запуске CGI под Apache.

Для запуска PHP как CGI, вам необходимо поместить ваши php-cgi файлы в
директорию, обозначенную как директория CGI, используя директиву ScriptAlilas.

После этого вам необходимо добавить строку #! в PHP файлы, указывающую
на местоположение исполняемого файла PHP.

#!C:/php/php.exe
<?php
  phpinfo();
?>

Запуск PHP под FastCGI

Запуск PHP под FastCGI имеет ряд преимуществ по сравнению с запуском как
CGI. Установка же довольно проста:

Получить mod_fcgid здесь:
» http://httpd.apache.org/mod_fcgid/.
исполняемые файлы под Win32 доступны для скачивания с этого сайта. Установите модуль
в соответствии с прилагаемыми инструкциями.

Настроить свой веб сервер как указано ниже, позаботившись о соответствии всех
путей установки на вашей конкретной системе:

LoadModule fcgid_module modules/mod_fcgid.so  

# Где находится ваш php.ini?
FcgidInitialEnv PHPRC        "c:/php"

AddHandler fcgid-script .php  
FcgidWrapper "c:/php/php-cgi.exe" .php  

Файлы с расширением .php в таком случае будут запускаться с помощью
оболочки PHP FastCGI.

CGI setup on Sun, iPlanet and Netscape servers

To install PHP as a CGI handler, do the following:

• 
  Copy php4ts.dll to your systemroot
  (the directory where you installed Windows)
  

• Make a file association from the command line.
  Type the following two lines:

  assoc .php=PHPScript
  ftype PHPScript=c:\php\php.exe %1 %*

• 
  In the Netscape Enterprise Administration Server create
  a dummy shellcgi directory and remove it just after (this
  step creates 5 important lines in obj.conf and allow the
  web server to handle shellcgi scripts).
  
• 
  In the Netscape Enterprise Administration Server create
  a new mime type (Category: type,
  Content-Type: magnus-internal/shellcgi, File Suffix:php).
  
• 
  Do it for each web server instance you want PHP to run
  

More details about setting up
PHP as a CGI executable can be found here:
» http://benoit.noss.free.fr/php/install-php.html

NSAPI setup on Sun, iPlanet and Netscape servers

To install PHP with NSAPI, do the following:

• 
  Copy php4ts.dll to your systemroot
  (the directory where you installed Windows)
  

• Make a file association from the command line.
  Type the following two lines:

  assoc .php=PHPScript
  ftype PHPScript=c:\php\php.exe %1 %*

• 
  In the Netscape Enterprise Administration Server create
  a new mime type (Category: type,
  Content-Type: magnus-internal/x-httpd-php, File Suffix: php).
  

• Edit magnus.conf (for servers >= 6) or
  obj.conf (for servers < 6) and add the following:
  You should
  place the lines after mime types init.

  Init fn="load-modules" funcs="php4_init,php4_execute,php4_auth_trans" shlib="c:/php/sapi/php4nsapi.dll"
  Init fn="php4_init" LateInit="yes" errorString="Failed to initialise PHP!" [php_ini="c:/path/to/php.ini"]
  

  (PHP >= 4.3.3) The php_ini parameter is
  optional but with it you can place your
  php.ini in your web server configuration directory.

• Configure the default object in obj.conf
  (for virtual server classes [Sun Web Server 6.0+] in
  their vserver.obj.conf):
  In the <Object name="default">
  section, place this line necessarily after all ‘ObjectType’
  and before all ‘AddLog’ lines:

  Service fn="php4_execute" type="magnus-internal/x-httpd-php" [inikey=value inikey=value ...]
  

  (PHP >= 4.3.3) As additional parameters you can add some special
  php.ini-values, for example you
  can set a docroot="/path/to/docroot"
  specific to the context php4_execute
  is called. For boolean ini-keys please use 0/1 as value,
  not "On","Off",...
  (this will not work correctly), e.g.
  zlib.output_compression=1 instead of
  zlib.output_compression="On"

• This is only needed if you want to configure a directory that only consists of
  PHP scripts (same like a cgi-bin directory):

  <Object name="x-httpd-php">
  ObjectType fn="force-type" type="magnus-internal/x-httpd-php"
  Service fn=php4_execute [inikey=value inikey=value ...]
  </Object>
  

  After that you can configure a directory in the Administration server and assign it
  the style x-httpd-php. All files in it will get executed as PHP.
  This is nice to hide PHP usage by renaming files to .html.

• 
  Restart your web service and apply changes
  
• 
  Do it for each web server instance you want PHP to run
  

Замечание:

More details about setting up
PHP as an NSAPI filter can be found here:
» http://benoit.noss.free.fr/php/install-php4.html

Замечание:

The stacksize that PHP uses depends on the configuration of the web server. If you get
crashes with very large PHP scripts, it is recommended to raise it with the Admin Server
(in the section «MAGNUS EDITOR»).

CGI environment and recommended modifications in php.ini

Important when writing PHP scripts is the fact that Sun JSWS/Sun ONE
WS/iPlanet/Netscape is a multithreaded web server. Because of that all
requests are running in the same process space (the space of the web server
itself) and this space has only one environment. If you want to get CGI
variables like PATH_INFO, HTTP_HOST
etc. it is not the correct way to try this in the old PHP way with
getenv() or a similar way (register globals to
environment, $_ENV). You would only get the environment
of the running web server without any valid CGI variables!

Замечание:

Why are there (invalid) CGI variables in the environment?

Answer: This is because you started the web server process from the admin server
which runs the startup script of the web server, you wanted to start, as a CGI script
(a CGI script inside of the admin server!). This is why the environment of
the started web server has some CGI environment variables in it. You can test
this by starting the web server not from the administration server. Use
the command line as root user and start it manually — you will see
there are no CGI-like environment variables.

Simply change your scripts to get CGI variables in the correct way for
PHP 4.x by using the superglobal $_SERVER. If you have
older scripts which use $HTTP_HOST, etc., you should turn
on register_globals in php.ini and change the variable
order too (important: remove "E" from it,
because you do not need the environment here):

variables_order = "GPCS"
register_globals = On

Special use for error pages or self-made directory listings (PHP >= 4.3.3)

You can use PHP to generate the error pages for "404 Not Found"
or similar. Add the following line to the object in obj.conf for
every error page you want to overwrite:

Error fn="php4_execute" code=XXX script="/path/to/script.php" [inikey=value inikey=value...]

where XXX is the HTTP error code. Please delete
any other Error directives which could interfere with yours.
If you want to place a page for all errors that could exist, leave
the code parameter out. Your script can get the HTTP status code
with $_SERVER[‘ERROR_TYPE’].

Another possibility is to generate self-made directory listings.
Just create a PHP script which displays a directory listing and
replace the corresponding default Service line for
type="magnus-internal/directory"
in obj.conf with the following:

Service fn="php4_execute" type="magnus-internal/directory" script="/path/to/script.php" [inikey=value inikey=value...]

For both error and directory listing pages the original URI and
translated URI are in the variables $_SERVER[‘PATH_INFO’] and
$_SERVER[‘PATH_TRANSLATED’].

Note about nsapi_virtual() and subrequests (PHP >= 4.3.3)

The NSAPI module now supports the nsapi_virtual() function
(alias: virtual())
to make subrequests on the web server and insert the result in the web page.
The problem is, that this function uses some undocumented features from
the NSAPI library.

Under Unix this is not a problem, because the module automatically looks
for the needed functions and uses them if available.
If not, nsapi_virtual() is disabled.

Under Windows limitations in the DLL handling need the use of a automatic
detection of the most recent ns-httpdXX.dll file.
This is tested for servers till version 6.1. If a newer version of the
Sun server is used, the detection fails and nsapi_virtual()
is disabled.

If this is the case, try the following:
Add the following parameter to php4_init in
magnus.conf/obj.conf:

Init fn=php4_init ... server_lib="ns-httpdXX.dll"

where XX is the correct DLL version number.
To get it, look in the server-root for the correct DLL name. The
DLL with the biggest filesize is the right one.

You can check the status by using the phpinfo() function.

Замечание:

But be warned: Support for nsapi_virtual() is EXPERIMENTAL!!!

Внимание

Используя установку CGI, ваш сервер открыт перед несколькими возможными уязвимостями. Пожалуйста, ознакомьтесь с разделом «Безопасность CGI» чтобы узнать, как можно защитить себя от таких атак.

C:\PHP5\php.exe -f "C:\PHP Scripts\script.php" -- -arg1 -arg2 -arg3

Пример #24 Изменения реестра

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\.php]
@="phpfile"
"Content Type"="application/php"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile]
@="PHP Script"
"EditFlags"=dword:00000000
"BrowserFlags"=dword:00000008
"AlwaysShowExt"=""

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\DefaultIcon]
@="C:\\PHP5\\php-win.exe,0"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell]
@="Open"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell\Open]
@="&Open"

[HKEY_LOCAL_MACHINE\SOFTWARE\Classes\phpfile\shell\Open\command]
@="\"C:\\PHP5\\php.exe\" -f \"%1\" -- %~2"

"C:\PHP Scripts\script" -arg1 -arg2 -arg3