Цей розділ містить загальні питання по встановленню PHP. PHP доступна майже для будь-яких операційних систем та для більшості вебсерверів.
Щоб встановити PHP, пройдіть кроки описані в розділі Встановлення та налаштування.
PHP виконує функції своєрідного клея. Цей клей використовується щоб створювати класні вебзастосунки, з'єднуючи дюжину сторонніх бібліотек разом та створюючи враження єдиного злагодженого цілого, при використанні інтуїтивно-зрозумілого та легкого для навчання інтерфейсу мови. Гнучкість та потужність PHP спирається на стабільність та надійність базової платформи. Потрібно щоб працювала ОС, працював вебсервер, та працювали сторонні бібліотеки з'єднані разом. Якщо будь-хто з них зупинеться, то для PHP потрібен спосіб для виявлення цієї проблеми та швидкого виправлення. Коли ви робите звичайні умови розробки більш складними, при цьому не маючи повністю розділених виконавчих потоків, повністю розділених сегментів пам'яті, та міцьного майданчику для експерементальних розробок, то це означає, що у вашої PHP-системі з'являються слабкі місця.
Якщо ви хочете використовувати потоковий MPM, спробуйте сконфігурувати FastCGI, під яким можна виділяти окремий простір пам'яті для PHP.
Початково в Unix-системах він повинен бути в /usr/local/lib, що визначається як <шлях-встановлення>/lib. Більшість користувачів змінює його під час компіляції через флаг --with-config-file-path. Тобто, наприклад, це можна зробити так:
--with-config-file-path=/etc
--with-config-file-scan-dir=PATH
У Windows початково, шлях для php.ini, веде до директорії Windows. Якщо ви використовуєте вебсервер Apache, файл php.ini спочатку шукається в директорії, де встановлено Apache, наприклад в c:\program files\apache group\apache. В такому разі, ви можете мати кілька різних файлів php.ini для різних версій Apache на одній і тій самій машині.
Прочитайте також інформацію про Файл конфігурації.
Це ймовірно означає, що в 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
Якщо припустити, що ви встановили 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
Ні, PHP добре працює з розширенням FrontPage. Проблема в тому, що латка FrontPage змінює деякі структури Apache, на які PHP покладається. Перекомпіляція PHP (використовуючи 'make clean ; make') після встановлення латки FrontPage, повинна вирішити цю проблему.
Прогляньте код (view source) у браузері, і ви мабуть побачите початковий код PHP-скрипта. Це означає, що вебсервер не відправляє скрипт до PHP-інтерпретатора. Тобто є якісь помилки в конфігурації вебсервера, то ж двічі перевірте цю конфігурацію, дотримуючись інструкцій встановлення PHP.
Щось помилкове стається, коли вебсервер намагається запустити PHP. Щоб побачити зрозумілі повідомлення помилок, з командного рядка, змініть поточну директорію на ту, де знаходиться виконавчий файл PHP (у Windows це php.exe) та запустіть php -i. Якщо PHP матиме будь-яку проблему, то вона покаже відповідне повідомлення помилки, яке дасть вам уявлення "що робити далі". Якщо ж вам видається повен екран HTML-коду (що є виводом функції phpinfo()), то PHP працює справно, і проблема можливо стосується конфігурації вебсервера, яку вам потрібно двічі перевірити.
[mybox:user /src/php5] root# apachectl configtest apachectl: /usr/local/apache/bin/httpd Undefined symbols: _compress _uncompress
Це повідомлення насправді стосується не PHP, а клієнтської бібліотеки MySQL. В деяких випадках потрібно --with-zlib, а в деяких - ні. Дана проблема згадана в ЧаПі MySQL.
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-розширення, яке ви намагаєтесь завантажити.
Переконайтесь, що всі користувачі, кому потрібно запускати PHP-скрипти, мають права на запуск php.exe! IIS використовує анонімного користувача, який додається під час встановлення IIS. Цьому користувачу потрібні права на запуск php.exe. Права на запуск php.exe також потрібні для будь-якого авторизованого користувача. А IIS4, потрібно повідомити, що PHP є скриптовою системою. Також, вам буде цікаво прочитати цей пункт ЧАПу.
Security Alert! PHP CGI
cannot be accessed directly.
Вам потрібно встановити для директиви
cgi.force_redirect значення 0
(початково
встановлено 1
), а також переконайтесь, цю що директиву
не закоментовано (через символ крапки-з-комою ;
). Як і всі
директиви, вона також знаходиться у файлі php.ini
Оскільки початково встановлено 1
, то дуже важливо,
щоб ви переконались на 100%, що буде читатись коректний файл 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().
На Windows:
Перейдіть в Панель керування та кляцніть по ярлику Система (Старт → Панель керування)
Перейдіть на закладку Додатково
Клікніть кнопку 'Змінні оточення'
Огляньте блок 'Системні Змінні'
Знайдіть запис Path (можливо потрібно прокрутити список, щоб знайти цю змінну)
Подвійним кліком відкрийте знайдений запис Path
Допишіть до існуючого запису символ ';' (якщо його немає в кінці) і далі
впишіть шлях до вашої директорії PHP (напр. ;C:\php
)
Натискайте OK
Зауваження: Не забудьте перезавантажитись після того, як пройдете зазначені вище кроки, щоб зміни для PATH були задіяні.
Є кілька варіантів це зробити. Якщо ви використовуєте Apache, зверніться до документації Apache, в іншому випадку — ви повинні встановити змінну оточення PHPRC:
Windows: Як перевірити, що PHP на сервері IIS має право запису до тимчасової директорії?
Це можна зробити в Провідникові, перейшовши у "Властивості" тимчасової директорії (%TEMP%). Шлях до тимчасової директорії можна дізнатися під час налаштування або через функцію phpinfo().
Для IIS, перевірити, чи користувач IIS_User
має
дозвіл MODIFY
.
Якщо посилатись на файли PHP разом з розширенням, то все працює справно.
Цей пункт ЧАПу призначений тільки для випадку, коли посилання на файли PHP
не містять розширення, та ви хочете використовувати Content Negotiation для
вибору файлів PHP з URL без розширень. В цьому випадку, замініть рядок
AddType application/x-httpd-php .php
на такий:
AddHandler php5-script php AddType text/html php
php-script
.
Ні, навпаки - можна обробляти запити, що відправляються будь-яким методом, наприклад, CONNECT. Правильну відповідь статуса можна відправляти через функцію header(). Якщо ж вам потрібно, щоб оброблялись тільки методи GET та POST, цього можна добитись завдяки наступній конфігурації Apache:
<LimitExcept GET POST> Deny from all </LimitExcept>