Встановлення

Цей розділ містить загальні питання по встановленню PHP. PHP доступна майже для будь-яких Операційних Систем (можливо лише за виключенням MacOS перед OSX), та для більшості веб-серверів.

Щоб встановити PHP, пройдіть кроки описані в розділі Встановлення та Налаштування.

Чому я не повинен використовувати Apache2 з потоковим MPM на робочих серверах?

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 спочатку шукається в директорії, де встановлено Apache, наприклад в c:\program files\apache group\apache. В такому разі, ви можете мати кілька різних файлів php.ini для різних версій Apache на одній і тій самій машині.

Прочитайте також інформацію про Файл конфігурації.

Unix: Я встановив PHP, але кожен раз завантажуючи документ, я отримую повідомлення 'Document Contains No Data'! (Документ не містить даних) Чому так відбувається?

Це ймовірно означає, що в PHP виникли деякі проблеми, та її ядро впало. Продивіться журнали помилок сервера, та спробуйте відтворити проблему створивши невеличкий тест. Якщо ви знаєте як використовувати 'gdb', це може бути дуже корисним, бо ви можете надати зворотній слід (backtrace) разом з вашим звітом про неполадку, щоб допомогти розробникам точно визначити проблему. Якщо ви використовуєте PHP як модуль Apache, спробуйте щось схоже на це:

• Зупиніть процес httpd, та виконайте наступну команду:

• gdb httpd

• Зупиніть процес httpd, та виконайте наступну команду:

• > run -X -f /шлях/до/httpd.conf

• Потім через браузер викличте URL, що викликає вашу проблему, та виконайте наступну команду:

• > run -X -f /шлях/до/httpd.conf

• Якщо ядро впаде, gdb повинен проінформувати вас про це

• виконайте команду: bt

• Вам потрібно включити отриманий зворотній слід (backtrace) у звіт про неполадку на сайті » http://bugs.php.net/

Якщо ваш скрипт використовує функцію регулярного виразу (preg_match() та подібні), потрібно переконатись, що ви зібрали PHP та Apache з одним і тим же пакетом регулярних виразів. Це повинно відбуватись автоматично з PHP та Apache 1.3.x

Unix: Я встановив PHP використовуючи RPMS, але Apache не обробляє сторінки PHP! Чому так відбувається?

Якщо припустити, що ви встановили Apache та PHP з пакетів RPM, то в такому разі, вам потрібно розкоментувати або додати кілька або всі рядки у ваш файл httpd.conf:

# Додаткові модулі
AddModule mod_php.c
AddModule mod_perl.c

# Додаткові модулі
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 з розширенням FrontPage для Apache несумісні?

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

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

Прогляньте сирцевий код (view source) у веб-браузері, і ви мабуть побачите сирцевий код PHP-скрипта. Це означає, що веб-сервер не відправляє скрипт до PHP-інтерпритатора. Тобто є якісь помилки в конфігурації веб-сервера, то ж двічі перевірте цю конфігурацію, дотримуючись інструкцій встановлення PHP.

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

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

Деякі Операційні Системи: Я встановив PHP без помилок, але коли намагаюсь запустити Apache, то отримую помилки "undefined symbol" (невизначений символ):

[mybox:user /src/php5] root# apachectl configtest
 apachectl: /usr/local/apache/bin/httpd Undefined symbols:
  _compress
  _uncompress

Це повідомлення насправді стосується не PHP, а клієнтської бібліотеки MySQL. В деяких випадках потрібно --with-zlib , а в деяких - ні. Дана проблема згадана в ЧАПі MySQL.

Windows: Я встановив PHP, але коли намагаюсь доступитись до 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 (у Windows це php.exe) та запустіть команду php -i. Якщо PHP матиме будь-яку проблему, то вона покаже відповідне повідомлення помилки, яке дасть вам уявлення "що робити далі". Якщо ж вам видається повен екран HTML-коду (що є виводом функції phpinfo()), то PHP працює справно.

Як тільки PHP справно запрацює, з командного рядка, спробуйте знову доступитись до скрипта через браузер. Якщо проблема ще залишається, то причина може бути однією з наступних:

• Анонімний інтернет-користувач ISUR_<тут-ім'я-машини>, через відсутність прав, не може отримати доступ до PHP-скриптів, php.exe, php5ts.dll, php.ini або до будь-якого PHP-розширення, яке ви намагаєтесь завантажити.
• Файла зі скриптом не існує (або, можливо, він не там, де ви його уявляєте, по відношенню до кореневої директорії вашого веб-сервера). Зауважте, що в IIS ви можете попастись на це повідомлення, якщо поставите галочку 'check file exists' (перевіряти наявність файла) під час налаштування співставлення скриптів (їх мапінгу) в Менеджері Internet Services. Насправді, якщо файлу зі скриптом не існує, то веб-сервер повертатиме 404 помилку. Також існує додаткова перевага в тому, що IIS буде виконувати будь-яку автентифікацію, яка базується на NTLanMan-дозволах для файлів зі скриптами.

Windows: Я дотримувався всіх інструкцій, але все ще не можу запустити PHP та IIS, для їх сумісної роботи!

Переконайтесь, що всі користувачі, кому потрібно запускати PHP-скрипти, мають права на запуск php.exe! IIS використовує анонімного користувача, який додається під час встановлення IIS. Цьому користувачу потрібні права на запуск php.exe. Права на запуск php.exe також потрібні для будь-якого авторизованого користувача. А IIS4, потрібно повідомити, що PHP є скриптовою системою. Також, вам буде цікаво прочитати цей пункт ЧАПу.

При запуску PHP як CGI на IIS, PWS, OmniHTTPD або Xitami, я отримую наступну помилку: Security Alert! PHP CGI cannot be accessed directly.

Вам потрібно встановити для директиви cgi.force_redirect значення 0 (початково встановлено 1), а також переконайтесь, цю що директиву не закоментовано (через символ крапки-з-комою ;). Як і всі директиви, вона також знаходиться у файлі php.ini

Оскільки початково встановлено 1, то дуже важливо, щоб ви переконались на 100%, що буде читатись коректний файл php.ini. Читайте детальніше в цьому пункті ЧАПу.

Як я можу переконатись, що мій файл php.ini знаходиться та читається? Схоже, що коли я його змінюю, мої зміни не впроваджуються.

Щоб переконатись, що файл php.ini читається через PHP, викличте функцію phpinfo(). Вгорі виведеної таблиці, знайдіть пункт Configuration File (php.ini), де буде перелік, де саме PHP шукає файл php.ini та чи було його прочитано. Якщо вказати тільки директорію PATH, то файл не буде прочитано; вам слід покласти php.ini в цю директорію. Якщо php.ini знаходиться в PATH, його буде прочитано.

Якщо php.ini знаходиться в місці, де він читається, та PHP запущено як модуль, то переконайтесь, що ви перезапустили веб-сервер після внесення змін до php.ini

Також прогляньте php_ini_loaded_file().

Як я можу додати директорію PHP до PATH на Windows?

На Windows NT+ та Windows Server 2000+:

• Перейдіть в Панель Керування та клікніть на ярлику Система (Старт -> Налаштування -> Панель Керування -> Система, або просто Старт -> Панель Керування -> Система на Windows XP/2003+)

• Перейдіть на закладку Додатково

• Клікніть кнопку 'Змінні оточення'

• Огляньте блок 'Системні Змінні'

• Знайдіть запис Path (можливо потрібно прокрутити список, щоб знайти цю змінну)

• Подвійним кліком відкрийте знайдений запис Path

• Допишіть до існуючого запису символ ';' (якщо його немає в кінці) і далі впишіть шлях до вашої директорії PHP (напр. ;C:\php)

• Натискайте OK

У Windows 98/Me вам потрібно змінити файл autoexec.bat:

• Відкрийте Блокнот (Старт -> Виконати та введіть notepad)

• Відкрийте файл C:\autoexec.bat

• Знайдіть рядок із PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;..... та допишіть: ;C:\php в кінець рядка

• Збережіть файл та перезапустіть ком'ютер

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

В даному PHP посібнику ще залишились рекомендації копіювання файлів в системну директорію Windows. Такі рекомендації писались тільки через те, що ця директорія (C:\Windows, C:\WINNT, і т.д.) початково є в системній змінній PATH. На даний момент, рекомендація копіювання файлів в системну директорію Windows давно вже є застарілою та може спричиняти проблеми.

Як зробити доступним файл php.ini для PHP на Windows?

Є кілька варіантів це зробити. Якщо ви використовуєте Apache, прочитайте призначені для нього інструкції встановлення (Apache 1, Apache 2), в іншому випадку - ви повинні встановити змінну оточення PHPRC:

На Windows NT, 2000, XP та 2003:

• Перейдіть в Панель Керування та клікніть ярлик Система (Старт -> Налаштування -> Панель Керування -> Система, або просто Старт -> Панель Керування -> Система на Windows XP/2003)

• Перейдіть на закладку Додатково

• Клікніть кнопку 'Змінні Оточення'

• Знайдіть область 'Системні змінні'

• Клікніть 'Нова' та введіть 'PHPRC' як назву змінної, а шлях до директорії, де розміщено php.ini як значення цієї змінної (наприклад C:\php)

• Натискайте OK та перезавантажуйте ком'ютер

На Windows 98/Me вам потрібно змінити файл autoexec.bat:

• Відкрийте Notepad (Старт -> Виконати та введіть notepad)

• Відкрийте файл C:\autoexec.bat

• Додайте новий рядок в кінець файла та допишіть в нього: set PHPRC=C:\php (тільки замініть C:\php на шлях до директорії, де розміщено php.ini). Пам'ятайте, що шлях до директорії не може містити пробіли. Наприклад, якщо ви встановили PHP в C:\Program Files\PHP, вам потрібно вписувати замість нього шлях C:\PROGRA~1\PHP.

• Збережіть файл та перезавантажте комп'ютер

Чи можна використовувати Apache Content Negotiation (опцію MultiViews) разом з PHP?

Якщо посилатись на файли PHP разом з розширенням, то все працює справно. Цей пункт ЧАПу призначений тільки для випадку, коли посилання на файли PHP не містять розширення, та ви хочете використовувати Content Negotiation для вибору файлів 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(). Якщо ж вам потрібно, щоб оброблялись тільки методи GET та POST, цього можна добитись завдяки наступній конфігурації Apache:

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