Инструкции по установке

Прежде, чем Вы начнете

Если Вы абсолютно не имеете никакого опыта работы с Unix, Вы можете попросить кого-либо, имеющего хотя бы немного знаний по Unix, помочь Вам с установкой модуля. Процесс инсталляции настолько прост, насколько это возможно, но так как программное обеспечение сильно различается и зависит от ряда компонент системы, установка не всегда проходит гладко на разных системах. Возможно Вам потребуется помощь кого-либо, кто хорошо разбирается в системе.

Что вам необходимо знать перед установкой

- Можете ли Вы выполнять оба метода GET и POST из программы cgi на вашем сервере?
Это не важно, если Вы устанавливаете пакет в виде модуля Apache. Если нет, Вы не сможете использовать этот пакет. У многих ISP CGI скрипты также запрещены или строго ограничены. Если на вашей системе дело обстоит именно так, поговорите с вашим системным администратором и попросите, чтобы он(она) взглянул(а) на этот пакет, может он(она) установит его для Вас.

- Если на вашей системе установлен mSQL, то вам нужно знать его основной каталог.

- Если на вашей системе установлен Postgres95, то вам тоже нужно знать его основной каталог.

- Если Вы собираетесь хранить лог-файл и файлы конфигурации доступа в каталоге, смонтированном по NFS, и ваша система не обеспечивает блокирование файлов по NFS - Вам нужно будет определить переменную NFS_HACK вручную в файле src/Makefile, и, возможно, придется использовать немного измененную версию библиотеки gdbm. См. файл nfs_hack.txt в каталоге doc для более подробной информации относительно этого.

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

- Если Вы устанавливаете пакет в виде модуля Apache, Вам необходимо знать расположение каталога с исходными текстами Apache.

Шаги Установки

Шаг 1.

Выполните программу установки: install

Вам будет задан ряд вопросов. Если Вы их не понимаете, то просто нажимайте "Return". Заданный по умолчанию набор должен удовлетворять требования для большинства систем. Это однако не имеет отношения к вопросам, определяющим каталог для ваших конфигурационных и лог файлов. Выберите любой каталог, к которому httpd (обычно пользователь "nobody") имеет доступ по записи. Вы можете создать этот каталог вручную где-нибудь и просто сменить владельца с помощью команды chown nobody catalog .

Шаг 2.

Войдите в каталог src: cd src

Шаг 3.

Введите команду: make

По умолчанию будет создан фактический выполнимый программный файл, именованный php.cgi , или если Вы устанавливаете пакет в виде модуля Apache, будет создан libphp.a файл.

Шаг 4. (Если Вы не устанавливаете пакет в виде модуля Apache)

Скoпируйте файл php.cgi в каталог cgi-bin вашей системы. Если у вас нет прав сделать это и вы желаете установить пакет в ваш собственный персональный каталог, вы можете сделать это, но в таком случае нужно установить setuid бит для выполняемой программы командой: chmod u+s /path/php.cgi

Если Вы не установите setuid бит для выполняемого файла, то любые файлы, созданные программой будут принадлежать пользователю с идентификатором, под которым выполняется web сервер. Если это приемлемо, то вы можете спокойно оставить setuid бит.

Шаг 4. (Если Вы устанавливаете программу в виде модуля Apache)

Перейдите в каталог src Apache, в который должны быть скопированы файлы mod_php.c и mod_php.h. Если они еще не были скопированы, что может произойти из-за проблем с правами доступа, скопируйте эти два файла вручную. Подредактируйте ваш файл Конфигурации Apache (Configuration), и добавьте в строку EXTRA_LIBS libphp.a, которая была создана в конце Шага 3. А также добавьте строку:

Module php_module mod_php.o

в самом конце файла. Затем введите: Configure и затем make , чтобы перекомпилировать ваш файл httpd Apache. Инсталлируйте этот файл.

Затем Вам нужно подредактировать ваш Apache conf/srm.conf файл и добавить строку :

AddType application/x-httpd-php .phtml

Это определяет новый MIME тип, application/x-httpd-php, который будет вызывать модуль PHP, для обработки любого файла с расширением .phtml. Вы можете выбрать любое расширение, которое вам по душе.

Можно сделать так, чтобы не все могли выполнять PHP файлы. Для этого вы можете поместить вышеупомянутую AddType строку внутри <Location/path > .... < /Location > директивы в access.conf файле, чтобы только в определенных директориях вашего сервера PHP мог обрабатывать документы.

Теперь Вы готовы перезапустить ваш httpd сервер. Для более подробной информации см. примечания по конфигурированию модуля Apache.

Тестирование программного обеспечения

После установки вы можете протестировать, работает ли ваша программа, введя URL, подобный следующему в вашем броузере:

http://your.site.domain/cgi-bin/php.cgi

При этом должна показаться страница, которая содержит номер версии наряду с другой полезной информацией.

Чтобы проверить работу модуля Apache, создайте любой файл с .phtml расширением, поместите в него тэг подобно: <?phpinfo () > и посмотрите будет ли он анализироваться.

Использование программного обеспечения

Чтобы фактически использовать программное обеспечение на существующем HTML файле, Вы можете просто добавить путь к вашему файлу вышеупомянутому URL. То есть.

http://your.site.domain/cgi-bin/php.cgi/path/file.html

Вам нужно взглянуть на раздел Переадресация CGI этой документации. При выполнении PHP/FI с переадресацией вы можете автоматически задавать чтобы URL подобно http:/your.site.domain/file.phtml мог анализироваться PHP/FI.

Это не относится к пользователям программы, выполненной в виде модуля Apache.

[Назад] [Содержание] [Вперед]