Skip to content

apache2handler.md

Latest commit

 

History

History
80 lines (57 loc) · 2.49 KB

apache2handler.md

File metadata and controls

80 lines (57 loc) · 2.49 KB
Raw

The apache2handler SAPI

Configuration options

PHP_SAPI_APACHE2HANDLER

  • Default: OFF
  • Values: ON|OFF

Enables the shared Apache 2 handler SAPI module.

PHP_SAPI_APACHE2HANDLER_INSTALL_DIR

  • Default: The path to the Apache modules directory of the host system (Apache_LIBEXECDIR).

The path where to install the PHP Apache module (mod_php.so). Relative path is interpreted as being relative to the installation prefix CMAKE_INSTALL_PREFIX.

PHP_SAPI_APACHE2HANDLER_INSTALL_CONFIG

  • Default: OFF
  • Values: ON|OFF

Whether to activate the PHP module in the Apache configuration file httpd.conf during installation via apxs. When DESTDIR environment variable is set, module isn't enabled regardless of this option. This option is provided to skip installation into a staging directory or when Apache configuration is managed separately (e.g., via a2enmod).

This adds a line to Apache httpd.conf file, such as:

LoadModule php_module modules/mod_php.so

About

Loadable via Apache's Dynamic Shared Object (DSO) support. If Apache will use PHP together with one of the threaded Multi-Processing Modules (MPMs), PHP must be configured and built with PHP_THREAD_SAFETY set to ON. If threaded Apache is found on the system and PHP thread safety is not enabled during the configuration phase fatal error is emitted.

Examples

The path where to look for the Apache installation on the system can be customized with the APACHE_ROOT or CMAKE_PREFIX_PATH variables.

cmake -B php-build -DPHP_SAPI_APACHE2HANDLER=ON -DAPACHE_ROOT=/opt/apache2
# or
cmake -B php-build -DPHP_SAPI_APACHE2HANDLER=ON -DCMAKE_PREFIX_PATH=/opt/apache2

The path, where to install the PHP Apache module, can be overridden with the PHP_SAPI_APACHE2HANDLER_INSTALL_DIR variable. This might be used in edge cases where some specific custom installation prefix is used to avoid insufficient permissions of the default location on the host, or when developing the PHP build system.

cmake \
  -B <build-dir> \
  -DPHP_SAPI_APACHE2HANDLER=ON \
  -DPHP_SAPI_APACHE2HANDLER_INSTALL_DIR=/custom/path/to/lib/apache2/modules

Installation

Enabling PHP files handling in Apache configuration, e.g., httpd.conf:

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