> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ordem de carregamento da configuração do AppSignal for PHP

Você pode configurar o AppSignal for PHP através do arquivo de configuração `config/appsignal.php` ou com variáveis de ambiente.

A configuração é carregada em um processo de três etapas, começando pelos padrões do pacote e terminando com a leitura do arquivo de configuração. As opções de configuração podem ser combinadas sem perder a configuração de uma opção diferente.

## Ordem de carregamento

* 1. [Padrões do pacote - `default`](#1-package-defaults)
* 2. [Variáveis de ambiente - `env`](#2-environment-variables)
* 3. [Arquivo de configuração - `file`](#3-config-file)

## 1. Padrões do pacote

O pacote começa carregando sua configuração padrão, definindo caminhos e habilitando determinados recursos. Os padrões do pacote podem ser encontrados na [documentação de opções de configuração](/php/configuration/options).

## 2. Variáveis de ambiente

O AppSignal procura por configuração em variáveis de ambiente. Quando encontradas, elas sobrescrevem os padrões do pacote.

Você pode passar variáveis de ambiente para scripts PHP avulsos:

```bash Shell theme={null}
export APPSIGNAL_APP_NAME="my custom app name"
```

ou, para sua aplicação PHP, isso normalmente é feito através de um arquivo `.env`:

```bash title=".env" theme={null}
APPSIGNAL_ACTIVE=true
APPSIGNAL_APP_NAME="my custom app name"
APPSIGNAL_PUSH_API_KEY=local
```

As variáveis de ambiente suportadas estão documentadas na definição `env_key` de cada [opção de configuração](/php/configuration/options).

## 3. Arquivo de configuração

O AppSignal procura por configuração no arquivo `config/appsignal.php`. As opções nesse arquivo sobrescrevem todas as opções de configuração definidas nas etapas anteriores.

```php title="config/appsignal.php" theme={null}
return [
	'app_name' => 'my custom app name',
	// ... other options
];
```

As chaves suportadas estão documentadas na definição `config_key` de cada [opção de configuração](/php/configuration/options).