PHP support

Ferron supports running PHP scripts either with a cgi module (using PHP-CGI) or with a fcgi module (using either PHP-CGI configured as a FastCGI server or PHP-FPM). This allows you to host websites built with PHP-based CMSes (like WordPress or Joomla) with Ferron.

To configure PHP through CGI with Ferron, you can use this configuration:

# Example global configuration with PHP through CGI
global:
  wwwroot: /var/www/html # Replace it with the path to the webroot
  loadModules:
    - cgi
  cgiScriptExtensions:
    - .php

To configure PHP through FastCGI with Ferron, you can use this configuration:

# Example global configuration with PHP through FastCGI
global:
  wwwroot: /var/www/html # Replace it with the path to the webroot
  loadModules:
    - fcgi
  fcgiScriptExtensions:
    - .php
  fcgiTo: unix:///run/php/php8.2-fpm.sock # Replace with the Unix socket URL with actual path to the PHP FastCGI daemon socket.

# Also, if using Unix socket with PHP-FPM,
# set the listener owner and group in the pool configuration to the web server user (`ferron`, if you used installer for GNU/Linux)
# For example:
#   listen.owner = ferron
#   listen.group = ferron

To ensure optimal web server performance and efficiency, it is recommended to use FastCGI instead of CGI, as FastCGI keeps PHP processes running persistently, reducing the overhead of starting a new process for each request, therefore improving response times and resource utilization.