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

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

Если Вы абсолютно не имеете никакого опыта работы с 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.

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