Multiple PHP Apps in a Single Server

The default Atatus PHP installation treats entire PHP deployment as a single PHP application with a single node. In case if you have multiple PHP applications running in the same Nginx or Apache server, you might want to monitor them as different PHP projects in Atatus. You can set separate app name for each and every PHP application running on the same server through a function call or an Apache/Nginx configuration.

1. Apache

There are two ways you can set application name in Apache. You can do them through:

httpd.conf file
.htaccess file
.user.ini file

httpd.conf file: You can set Atatus configuration either in httpd.conf file or one of its included files as follows:

<VirtualHost *:80>
  ServerName www.myserver.com
  DocumentRoot "/path/to/app/"
  ...
  <IfModule php_module>
    php_value atatus.app_name "YOUR_APP_NAME"
  </IfModule>
</VirtualHost>

Similar to app name setting, you can set all other Atatus agent configurations specific to the application. For example, if you want to disable Atatus agent for a specific application, then you can do the following:

<VirtualHost *:80>
  ...
  <IfModule php_module>
    php_value atatus.enabled off
  </IfModule>
</VirtualHost>

The provided configuration will function solely with PHP 8. For PHP 7, you must utilize php7_module in place of php_module. In the case of PHP 5, substitute php5_module for php_module. To determine your module name among the loaded modules, you can use either httpd -M or apachectl -t -D DUMP_MODULES.

All string values should have double quotes. Any boolean value is either on or off.

.htaccess file: The .htaccess file must be in the top-level directory for that application. You can set the app name inside a .htaccess file. An example would be:

php_value atatus.app_name "YOUR_APP_NAME"

.user.ini file: In RedHat 9, CentOS 9 and above, php_value is deprecated, so please use the .user.ini in your app root directory.

# Create file '.user.ini' under application root directory.
# Here our root directory is /var/www/html/
vi /var/www/html/.user.ini

Add below configuration in your .user.ini file

[atatus]
atatus.app_name = "your app name"

2. Nginx

There are two ways you can set the app name in Nginx. You can do them through:

Nginx config file
.user.ini file

Nginx config file: Below is a sample section from the Nginx config file, where you can pass app name value to FastCGI with respect to the location in Nginx.

location /app {
  ...
  fastcgi_param PHP_VALUE "atatus.app_name=YOUR_APP_NAME";
  ...
}

location /api {
  ...
  # If there are spaces in app name, wrap it with escaped double quotes as below
  fastcgi_param PHP_VALUE "atatus.app_name=\"YOUR APP NAME\"";
  ...
}

If you are setting multiple PHP values, then you can do it as follows

location /api {

  set $php_value "atatus.app_name=YOUR_APP_NAME";
  set $php_value "$php_value \n atatus.tags=aws-1";

  fastcgi_param  PHP_VALUE $php_value;
}

.user.ini file: You should create a .user.ini file within your project home folder. A sample file content will be:

atatus.app_name = "YOUR_APP_NAME"

​1. Apache

​2. Nginx

1. Apache

2. Nginx