> ## 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.

# AppSignal voor PHP-configuratie-opties

AppSignal voor PHP kan worden geconfigureerd via het bestand `config/appsignal.php` of met omgevingsvariabelen. Op deze pagina worden alle beschikbare configuratie-opties vermeld.

Lees meer over de [laadvolgorde van de configuratie](/php/configuration/load-order).

Zodra u AppSignal hebt geconfigureerd, kunt u de huidige configuratie valideren:

```sh Shell theme={null}
vendor/bin/appsignal validate
```

## Beschikbare opties

* Vereiste opties
  * [`collector_endpoint`](#option-collector_endpoint)
  * [`environment`](#option-environment)
  * [`name`](#option-name)
  * [`push_api_key`](#option-push_api_key)
* Opties
  * [`active`](#option-active)
  * [`app_path`](#option-app_path)
  * [`filter_attributes`](#option-filter_attributes)
  * [`filter_function_parameters`](#option-filter_function_parameters)
  * [`filter_request_payload`](#option-filter_request_payload)
  * [`filter_request_query_parameters`](#option-filter_request_query_parameters)
  * [`filter_request_session_data`](#option-filter_request_session_data)
  * [`hostname`](#option-hostname)
  * [`ignore_actions`](#option-ignore_actions)
  * [`ignore_errors`](#option-ignore_errors)
  * [`ignore_logs`](#option-ignore_logs)
  * [`ignore_namespaces`](#option-ignore_namespaces)
  * [`request_headers`](#option-request_headers)
  * [`response_headers`](#option-response_headers)
  * [`revision`](#option-revision)
  * [`send_function_parameters`](#option-send_function_parameters)
  * [`send_request_payload`](#option-send_request_payload)
  * [`send_request_query_parameters`](#option-send_request_query_parameters)
  * [`send_request_session_data`](#option-send_request_session_data)
  * [`service_name`](#option-service_name)

## collector\_endpoint

<a id="option-collector_endpoint" />

| Veld                           | Waarde                            |
| ------------------------------ | --------------------------------- |
| Sleutel in configuratiebestand | `collector_endpoint`              |
| Systeemomgevingssleutel        | `APPSIGNAL_COLLECTOR_ENDPOINT`    |
| Verplicht                      | ja                                |
| Type                           | `String`                          |
| Standaardwaarde                | `null` (standaard niet ingesteld) |

### Beschrijving

De URL van de AppSignal-collector waarnaar trace-, metric- en loggegevens worden verzonden.

AppSignal toont deze URL wanneer u een nieuwe applicatie aanmaakt, en is ook beschikbaar voor bestaande applicaties.

```php title="config/appsignal.php" theme={null}
return [
    'collector_endpoint' => $_ENV['APPSIGNAL_COLLECTOR_ENDPOINT'] ?? null,
    // ... other options
];
```

## environment

<a id="option-environment" />

| Veld                           | Waarde                            |
| ------------------------------ | --------------------------------- |
| Sleutel in configuratiebestand | `environment`                     |
| Systeemomgevingssleutel        | `APPSIGNAL_APP_ENV`               |
| Verplicht                      | ja                                |
| Type                           | `String`                          |
| Standaardwaarde                | `null` (standaard niet ingesteld) |

### Beschrijving

De omgeving van de app die aan AppSignal wordt gerapporteerd.

```php title="config/appsignal.php" theme={null}
return [
    'environment' => $_ENV['APPSIGNAL_APP_ENV'] ?? 'production',
    // ... other options
];
```

<Note>
  **Opmerking**: Het wijzigen van de [naam](#option-name) of omgeving van een bestaande app
  zal een nieuwe app aanmaken op AppSignal.com.
</Note>

## name

<a id="option-name" />

| Veld                           | Waarde                            |
| ------------------------------ | --------------------------------- |
| Sleutel in configuratiebestand | `name`                            |
| Systeemomgevingssleutel        | `APPSIGNAL_APP_NAME`              |
| Verplicht                      | ja                                |
| Type                           | `String`                          |
| Standaardwaarde                | `null` (standaard niet ingesteld) |

### Beschrijving

De weergavenaam van uw applicatie op AppSignal.com.

```php title="config/appsignal.php" theme={null}
return [
    'name' => 'My App',
    // ... other options
];
```

<Note>
  **Opmerking**: Het wijzigen van de naam of [omgeving](#option-env) van een bestaande app
  zal een nieuwe app aanmaken op AppSignal.com.
</Note>

## push\_api\_key

<a id="option-push_api_key" />

| Veld                           | Waarde                            |
| ------------------------------ | --------------------------------- |
| Sleutel in configuratiebestand | `push_api_key`                    |
| Systeemomgevingssleutel        | `APPSIGNAL_PUSH_API_KEY`          |
| Verplicht                      | ja                                |
| Type                           | `String`                          |
| Standaardwaarde                | `null` (standaard niet ingesteld) |

### Beschrijving

De sleutel op organisatieniveau die wordt gebruikt om te authenticeren bij de Push API.

Lees meer over de [AppSignal Push API-sleutel](/appsignal/terminology#push-api-key).

```php title="config/appsignal.php" theme={null}
return [
    'push_api_key' => $_ENV['APPSIGNAL_PUSH_API_KEY'] ?? '00000000-0000-0000-0000-000000000000',
    // ... other options
];
```

## active

<a id="option-active" />

| Veld                           | Waarde                     |
| ------------------------------ | -------------------------- |
| Sleutel in configuratiebestand | `active`                   |
| Systeemomgevingssleutel        | `APPSIGNAL_ACTIVE`         |
| Verplicht                      | nee                        |
| Type                           | Boolean (`true` / `false`) |
| Standaardwaarde                | `false`                    |

### Beschrijving

Configureer of AppSignal actief is voor een bepaalde omgeving. Wordt meestal gebruikt in de [bestandsconfiguratie](/php/configuration) per omgeving.

## app\_path

<a id="option-app_path" />

| Veld                           | Waarde                                |
| ------------------------------ | ------------------------------------- |
| Sleutel in configuratiebestand | `app_path`                            |
| Verplicht                      | nee                                   |
| Type                           | `String`                              |
| Standaardwaarde                | gedetecteerd op basis van projectroot |

### Beschrijving

De locatie van de app op het bestandssysteem van de host.

Helpt AppSignal backtraces op te schonen door het absolute app-pad uit backtrace-regels te verwijderen, zodat alleen paden binnen de projectdirectory worden weergegeven. Dit maakt onze functie [Backtrace-links](/application/backtrace-links) mogelijk.

Het AppSignal-pakket stelt deze waarde automatisch in op basis van de gedetecteerde projectroot. Als de automatische detectie van het app-pad niet werkt, kunt u deze overschrijven:

```php title="config/appsignal.php" theme={null}
return [
	'app_path' => '/var/www/html/your-app'
    // ... other options
];
```

## filter\_attributes

<a id="option-filter_attributes" />

| Veld                           | Waarde                        |
| ------------------------------ | ----------------------------- |
| Sleutel in configuratiebestand | `filter_attributes`           |
| Systeemomgevingssleutel        | `APPSIGNAL_FILTER_ATTRIBUTES` |
| Verplicht                      | nee                           |
| Type                           | `Array<String>`               |
| Standaardwaarde                | `[]`                          |

### Beschrijving

Met de configuratieoptie `filter_attributes` kunt u specifieke attributen uitfilteren zodat ze niet aan AppSignal worden gerapporteerd. Dit kan handig zijn om gevoelige of niet-relevante informatie uit te filteren.

Als een attribuut op deze manier wordt uitgefilterd, verschijnt het helemaal niet in de interface.

```php title="config/appsignal.php" theme={null}
return [
    'filter_attributes' => ['my.secret.attribute', 'some.opentelemetry.attribute'],
    // ... other options
];
```

## filter\_function\_parameters

<a id="option-filter_function_parameters" />

| Veld                           | Waarde                                 |
| ------------------------------ | -------------------------------------- |
| Sleutel in configuratiebestand | `filter_function_parameters`           |
| Systeemomgevingssleutel        | `APPSIGNAL_FILTER_FUNCTION_PARAMETERS` |
| Verplicht                      | nee                                    |
| Type                           | `Array<String>`                        |
| Standaardwaarde                | `[]`                                   |

### Beschrijving

Met deze configuratieoptie kunt u functieparameters die zijn ingesteld in het [span-attribuut `appsignal.function.parameters`](/guides/custom-data/function-parameters) uitfilteren.

AppSignal vervangt de waarden van de sleutels die in de configuratieoptie `filter_function_parameters` staan door `[FILTERED]`.

```php title="config/appsignal.php" theme={null}
return [
    'filter_function_parameters' => ['api_token', 'secret'],
    // ... other options
];
```

## filter\_request\_payload

<a id="option-filter_request_payload" />

| Veld                           | Waarde                             |
| ------------------------------ | ---------------------------------- |
| Sleutel in configuratiebestand | `filter_request_payload`           |
| Systeemomgevingssleutel        | `APPSIGNAL_FILTER_REQUEST_PAYLOAD` |
| Verplicht                      | nee                                |
| Type                           | `Array<String>`                    |
| Standaardwaarde                | `[]`                               |

### Beschrijving

Met deze configuratieoptie kunt u request-payloadgegevens die zijn ingesteld in het [span-attribuut `appsignal.request.payload`](/guides/custom-data/request-parameters) uitfilteren.

AppSignal vervangt de waarden van de sleutels die in de configuratieoptie `filter_request_payload` staan door `[FILTERED]`.

Lees meer over [het filteren van request-queryparameters](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'filter_request_payload' => ['password', 'cvv'],
    // ... other options
];
```

## filter\_request\_query\_parameters

<a id="option-filter_request_query_parameters" />

| Veld                           | Waarde                                      |
| ------------------------------ | ------------------------------------------- |
| Sleutel in configuratiebestand | `filter_request_query_parameters`           |
| Systeemomgevingssleutel        | `APPSIGNAL_FILTER_REQUEST_QUERY_PARAMETERS` |
| Verplicht                      | nee                                         |
| Type                           | `Array<String>`                             |
| Standaardwaarde                | `[]`                                        |

### Beschrijving

Met deze configuratieoptie kunt u request-queryparameters die zijn ingesteld in het [span-attribuut `appsignal.request.query_parameters`](/guides/custom-data/request-parameters) uitfilteren.

AppSignal vervangt de waarden van de sleutels die in de configuratieoptie `filter_request_query_parameters` staan door `[FILTERED]`.

Lees meer over [het filteren van request-queryparameters](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'filter_request_query_parameters' => ['password', 'cvv'],
    // ... other options
];
```

## filter\_request\_session\_data

<a id="option-filter_request_session_data" />

| Veld                           | Waarde                                  |
| ------------------------------ | --------------------------------------- |
| Sleutel in configuratiebestand | `filter_request_session_data`           |
| Systeemomgevingssleutel        | `APPSIGNAL_FILTER_REQUEST_SESSION_DATA` |
| Verplicht                      | nee                                     |
| Type                           | `Array<String>`                         |
| Standaardwaarde                | `[]`                                    |

### Beschrijving

Met de configuratieoptie `filter_request_session_data` kunt u request-sessiegegevens die zijn ingesteld in het [span-attribuut `appsignal.request.session_data`](/guides/custom-data/request-session-data) uitfilteren.

AppSignal vervangt de waarden van de sleutels die in de configuratieoptie `filter_request_session_data` staan door `[FILTERED]`.

Lees meer over [het filteren van request-sessiegegevens](/application/session-data-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'filter_request_session_data' => ['password', 'cvv'],
    // ... other options
];
```

## hostname

<a id="option-hostname" />

| Veld                           | Waarde                      |
| ------------------------------ | --------------------------- |
| Sleutel in configuratiebestand | `hostname`                  |
| Systeemomgevingssleutel        | `APPSIGNAL_HOSTNAME`        |
| Verplicht                      | nee                         |
| Type                           | `String`                    |
| Standaardwaarde                | gedetecteerd vanuit systeem |

### Beschrijving

Helpt AppSignal verschillende hosts voor traces te herkennen en deze automatisch te taggen met de hostnaam.

Het AppSignal-pakket stelt deze waarde automatisch in met `gethostname()`.

## ignore\_actions

<a id="option-ignore_actions" />

| Veld                           | Waarde                     |
| ------------------------------ | -------------------------- |
| Sleutel in configuratiebestand | `ignore_actions`           |
| Systeemomgevingssleutel        | `APPSIGNAL_IGNORE_ACTIONS` |
| Verplicht                      | nee                        |
| Type                           | `Array<String>`            |
| Standaardwaarde                | `[]`                       |

### Beschrijving

Met deze configuratieoptie kunt u een lijst van acties opgeven die door AppSignal genegeerd worden. Alles wat gebeurt, inclusief exceptions, wordt niet naar AppSignal verzonden. Dit kan handig zijn om health-check-endpoints of andere acties die u niet wilt monitoren te negeren.

Lees meer over [acties negeren](/guides/filter-data/ignore-actions).

```php title="config/appsignal.php" theme={null}
return [
    'ignore_actions' => ['GET /health_check', 'POST /ping'],
    // ... other options
];
```

## ignore\_errors

<a id="option-ignore_errors" />

| Veld                           | Waarde                    |
| ------------------------------ | ------------------------- |
| Sleutel in configuratiebestand | `ignore_errors`           |
| Systeemomgevingssleutel        | `APPSIGNAL_IGNORE_ERRORS` |
| Verplicht                      | nee                       |
| Type                           | `Array<String>`           |
| Standaardwaarde                | `[]`                      |

### Beschrijving

Met deze configuratieoptie kunt u specifieke fouten niet aan AppSignal laten rapporteren. Dit kan handig zijn om verwachte fouten of fouten die niet kunnen worden opgelost te negeren.

Lees meer over [fouten negeren](/guides/filter-data/ignore-errors).

```php title="config/appsignal.php" theme={null}
return [
    'ignore_errors' => ['MyCustomError', 'ExpectedError'],
    // ... other options
];
```

## ignore\_logs

<a id="option-ignore_logs" />

| Veld                           | Waarde                  |
| ------------------------------ | ----------------------- |
| Sleutel in configuratiebestand | `ignore_logs`           |
| Systeemomgevingssleutel        | `APPSIGNAL_IGNORE_LOGS` |
| Verplicht                      | nee                     |
| Type                           | `Array<String>`         |
| Standaardwaarde                | `[]`                    |

### Beschrijving

Lijst van logberichten die genegeerd worden. Elk logbericht dat een van de elementen uit de lijst bevat, wordt niet naar AppSignal verzonden. Een kleine subset van regex-syntaxis wordt ondersteund; lees er meer over in onze handleiding [Logs negeren](/guides/filter-data/ignore-logs).

Het verwachte formaat is een door komma's gescheiden lijst van waarden.

```php title="config/appsignal.php" theme={null}
return [
	'ignore_logs' => ["^success", "OK"],
	// ... other options
];
```

## ignore\_namespaces

<a id="option-ignore_namespaces" />

| Veld                           | Waarde                        |
| ------------------------------ | ----------------------------- |
| Sleutel in configuratiebestand | `ignore_namespaces`           |
| Systeemomgevingssleutel        | `APPSIGNAL_IGNORE_NAMESPACES` |
| Verplicht                      | nee                           |
| Type                           | `Array<String>`               |
| Standaardwaarde                | `[]`                          |

### Beschrijving

Met deze configuratieoptie kunt u specifieke namespaces niet aan AppSignal laten rapporteren. Dit kan handig zijn om specifieke delen van uw applicatie niet te monitoren.

Lees meer over [namespaces](/application/namespaces).

```php title="config/appsignal.php" theme={null}
return [
    'ignore_namespaces' => ['admin', 'secret'],
    // ... other options
];
```

## request\_headers

<a id="option-request_headers" />

| Veld                           | Waarde                                                                                                                                 |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| Sleutel in configuratiebestand | `request_headers`                                                                                                                      |
| Systeemomgevingssleutel        | `APPSIGNAL_REQUEST_HEADERS`                                                                                                            |
| Verplicht                      | nee                                                                                                                                    |
| Type                           | `Array<String>`                                                                                                                        |
| Standaardwaarde                | `["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "host", "range"]` |

### Beschrijving

Configureer welke request-headers worden opgenomen wanneer een aanvraag wordt gedaan aan een HTTP-server. Deze optie is een allowlist. Alleen de geconfigureerde headers worden opgenomen. Als de lijst leeg is, worden er geen headers opgenomen.

AppSignal leest request-headers uit de HTTP-aanvraag. Elke sleutel is een genormaliseerde (kleine letters) headernaam.

```php title="config/appsignal.php" theme={null}
return [
	'request_headers' => ['accept-encoding', 'content-length', 'user-agent'],
	// ... other options
];
```

Om AppSignal zo te configureren dat er geen HTTP-request-headers worden opgeslagen, stelt u de configuratiewaarde expliciet in op een lege array.

```php title="config/appsignal.php" theme={null}
return [
    'request_headers' => [],
	// ... other options
];
```

## response\_headers

<a id="option-response_headers" />

| Veld                           | Waarde                                                                                                                                 |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| Sleutel in configuratiebestand | `response_headers`                                                                                                                     |
| Systeemomgevingssleutel        | `APPSIGNAL_RESPONSE_HEADERS`                                                                                                           |
| Verplicht                      | nee                                                                                                                                    |
| Type                           | `Array<String>`                                                                                                                        |
| Standaardwaarde                | `["accept", "accept-charset", "accept-encoding", "accept-language", "cache-control", "connection", "content-length", "date", "range"]` |

### Beschrijving

Configureer welke response-headers worden opgenomen wanneer een aanvraag wordt gedaan door een HTTP-client. Deze optie is een allowlist. Alleen de geconfigureerde headers worden opgenomen. Als de array leeg is, worden er geen headers opgenomen.

Elk item in deze array moet een genormaliseerde HTTP-response-headernaam zijn (kleine letters).

```php title="config/appsignal.php" theme={null}
return [
    'response_headers' => ['accept', 'accept-charset', 'accept-encoding'],
	// ... other options
];
```

Om AppSignal zo te configureren dat er geen HTTP-response-headers worden opgeslagen, stelt u de configuratiewaarde expliciet in op een lege array.

```php title="config/appsignal.php" theme={null}
return [
    'response_headers' => [],
	// ... other options
];
```

## revision

<a id="option-revision" />

| Veld                           | Waarde                  |
| ------------------------------ | ----------------------- |
| Sleutel in configuratiebestand | `revision`              |
| Systeemomgevingssleutel        | `APPSIGNAL_REVISION`    |
| Verplicht                      | nee                     |
| Type                           | `String`                |
| Standaardwaarde                | gedetecteerd vanuit git |

### Beschrijving

De huidige actieve versie van uw app. AppSignal maakt een deploy marker aan wanneer deze waarde verandert en tagt alle binnenkomende gegevens met de huidige revisie.

Het AppSignal-pakket stelt deze waarde automatisch in met `git rev-parse HEAD`.

Lees meer over deploy markers in het [onderwerp deploy markers](/application/markers/deploy-markers).

## send\_function\_parameters

<a id="option-send_function_parameters" />

| Veld                           | Waarde                               |
| ------------------------------ | ------------------------------------ |
| Sleutel in configuratiebestand | `send_function_parameters`           |
| Systeemomgevingssleutel        | `APPSIGNAL_SEND_FUNCTION_PARAMETERS` |
| Verplicht                      | nee                                  |
| Type                           | Boolean (`true` / `false`)           |
| Standaardwaarde                | `true`                               |

### Beschrijving

Configureer of functieparameters worden opgenomen in traces. Als dit is ingesteld op `false`, worden dergelijke gegevens niet naar onze servers verzonden.

Deze waarden worden ingesteld met het [span-attribuut `appsignal.function.parameters`](/guides/custom-data/function-parameters).

```php title="config/appsignal.php" theme={null}
return [
    'send_function_parameters' => false,
    // ... other options
];
```

## send\_request\_payload

<a id="option-send_request_payload" />

| Veld                           | Waarde                           |
| ------------------------------ | -------------------------------- |
| Sleutel in configuratiebestand | `send_request_payload`           |
| Systeemomgevingssleutel        | `APPSIGNAL_SEND_REQUEST_PAYLOAD` |
| Verplicht                      | nee                              |
| Type                           | Boolean (`true` / `false`)       |
| Standaardwaarde                | `true`                           |

### Beschrijving

Configureer of request-payloadgegevens worden verzonden in traces. Als dit is ingesteld op `false`, worden dergelijke gegevens niet naar onze servers verzonden.

Deze waarden worden ingesteld met het [span-attribuut `appsignal.request.payload`](/guides/custom-data/request-parameters).

Lees voor meer informatie over [het filteren van request-payloads](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'send_request_payload' => false,
    // ... other options
];
```

## send\_request\_query\_parameters

<a id="option-send_request_query_parameters" />

| Veld                           | Waarde                                    |
| ------------------------------ | ----------------------------------------- |
| Sleutel in configuratiebestand | `send_request_query_parameters`           |
| Systeemomgevingssleutel        | `APPSIGNAL_SEND_REQUEST_QUERY_PARAMETERS` |
| Verplicht                      | nee                                       |
| Type                           | Boolean (`true` / `false`)                |
| Standaardwaarde                | `true`                                    |

### Beschrijving

Configureer of request-queryparameters worden opgenomen in traces. Als dit is ingesteld op `false`, worden dergelijke gegevens niet naar onze servers verzonden.

Deze waarden worden ingesteld met het [span-attribuut `appsignal.request.query_parameters`](/guides/custom-data/request-parameters).

Lees voor meer informatie over [het filteren van request-parameters](/application/parameter-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'send_request_query_parameters' => false,
    // ... other options
];
```

## send\_request\_session\_data

<a id="option-send_request_session_data" />

| Veld                           | Waarde                                |
| ------------------------------ | ------------------------------------- |
| Sleutel in configuratiebestand | `send_request_session_data`           |
| Systeemomgevingssleutel        | `APPSIGNAL_SEND_REQUEST_SESSION_DATA` |
| Verplicht                      | nee                                   |
| Type                           | Boolean (`true` / `false`)            |
| Standaardwaarde                | `true`                                |

### Beschrijving

Configureer of request-sessiegegevens worden verzonden in traces. Als dit is ingesteld op `false`, worden dergelijke gegevens niet naar onze servers verzonden.

Deze waarden worden ingesteld met het [span-attribuut `appsignal.request.session_data`](/guides/custom-data/request-session-data).

Lees voor meer informatie over [het filteren van request-sessiegegevens](/application/session-data-filtering).

```php title="config/appsignal.php" theme={null}
return [
    'send_request_session_data' => false,
    // ... other options
];
```

## service\_name

<a id="option-service_name" />

| Veld                           | Waarde                            |
| ------------------------------ | --------------------------------- |
| Sleutel in configuratiebestand | `service_name`                    |
| Systeemomgevingssleutel        | `APPSIGNAL_SERVICE_NAME`          |
| Verplicht                      | nee                               |
| Type                           | `String`                          |
| Standaardwaarde                | `null` (standaard niet ingesteld) |

### Beschrijving

De servicenaam helpt AppSignal verschillende services te herkennen en groepeert hun traces automatisch in een bijbehorende namespace.

Kies een naam die bij uw applicatie past, zoals "Web server", "Background worker", "Email service", "Authentication service", enzovoort.

```php title="config/appsignal.php" theme={null}
return [
    'service_name' => 'My service name',
    // ... other options
];
```