Конфигурация MIME-типа application/x-httpd-php в веб-сервере

Расширенные примеры конфигурации и проверки

Ниже приведены подробные примеры для различных ситуаций, включая нестандартные расширения и комбинированные настройки.

Пример 1: Обработка нескольких расширений через AddHandler

Если требуется, чтобы PHP обрабатывал файлы с расширениями .php, .phtml и .php5, можно указать их в одной директиве:

AddHandler application/x-httpd-php .php .phtml .php5

После перезагрузки сервера файлы с любым из этих расширений будут интерпретироваться как PHP. Проверка:

$ echo '<? echo "PHP работает"; ?>' > test.php5
$ curl http://localhost/test.php5
PHP работает

Пример 2: SetHandler с регулярным выражением для вложенных путей

Назначить обработчик только для PHP-файлов, находящихся в каталоге /api:

<Directory /var/www/html/api>
    <FilesMatch \.php$>
        SetHandler application/x-httpd-php
    </FilesMatch>
</Directory>

Это предотвращает обработку PHP-файлов вне этого каталога. Результат: файлы /api/index.php обрабатываются, а /test.php - нет.

Пример 3: Комбинация с mod_rewrite для скрытия расширения

Часто требуется обрабатывать URL без .php (например, /page) с помощью внутреннего перенаправления. При этом MIME-тип должен назначаться на финальный файл:

RewriteEngine On
RewriteRule ^page$ page.php [L]

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

После перезаписи Apache видит page.php и передаёт его обработчику PHP. Без SetHandler файл может быть отдан как текст.

Пример 4: Использование AllowOverride и .htaccess в подкаталогах

Для включения .htaccess в конкретном подкаталоге без глобальных изменений:

# В httpd.conf
<Directory /var/www/html/site>
    AllowOverride FileInfo
</Directory>

# В /var/www/html/site/.htaccess
AddHandler application/x-httpd-php .php

Теперь только в папке site .php-файлы будут обрабатываться. Ошибка: если AllowOverride не включает FileInfo, директива игнорируется. Проверить через:

$ curl -I http://localhost/site/test.php | grep Content-Type
Content-Type: text/html; charset=UTF-8   # Если работает PHP

# При ошибке (без обработки):
Content-Type: application/x-httpd-php   # или text/plain

Пример 5: Добавление MIME-типа в конфигурацию через mod_mime

Можно зарегистрировать MIME-тип без ручного редактирования mime.types с помощью директивы AddType внутри виртуального хоста:

<VirtualHost *:80>
    DocumentRoot /var/www/example
    AddType application/x-httpd-php .php
    Action application/x-httpd-php /cgi-bin/php
</VirtualHost>

Директива Action связывает MIME-тип с CGI-скриптом (используется редко, в основном для suPHP). Результат: каждый запрос .php запускает указанный CGI-обработчик.

Пример 6: Проверка через PHP-информацию

Чтобы убедиться, что файл обрабатывается PHP, создаём скрипт:

<?php
phpinfo();
?>

Если в выводе присутствует раздел Server API со значением Apache 2.0 Handler, то MIME-тип application/x-httpd-php работает. Для php-fpm будет указано FPM/FastCGI.

Пример 7: Обработка ошибок при неправильном MIME-типе

Если файл не обрабатывается, можно включить логирование:

# В httpd.conf
LogLevel alert rewrite:trace6
CustomLog /var/log/apache2/php-handler.log "%h %r %>s %{Content-Type}o"

В логе будет видно, какой Content-Type возвращается. Если он application/x-httpd-php без обработки - значит, нет соответствующего Action или обработчика.

Пример 8: Настройка для PHP 8 (несколько версий)

При использовании нескольких версий PHP через разные MIME-типы:

AddHandler application/x-httpd-php8 .php
Action application/x-httpd-php8 /usr/lib/cgi-bin/php8

Это позволяет разным виртуальным хостам использовать свою версию PHP. Однако требуется наличие соответствующего CGI-бинарника.

Совет: для современных проектов лучше перейти на php-fpm, так как mod_php устарел и не поддерживается в некоторых дистрибутивах (например, Ubuntu 22.04+). MIME-тип application/x-httpd-php остаётся актуальным только для legacy-систем.