Advanced PHP Configuration

PHP CLI Support

The Stackify PHP Profiler can be used to track PHP CLI applications. Update your php.ini to include the following:

stackify.monitor_cli=true

Each execution of a PHP script will create a new transaction in Retrace. The transaction name defaults to the PHP script filename; this can be adjusted by including the following in your PHP script file:

if (class_exists('Stackify\Profiler')) {
    \Stackify\Profiler::setTransactionName('Custom Transaction Name');
}

Custom Transaction Name

The Stackify PHP Profiler identifies and names transactions based on the application framework. In some cases this may not be the value you want associated with your transaction. Use the following code inside your application to customize the transaction name:

if (class_exists('Stackify\Profiler')) {
    \Stackify\Profiler::setTransactionName('Custom Transaction Name');
}

PHP auto_prepend Support

If you are using the PHP auto_prepend_file feature, update your php.ini to include the following:

stackify.auto_prepend_library=1

PHP Application per Folder Support

If you are running multiple applications (each in a separate folder), additional configuration is required to correctly set the Application Name and Environment Name.

Apache

Add or update a .htaccess file in your application directory with the following contents:

php_value stackify.application_name "PHP Application"
php_value stackify.environment_name "Production"

Nginx

Update your Nginx server configuration to include the following:

location /application {
   fastcgi_param PHP_VALUE 'stackify.application_name="PHP Application";\nstackify.environment_name="Production";';
}

Verbose Trace Details

The Stackify PHP Profiler can be setup to track all method calls to help debug or setup custom instrumentation.
Update your php.ini to include the following:

stackify.track_all_enabled=1