nativeInstallerosclass

Configure PHP-FPM processes

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: We are in the process of modifying the file structure and configuration for many Bitnami stacks. On account of these changes, the file paths stated in this guide may change depending on whether your Bitnami stack uses native Linux system packages (Approach A), or if it is a self-contained installation (Approach B). To identify your Bitnami installation type and what approach to follow, run the command below:

 $ test ! -f "installdir/common/bin/openssl" && echo "Approach A: Using system packages." || echo "Approach B: Self-contained installation."

The output of the command indicates which approach (A or B) is used by the installation, and will allow you to identify the paths, configuration and commands to use in this guide. Refer to the FAQ for more information on these changes.

It is possible to configure PHP-FPM processes per application. If you have a lot of applications, this may result in excessive CPU usage.

  • You can configure your application’s PHP-FPM processes to start automatically when needed. Add this option to the PHP-FPM pool configuration file:

    NOTE: Depending on your installation type, you can find the PHP-FPM pool configuration file for your application in the following locations:

    • Approach A (Bitnami installations using system packages): installdir/php/etc/php-fpm.d/www.conf
    • Approach B (Self-contained Bitnami installations): installdir/apps/apps/APPNAME/conf/pfp-fpm/pool.conf
    pm=ondemand
    
  • You can also reduce the number of PHP-FPM processes per application by modifying the files below.

    • If you configured the processes to start dynamically, modify the installdir/php/etc/common-dynamic.conf as below:

      pm=dynamic
      pm.max_children=5
      pm.start_servers=2
      pm.min_spare_servers=1
      pm.max_spare_servers=3
      
    • If you configured the processes to start on demand, modify the installdir/php/etc/common-ondemand.conf as below:

      pm=ondemand
      pm.max_children=5
      pm.start_servers=2
      pm.min_spare_servers=1
      pm.max_spare_servers=3
      
Last modification June 10, 2020