Почему index.php не выполняется: настройка сервера и устранение проблем

Раздел: Администрирование PHP -> Проблемы загрузки PHP

При попытке открыть сайт браузер может не выполнять index.php, а скачивать его или показывать пустую страницу. Это типичная проблема загрузки PHP, связанная с настройками веб-сервера, конфигурацией PHP или самим скриптом. В статье разобраны распространенные причины и способы их устранения.

Основные причины проблемы загрузки index.php

Как настроить Apache для корректного выполнения index.php?

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

Проверьте наличие модуля PHP командой apachectl -M | grep php. Если вывод пуст, модуль не подключен.
Установите и активируйте модуль (для Ubuntu/Debian):
```
sudo apt install libapache2-mod-php
sudo a2enmod php8.1
sudo systemctl restart apache2
```
Index php load (загрузка index.php)
Настройте DirectoryIndex в конфигурации хоста или в httpd.conf:
```
DirectoryIndex index.php index.html
```
Добавьте обработчик файлов .php (обычно устанавливается автоматически, но можно явно указать):
```
AddHandler application/x-httpd-php .php
```

Типичная ошибка: даже после установки модуля браузер скачивает index.php. Чаще всего это связано с отсутствием перезагрузки Apache или тем, что обработчик задан не для всех расширений. Проверьте, нет ли конфликта с директивами SetHandler или AddType.

Что делать, если PHP не установлен на сервере?

Установите PHP и соответствующий модуль для Apache. Пример для Ubuntu 22.04 с PHP 8.1:

sudo apt update
sudo apt install php8.1 php8.1-cli libapache2-mod-php8.1
sudo a2enmod php8.1
sudo systemctl restart apache2

После установки проверьте версию: php -v. Если используется другой сервер (nginx) - потребуется PHP-FPM.

Ошибка: при выполнении команды apt install может возникнуть конфликт с уже установленной версией PHP. Решение - полностью удалить старую версию или использовать phpenmod для выбора модуля.

Как использовать PHP-FPM для обработки index.php?

PHP-FPM применяется для отделения PHP-процесса от веб-сервера. Настройте пул и прокси в Apache (или nginx). Пример конфигурации Apache с mod_proxy_fcgi:

# В файле виртуального хоста
ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/var/www/html/$1

Убедитесь, что PHP-FPM запущен и слушает порт 9000 (или сокет). Команда проверки: sudo systemctl status php8.1-fpm.

Проблема: ошибка 502 Bad Gateway. Причины - не запущен PHP-FPM, неверный путь к сокету, либо пул настроен на другого пользователя.

Почему index.php выводит пустую страницу или мусор?

Частая причина - BOM (Byte Order Mark) в начале файла, который PHP не может обработать. Удалите BOM командой:

sed -i '1s/^\xEF\xBB\xBF//' index.php

Также включите отображение ошибок PHP в самом index.php для диагностики:

<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);
?>

Типичная ошибка: пустая страница при работающем PHP, но с синтаксической ошибкой. Команда php -l index.php проверяет синтаксис без выполнения.

Как исправить ошибку 403 или 500 при загрузке index.php?

Проверьте права доступа: файл должен быть читаемым для веб-сервера (обычно 644), директория - исполняемой (755). Для исправления:

chmod 644 index.php
chmod 755 /path/to/document_root

Ошибка 500 часто вызвана синтаксической ошибкой в PHP. Выполните проверку: php -l index.php. Также проверьте лог ошибок Apache: tail -f /var/log/apache2/error.log.

Особая проблема: SELinux или AppArmor блокируют доступ. Временное решение: setenforce 0 (не рекомендуется в production).

Как настроить обработку PHP через .htaccess без доступа к основному конфигу?

Если нет прав на изменение конфигурации Apache, используйте файл .htaccess в корне сайта. Пример:

<FilesMatch "\.php$">
    SetHandler application/x-httpd-php
</FilesMatch>

Убедитесь, что AllowOverride включает FileInfo в конфигурации Apache. Для проверки: sudo apachectl -S | grep AllowOverride.

Ошибка: директива SetHandler может конфликтовать с ранее заданным обработчиком из основного конфига. В таком случае используйте AddHandler или AddType.

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

1. Проверка загруженных модулей Apache

Команда для вывода всех модулей и поиска PHP:

Пример

apachectl -M | grep -i php
# или
sudo httpd -M 2>/dev/null | grep php

php8_module (shared)
php_module (static)

Если строка не появилась - модуль не загружен.

2. Полный пример конфигурации VirtualHost с PHP

Создайте файл /etc/apache2/sites-available/example.conf:

Пример

<VirtualHost *:80>
    ServerAdmin admin@example.com
    ServerName example.com
    DocumentRoot /var/www/example

    <Directory /var/www/example>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    DirectoryIndex index.php index.html

    AddHandler application/x-httpd-php .php

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Активируйте сайт: sudo a2ensite example.conf и перезагрузите Apache.

3. Настройка PHP-FPM с Unix-сокетом (Apache + mod_proxy_fcgi)

Установите PHP-FPM: sudo apt install php8.1-fpm. Редактируйте пул /etc/php/8.1/fpm/pool.d/www.conf, измените строку на сокет:

Пример

listen = /run/php/php8.1-fpm.sock
listen.owner = www-data
listen.group = www-data

В конфигурации VirtualHost добавьте:

Пример

<FilesMatch ".php$">
    SetHandler "proxy:unix:/run/php/php8.1-fpm.sock|fcgi://localhost"
</FilesMatch>

Перезапустите PHP-FPM и Apache.

sudo systemctl restart php8.1-fpm
sudo systemctl restart apache2

4. Удаление BOM из всех PHP-файлов рекурсивно

Используйте find с sed для обработки всех PHP-файлов в проекте:

Пример

find /var/www/html -name "*.php" -type f -exec sed -i '1s/^\xEF\xBB\xBF//' {} \;

Проверить наличие BOM можно с помощью xxd: xxd index.php | head -1. Если первые байты ef bb bf - BOM присутствует.

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

Если веб-сервер по умолчанию обрабатывает index.html, но не index.php, можно перенаправить запросы:

Пример

RewriteEngine On
RewriteRule ^$ index.php [L]

Поместите этот код в .htaccess. Убедитесь, что модуль Rewrite включен: sudo a2enmod rewrite.

6. Диагностика с помощью phpinfo()

Создайте временный файл info.php с единственной строкой:

Пример

<?php phpinfo(); ?>

Откройте в браузере http://example.com/info.php. Если страница покажет информацию о PHP - сервер обрабатывает .php файлы. Если пустая или ошибка - проблема в настройках.

Внимание: не оставляйте info.php на production-сервере - удалите его после диагностики.

Загрузка index.php - comments

Index php load (php)