Когда index.php отказывается запускаться: причины и методики восстановления

Расширенные примеры отладки и настройки

1. Проверка работы PHP-FPM с помощью скрипта-теста

Создайте файл ping.php (или используйте встроенный ping-скрипт PHP-FPM):

<?php
// Проверка, что PHP интерпретатор жив
echo 'PHP работает. Версия: ' . phpversion();
file_put_contents('/tmp/php_test.log', date('Y-m-d H:i:s') . ' - test executed' . PHP_EOL, FILE_APPEND);
?>

Перейдите на http://ваш-сайт/ping.php. Если видите сообщение - PHP-FPM активен. Если нет - проверьте статус PHP-FPM:

systemctl status php8.1-fpm   # или php7.4-fpm

Пример вывода лога (содержимое /tmp/php_test.log):

2025-03-25 14:32:10 - test executed

2. Диагностика прав и владельца в нескольких сценариях

Иногда index.php не выполняется из-за неверного владельца или группы, особенно после копирования файлов через FTP. Выполните команды и проанализируйте:

# текущие права
ls -la /var/www/html/index.php

# установка правильных прав (644 - чтение/запись для владельца, чтение для групп и остальных)
chmod 644 /var/www/html/index.php

# смена владельца на пользователя веб-сервера (www-data для Apache Ubuntu)
chown www-data:www-data /var/www/html/index.php

# если используется PHP-FPM с другим пользователем, проверьте в pool.d/... конфиг
cat /etc/php/8.1/fpm/pool.d/www.conf | grep user

Проблема может возникнуть, когда PHP-FPM работает от пользователя, не имеющего доступа к файлу. Например, владелец root, а пользователь www-data - файл не будет прочитан. Используйте ps aux | grep php-fpm чтобы узнать реального пользователя.

3. Эмуляция запроса к index.php через cURL для анализа заголовков

Иногда веб-сервер возвращает статус 200, но html пустой. cURL покажет все заголовки и тело ответа:

curl -v http://localhost/index.php

Пример вывода (фрагмент):

* Connected to localhost (127.0.0.1) port 80 (#0)
> GET /index.php HTTP/1.1
> Host: localhost
> User-Agent: curl/7.68.0
...
< HTTP/1.1 200 OK
< Content-Type: text/html; charset=UTF-8
< 
* Empty reply from server  # если тело пустое

Если ответ пустой, добавьте в код index.php принудительную буферизацию:

ob_start();
echo 'test';
ob_flush();

4. Проверка директивы open_basedir, блокирующей подключения

Если index.php пытается подключить файл за пределами разрешенной директории, PHP выдаст предупреждение, но может не отобразить ошибку. Проверьте ограничение:

php -r 'echo ini_get("open_basedir");'

В index.php добавьте:

<?php
var_dump(ini_get('open_basedir'));
include '/etc/passwd';  // заведомо запрещённый файл
?>

Ожидаемый вывод в логах:

PHP Warning:  include(): open_basedir restriction in effect. File(/etc/passwd) is not within the allowed path(s): (/var/www/html) in /var/www/html/index.php on line 3

Решение - либо изменить open_basedir в php.ini, либо перенести подключаемые файлы в разрешенную папку.

5. Использование Xdebug для пошаговой трассировки index.php

Если другие методы не помогают, установите Xdebug и настройте его для удаленной отладки (на локальном сервере). В php.ini добавьте:

zend_extension=xdebug
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

Затем запустите IDE (например, PhpStorm) в режиме «Listen for Debug Connections». Выполните запрос к index.php - отладчик остановится на первой строке. Это позволяет пройти выполнение по шагам и выявить точную причину (например, бесконечный цикл, непойманное исключение).

6. Сравнение настроек PHP через diff-вывод двух phpinfo()

Если проблема воспроизводится на одном сервере и нет на другом, сохраните вывод phpinfo() в файл и сравните:

php -r 'phpinfo();' | head -200 > local_info.txt
curl http://remoteserver.com/test.php 2>/dev/null | sed -n '//,/<\/table>/p' > remote_info.txt
diff -u local_info.txt remote_info.txt | grep -E '^[-+].*[a-z]'
Пример различий, которые могут влиять на работу index.php:
- display_errors           On    On
+ display_errors           Off   On
- short_open_tag           On    On
+ short_open_tag           Off   On
Здесь на удаленном сервере short_open_tag выключен - если index.php использует <? ?>, он не выполнится.
7. Комбинированный подход: отключение расширений через тестовый файл
Иногда проблема вызвана конфликтом расширений PHP. Создайте минимальный index.php без расширений и постепенно подключайте их:
Пример 

<?php
// Без расширений
echo 'No extensions';
// Затем раскомментируйте одну из следующих строк и проверяйте
// xdebug_start_trace();
// new mysqli();
// new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
?>
Если с отключенными расширениями страница работает, а с одним из них - нет, значит проблема именно в этом модуле (например, устаревшая версия, неверные настройки).

		
Проблемы с index.php - comments
En
Index php не работает (php)