AppSignal for PHP config load order

You can configure AppSignal for PHP through the config/appsignal.php config file, or with environment variables. The configuration is loaded in a three-step process, starting with the package defaults and ending with reading the config file. The configuration options can be mixed without losing configuration from a different option.

Package defaults

The package starts with loading its default configuration, setting paths and enabling certain features. The package defaults can be found in the configuration options documentation.

Environment variables

AppSignal looks for configuration in environment variables. When found, these override the package defaults. You can pass environment variables to one-off PHP scripts:

Shell

export APPSIGNAL_APP_NAME="my custom app name"

or for your PHP application this is typically done via a .env file:

.env

APPSIGNAL_ACTIVE=true
APPSIGNAL_APP_NAME="my custom app name"
APPSIGNAL_PUSH_API_KEY=local

Supported environment variables are documented in the env_key definition for each configuration option.

Config file

AppSignal looks for configuration in the config/appsignal.php file. Options in this file override all configuration options set in previous steps.

config/appsignal.php

return [
	'app_name' => 'my custom app name',
	// ... other options
];

Supported keys are documented in the config_key definition for each configuration option.

SDKs & telemetry

Language SDKs

Telemetry tools

Load order

Package defaults

Environment variables

Config file

​Load order

​ Package defaults

​ Environment variables

​ Config file

Load order

Package defaults

Environment variables

Config file