ЧАВО
PHP Manual

Установка

Этот раздел содержит общие вопросы о том, как производится установка PHP. Дистрибутивы PHP есть почти для всех операционных систем и веб-серверов.

Для установки PHP, следуйте инструкциям: Установка и настройка.

  1. Почему лучше не пользоваться Apache2 с многопоточным "MPM" (event, worker) в промышленной эксплуатации?
  2. ОС "Unix"/"Windows": Где искать файл php.ini?
  3. Unix: Я установил PHP, но при каждом открытии какого-либо документа вижу 'Document Contains No Data' -- что это значит?
  4. Unix: Я установил PHP используя RPMS, но Apache не обрабатывает PHP-страницы, в чём дело?
  5. Unix: Я пропатчил Apache расширением FrontPage, и теперь PHP не работает. Т.е. PHP несовместим с расширениями Apache FrontPage?
  6. Unix/Windows: Я установил PHP, но при попытке открыть PHP-файл браузером вижу просто пустой экран.
  7. Unix/Windows: Я установил PHP, но когда пытаюсь посмотреть созданную PHP-страницу через браузер, то получаю ошибку 500.
  8. Некоторые операционные системы: Я установил PHP без каких либо ошибок, но когда пытаюсь запустить Apache, мне выводится ошибка: [mybox:user /src/php5] root# apachectl configtest apachectl: /usr/local/apache/bin/httpd Undefined symbols: _compress _uncompress
  9. Windows: Я установил PHP, но когда пытаюсь открыть страницу скрипта через браузер, получаю ошибку: cgi error: The specified CGI application misbehaved by not returning a complete set of HTTP headers. The headers it did return are:
  10. Windows: Я все сделал по инструкции, но PHP и IIS не хотят работать вместе!
  11. Когда я запускаю PHP как CGI на IIS, PWS, OmniHTTPD или Xitami, я получаю такую ошибку: Security Alert! PHP CGI cannot be accessed directly..
  12. Как я могу понять, что мой php.ini найден и используется? Такое впечатление, что вносимые мною изменения игнорируются.
  13. Как я могу добавить директорию с PHP в PATH в Windows?
  14. Как я могу сделать файл php.ini доступным для PHP в windows?
  15. Можно ли использовать согласование контента Apache (опция MultiViews) с PHP?
  16. PHP ограничен работой только с методами GET и POST?
Почему лучше не пользоваться Apache2 с многопоточным "MPM" (event, worker) в промышленной эксплуатации?

PHP подобен связующему звену. Он полезен для создания хороших веб-приложений путём объединения разрозненных сторонних библиотек в единое целое, через использование интуитивно понятного и простого для изучения языкового интерфейса. Гибкость и сила PHP основана на стабильности и устойчивости платформы, на которой он работает. Чтобы всё работало, нужна рабочая операционная система, рабочий веб-сервер и рабочие сторонние библиотеки. Но когда хоть что-либо из них перестаёт работать - PHP нуждается в способах быстрого определения причины неполадки и её устранения. И когда Вы усложняете базовый фреймворк тем, что не изолируете исполняемые потоки и сегменты памяти, и не предоставляете потокам отдельных изолированных "песочниц" - ослабляется вся PHP-система.

Если Вы пожелаете использовать многопоточный "MPM" - ознакомьтесь с конфигурацией "FastCGI", согласно которой PHP работает в собственном пространстве памяти.

ОС "Unix"/"Windows": Где искать файл php.ini?

По умолчанию, в Unix /usr/local/lib, что соответствует <установочный-путь>/lib. Многие захотят изменить путь в момент компиляции, используя опцию --with-config-file-path Например, можно написать так:

--with-config-file-path=/etc
И затем скопировать php.ini-development из дистрибутива в /etc/php.ini и внести в него все необходимые изменения.

--with-config-file-scan-dir=PATH

В ОС "Windows", по умолчанию, путь к файлу php.ini это путь к директории "Windows". Если Вы пользуетесь веб-сервером "Apache", php.ini находится по пути: ?\program files\apache group\apache\. Таким образом, на одном компьютере можно пользоваться несколькими php.ini файлами, соответственно версиям "Apache".

См. также: файл настроек.

Unix: Я установил PHP, но при каждом открытии какого-либо документа вижу 'Document Contains No Data' -- что это значит?

Это значит, что, возможно, PHP столкнулся с какой-то проблемой и падает в core-dump. Просмотрите логи ошибок сервера чтобы проверить это, и затем попытайтесь воспроизвести цепочку шагов, приведших к ошибке; например, создав отдельную тестовую программу. И если Вы умеете пользоваться 'gdb', то это поможет Вам получить backtrace для включения его в bug-report, чтобы облегчить выявление причин проблемы разработчикам. Если Вы пользуетесь PHP как модулем для Apache, вам может оказаться полезным следующее:

  • Остановите httpd-процессы

  • gdb httpd

  • Вновь остановите http-процессы

  • > run -X -f путь_к_httpd.conf

  • Затем скопируйте URL, с которым не справился browser

  • > run -X -f путь_к_httpd.conf

  • Если будет происходить core dump - gdb сообщит Вам об этом

  • type: bt

  • Включите backtrace в ваш bug-report. И отправьте по адресу: » http://bugs.php.net/

Если Ваш скрипт использует регулярные выражения (preg_match() и подобные), проверьте, с одинаковыми ли пакетами обработки RegEx скомпилированы PHP и Apache? В случае PHP и Apache 1.3.x это автоматизировано.

Unix: Я установил PHP используя RPMS, но Apache не обрабатывает PHP-страницы, в чём дело?

Если что вы установили и Apache, и PHP из RPM-пакетов, вам понадобится раскомментировать или добавить некоторые (или, быть может, все) строки из числа следующих, в вашем httpd.conf файле:

# Extra Modules
AddModule mod_php.c
AddModule mod_perl.c

# Extra Modules
LoadModule php_module         modules/mod_php.so
LoadModule php5_module        modules/libphp5.so
LoadModule perl_module        modules/libperl.so
И добавьте:
AddType application/x-httpd-php .php
... в область глобальных свойств, или в свойства того VirtualDomain, для которого Вы хотите включить поддержку PHP.

Unix: Я пропатчил Apache расширением FrontPage, и теперь PHP не работает. Т.е. PHP несовместим с расширениями Apache FrontPage?

Нет, совместим, но патч FrontPage влияет на структуры Apache, нужные для PHP. Перекомпиляция PHP (команда 'make clean ; make') после установки патча может решить проблему.

Unix/Windows: Я установил PHP, но при попытке открыть PHP-файл браузером вижу просто пустой экран.

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

Unix/Windows: Я установил PHP, но когда пытаюсь посмотреть созданную PHP-страницу через браузер, то получаю ошибку 500.

Что-то пошло не так, когда сервер попытался запустить PHP. Что бы увидеть возникающую исходную ошибку, в коммандной строке перейдите в директорию, содержащую исполняемый файл PHP (php.exe в Windows) и запустите php -i. Если существуют какие либо проблемы с запуском PHP, вам выведется соответствующая ошибка, которая подскажет вам, что надо исправить. Если вы увидете множество кода HTML (вывод функции phpinfo()), значит PHP работает нормально, и ваша проблема связана с настройками веб-сервера.

Некоторые операционные системы: Я установил PHP без каких либо ошибок, но когда пытаюсь запустить Apache, мне выводится ошибка:
[mybox:user /src/php5] root# apachectl configtest
 apachectl: /usr/local/apache/bin/httpd Undefined symbols:
  _compress
  _uncompress

Это означает, что проблема не в PHP, а в клиентских библиотеках MySQL. Некоторые из них требуют сборки PHP с опцией --with-zlib . Этот нюанс описан в MySQL FAQ.

Windows: Я установил PHP, но когда пытаюсь открыть страницу скрипта через браузер, получаю ошибку:
cgi error:
 The specified CGI application misbehaved by not
 returning a complete set of HTTP headers.
 The headers it did return are:

Это означает, что PHP не смог ничего вывести в стандартный поток ввода-вывода. Что бы увидеть возникающую исходную ошибку, в коммандной строке перейдите в директорию, содержащую исполняемый файл PHP (php.exe в Windows) и запустите php -i. Если существуют какие либо проблемы с запуском PHP, вам выведется соответствующая ошибка, которая подскажет вам, что надо исправить. Если вы увидете множество кода HTML (вывод функции phpinfo()), значит PHP работает нормально.

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

  • Права на файл вашего скрипта, php.exe, php5ts.dll, php.ini или какого либо расширения PHP не позволяют анонимному пользователю интернета ISUR_<machinename> к ним обратиться.
  • Файл скрипта отсутствует (или, возможно, он находится не там, где вы думаете, относительно корневого каталога веб-сервера). Обратите внимание, что в IIS, вы можете отловить эту ошибку, отметив опцию 'check file exists' в настройках "script mappings" в Internet Services Manager. Если файл отсутствует, сервер вместо этого вернет ошибку 404. При этом, также есть дополнительное преимущество. IIS будет производить проверки аутентификации для файла скрипта, необходимые вам, основываясь на разрешениях NTLanMan.
Windows: Я все сделал по инструкции, но PHP и IIS не хотят работать вместе!

Убедитесь, что все пользователи, которым может понадобиться запустить ваш PHP скрипт, имеют право запускать php.exe! IIS использует анонимного пользователя, создаваемого во время инсталляции. Этот пользователь должен иметь права на запуск php.exe. Так же, каждый авторизованный пользователь должен иметь права на запуск php.exe. Для IIS4 вы сказать ему, что PHP - это интерпритатор скриптов. Также прочтите этот FAQ.

Когда я запускаю PHP как CGI на IIS, PWS, OmniHTTPD или Xitami, я получаю такую ошибку: Security Alert! PHP CGI cannot be accessed directly..

Вы должны установить опцию cgi.force_redirect равную 0. По умолчанию она равна 1. Убедитесь, что она не закомментирована (с помощью ;). Как и все опции PHP, она настраивается в php.ini

Так как она по умолчанию равна 1, критически важно убедиться, что используется именно тот php.ini, который нужен. Читайте этот FAQ для подробностей.

Как я могу понять, что мой php.ini найден и используется? Такое впечатление, что вносимые мною изменения игнорируются.

Для проверки, какой именно php.ini используется, запустите функцию phpinfo(). Где-то вверху будет список с названием Configuration File (php.ini). Из него вы сможете понять, какой именно php.ini используется. Если указана только директория в PATH, а файл конфигурации не прочитан, то просто скопируйте его в эту директорию. Если php.ini включен PATH - это значит, что он прочитан.

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

Также смотрите описание php_ini_loaded_file().

Как я могу добавить директорию с PHP в PATH в Windows?

В Windows 7, XP, Vista, 2008, 2012 и выше:

  • Старт → Панель Управления → Система

  • Перейдите на вкладку 'Дополнительно'

  • Нажмите кнопку 'Переменные Окружения'

  • Посмотрите раздел 'Системные Переменные'

  • Найдите строку, содержащую переменную PATH

  • Совершите на ней двойной щелчек мышью

  • Допишите в конец строки путь к PHP, не забыв добавить перед ним ';' (например ;C:\php)

  • Нажмите OK

В Windows 98/Me вам нужно отредактировать файл autoexec.bat:

  • Откройте блокнот

  • Откройте в блокноте файл C:\autoexec.bat

  • Найдите строку PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;..... и добавьте в конце ;C:\php

  • Сохраните изменения и перезагрузите компьютер.

Замечание: Не забудьте перезагрузиться после описанных выше действий и, после перезагрузки, проверить, что переменная PATH содержит нужный путь.

В некоторых устаревших руководствах PHP предлагается поместить исполняемые файлы в системный каталог Windows потому, что (C:\Windows, C:\WINNT, и т.д..) по умолчанию заданы в переменной окружения PATH. Но на данный момент это не рекомендуется, поскольку может вызвать разнообразные проблемы.

Как я могу сделать файл php.ini доступным для PHP в windows?

Есть несколько путей сделать это. Если вы используете Apache, прочитайте следующие инструкции (Apache 1, Apache 2), также вы можете установить системную переменную PHPRC:

в Windows:

  • Старт → Панель Управления → Система

  • Перейдите на вкладку 'Дополнительно'

  • Нажмите кнопку 'Переменные Окружения'

  • Посмотрите раздел 'Системные Переменные'

  • Нажмите кнопку 'Добавить' и введите 'PHPRC' как имя переменной и директорию с php.ini в качестве ее значения (например C:\php)

  • Нажмите ОК и перезагрузите компьютер

В Windows 98/Me вам нужно отредактировать файл autoexec.bat:

  • Откройте блокнот

  • Откройте в блокноте файл C:\autoexec.bat

  • Добавьте новую строку в конце файла: set PHPRC=C:\php (замените C:\php на директорию, где лежит php.ini). Обратите внимание, что путь не должен содержать пробелов. К примеру, если файл лежит в C:\Program Files\PHP, вы должны указать короткое имя C:\PROGRA~1\PHP.

  • Сохраните файл и перезагрузите компьютер

Можно ли использовать согласование контента Apache (опция MultiViews) с PHP?

Если ссылки на файлы PHP содержат расширения, то все будет работать отлично. Это FAQ применимо только для случаев, когда ссылки не содержат расширения и вы хотите использовать согласование контента для файлов PHP из URL. В этом случае замените строку AddType application/x-httpd-php .php на:

AddHandler php5-script php
AddType text/html php
Это решение не сработает с Apache 1, так как модуль PHP не отлавливает php-script.

PHP ограничен работой только с методами GET и POST?

Нет, возможно работать с любыми запросами, например CONNECT. Правильный статус ответа должен будет посылаться функцией header(). Если вам надо, что бы PHP работать только с методами GET и POST, необходимо сконфигурировать Apache следующим образом:

<LimitExcept GET POST>
Deny from all
</LimitExcept>


ЧАВО
PHP Manual