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

Цей розділ містить загальні питання по встановленню PHP. PHP доступна майже для будь-яких операційних систем та для більшості вебсерверів.

Щоб встановити 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) у звіт про неполадку на сайті » https://github.com/php/php-src/issues

Якщо ваш скрипт використовує функцію регулярного виразу (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:

• Перейдіть в Панель керування та кляцніть по ярлику Система (Старт → Панель керування)

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

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

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

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

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

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

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

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

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

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

Windows: Як перевірити, що PHP на сервері IIS має право запису до тимчасової директорії?

1. Це можна зробити в Провідникові, перейшовши у "Властивості" тимчасової директорії (%TEMP%). Шлях до тимчасової директорії можна дізнатися під час налаштування або через функцію phpinfo().

2. Для IIS, перевірити, чи користувач IIS_User має дозвіл MODIFY.

Чи можна використовувати 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>