Server support blog

I was looking for working config for the combination of apache mod_fastcgi and PHP-FPM and could not find any. I mean there were plenty of examples and discussions but none of them were operational. The closest was the article on server-world.info site.
Based on that information I was able to put together working configuration for multiple virtual hosts.

• Initial assumption – we have Centos with installed stock httpd, mod_fastcgi (from rpmforge repository) and php54-fpm as part of IUS repository packaged php-5.4 modules
• Apache configured as prefork, php-fpm configured with 3 process pools on TCP ports (while unix socket considered by many as fast way of communication with FastCGI server it is known with data loss under heavy load. So we will configure port 9000 – default, PHP process user/group apache/apache. 9001 – domainA, user/group userA/groupA correspondingly, 9002 – domainB, userB/groupB
• default pool configuration
  
  default php-fpm pool configuration

  INI

  [www] listen = 127.0.0.1:9000 listen.allowed_clients = 127.0.0.1 ;listen=/var/run/php-www.sock ;listen.backlog = -1 ;listen.owner = web ;listen.group = www ;listen.mode = 0666 user = apache group = apache pm.status_path = /fpm-status pm = dynamic pm.max_children = 20 pm.start_servers = 4 pm.min_spare_servers = 4 pm.max_spare_servers = 10 pm.max_requests = 500 request_terminate_timeout = 600s rlimit_files = 131072 rlimit_core = unlimited catch_workers_output = yes ; environment env[TMP]=/dev/shm env[TEMP]=/dev/shm ; admin flags php_admin_flag[log_errors] = on php_admin_value[error_log] = /var/log/httpd/fpm-error.log ;php_flag[display_errors] = on ;php_flag[display_startup_errors] = on php_admin_value[memory_limit] = 128M php_value[session.save_handler] = files php_value[session.save_path] = /dev/shm

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35

  [www] listen = 127.0.0.1:9000 listen.allowed_clients = 127.0.0.1   ;listen=/var/run/php-www.sock ;listen.backlog = -1 ;listen.owner = web ;listen.group = www ;listen.mode = 0666   user = apache group = apache   pm.status_path = /fpm-status pm = dynamic pm.max_children = 20 pm.start_servers = 4 pm.min_spare_servers = 4 pm.max_spare_servers = 10 pm.max_requests = 500 request_terminate_timeout = 600s rlimit_files = 131072 rlimit_core = unlimited catch_workers_output = yes ; environment env[TMP]=/dev/shm env[TEMP]=/dev/shm ; admin flags php_admin_flag[log_errors] = on php_admin_value[error_log] = /var/log/httpd/fpm-error.log ;php_flag[display_errors] = on ;php_flag[display_startup_errors] = on php_admin_value[memory_limit] = 128M php_value[session.save_handler] = files php_value[session.save_path] = /dev/shm

  The only 4 differences between this pool configuration and domainA and domainB pool configurations would be – pool name, port number, process user/group. Configure php-fpm pools for domainA and domainB with different pool names, port numbers and user/group accordingly.

• Now, apache /etc/httpd/conf.d/fastcgi.conf
  Apache

  User apache Group apache LoadModule fastcgi_module modules/mod_fastcgi.so FastCgiIpcDir /var/run/mod_fastcgi FastCgiConfig -idle-timeout 20 -maxClassProcesses 1 AddType application/x-httpd-php .php DirectoryIndex index.php AddHandler php-fastcgi .php Action php-fastcgi /php-fastcgi ScriptAlias /php-fastcgi /var/www/cgi-bin/php-fastcgi FastCgiExternalServer /var/www/cgi-bin/php-fastcgi -host 127.0.0.1:9000 -pass-header Authorization

  1 2 3 4 5 6 7 8 9 10 11

  User apache Group apache LoadModule fastcgi_module modules/mod_fastcgi.so FastCgiIpcDir /var/run/mod_fastcgi FastCgiConfig -idle-timeout 20 -maxClassProcesses 1 AddType application/x-httpd-php .php DirectoryIndex index.php AddHandler php-fastcgi .php Action php-fastcgi /php-fastcgi ScriptAlias /php-fastcgi  /var/www/cgi-bin/php-fastcgi FastCgiExternalServer /var/www/cgi-bin/php-fastcgi -host 127.0.0.1:9000 -pass-header Authorization

  There are 4 important lines in it – AddHandler, Action, ScriptAlias, FastCgiExternalServer that will appear again in virtual host configuration. Directory configured in ScriptAlias has to exist.
  Now you can restart php-fpm and httpd services for testing.

• And the most interesting – virtual hosts domainA and domainB
  Apache

  <VirtualHost *:80> ServerName domainA.com ServerAlias www.domainA.com DocumentRoot /home/domainA/public_html ErrorLog /home/domainA/logs/error_log CustomLog /home/domainA/logs/access_log combined ScriptAlias /cgi-bin/ /home/domainA/cgi-bin/ DirectoryIndex index.html index.htm index.php <IfModule mod_fastcgi.c> AddHandler php-domainA .php Action php-domainA /php-domainA ScriptAlias /php-domainA /var/www/cgi-bin/php-domainA FastCGIExternalServer /var/www/cgi-bin/php-domainA -host 127.0.0.1:9001 -pass-header Authorization </IfModule> </VirtualHost> <VirtualHost *:80> ServerName domainB.com ServerAlias www.domainB.com DocumentRoot /home/domainB/public_html ErrorLog /home/domainB/logs/error_log CustomLog /home/domainB/logs/access_log combined ScriptAlias /cgi-bin/ /home/domainB/cgi-bin/ DirectoryIndex index.html index.htm index.php <IfModule mod_fastcgi.c> AddHandler php-domainB .php Action php-domainB /php-domainB ScriptAlias /php-domainB /var/www/cgi-bin/php-domainB FastCGIExternalServer /var/www/cgi-bin/php-domainB -host 127.0.0.1:9001 -pass-header Authorization </IfModule> </VirtualHost>

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

  <VirtualHost *:80> ServerName domainA.com ServerAlias www.domainA.com DocumentRoot /home/domainA/public_html ErrorLog /home/domainA/logs/error_log CustomLog /home/domainA/logs/access_log combined ScriptAlias /cgi-bin/ /home/domainA/cgi-bin/ DirectoryIndex index.html index.htm index.php   <IfModule mod_fastcgi.c>   AddHandler php-domainA .php   Action php-domainA /php-domainA   ScriptAlias /php-domainA /var/www/cgi-bin/php-domainA   FastCGIExternalServer /var/www/cgi-bin/php-domainA -host 127.0.0.1:9001 -pass-header Authorization   </IfModule> </VirtualHost>   <VirtualHost *:80> ServerName domainB.com ServerAlias www.domainB.com DocumentRoot /home/domainB/public_html ErrorLog /home/domainB/logs/error_log CustomLog /home/domainB/logs/access_log combined ScriptAlias /cgi-bin/ /home/domainB/cgi-bin/ DirectoryIndex index.html index.htm index.php   <IfModule mod_fastcgi.c>   AddHandler php-domainB .php   Action php-domainB /php-domainB   ScriptAlias /php-domainB /var/www/cgi-bin/php-domainB   FastCGIExternalServer /var/www/cgi-bin/php-domainB -host 127.0.0.1:9001 -pass-header Authorization   </IfModule> </VirtualHost>

  The important point is that you have to have distinctive handler for .php for each virtual host – that is how you can associate virtual host to specific pool on PHP-FPM. Once I’ve figured that out the rest was easy.