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

Er zijn twee vereisten om aan de slag te gaan met het PHP-pakket:

1. Een actief ondersteunde [PHP-versie](https://www.php.net/supported-versions). Zie ons [onderhoudsbeleid](/support/maintenance-policy).
2. De OpenTelemetry PHP-extensie.

Wij leiden u door de installatie van de OpenTelemetry-extensie.

## De OpenTelemetry PHP-extensie installeren

De OpenTelemetry PHP-extensie biedt hooks in PHP-functies die dit pakket gebruikt om uw applicatie te instrumenteren. Dit is een PHP-extensie die u moet installeren en inschakelen in uw PHP-omgeving.

Zorg er eerst voor dat de vereiste build-afhankelijkheden beschikbaar zijn op uw systeem.

<CodeGroup>
  ```bash title="Ubuntu / Debian" theme={null}
  sudo apt-get install gcc make autoconf
  ```

  ```shell title="macOS" theme={null}
  brew install gcc make autoconf
  ```
</CodeGroup>

Installeer vervolgens de OpenTelemetry PHP-extensie met [PECL](https://pecl.php.net/), [pie](https://github.com/php/pie), [pickle](https://github.com/FriendsOfPHP/pickle) of [docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer):

<CodeGroup>
  ```shell title="PECL" theme={null}
  pecl install opentelemetry
  ```

  ```shell title="pie" theme={null}
  # Install pie (skip this step if pie is already installed)
  curl -L https://github.com/php/pie/releases/latest/download/pie.phar -o /usr/local/bin/pie && chmod +x /usr/local/bin/pie

  # Install the extension
  pie install open-telemetry/ext-opentelemetry
  ```

  ```shell title="pickle" theme={null}
  # Install pickle (skip this step if pickle is already installed)
  curl -L https://github.com/FriendsOfPHP/pickle/releases/latest/download/pickle.phar -o /usr/local/bin/pickle && chmod +x /usr/local/bin/pickle

  # Install the extension
  pickle install opentelemetry
  ```

  ```dockerfile title="docker-php-extension-installer" theme={null}
  # Use the docker-php-extension-installer script in your Dockerfile when using official PHP Docker images
  ADD --chmod=0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
  RUN install-php-extensions opentelemetry
  ```
</CodeGroup>

Schakel ten slotte de extensie in via het configuratiebestand van uw PHP-installatie. Dit bestand heet doorgaans `php.ini`, en de locatie kunt u vinden door `php --ini` uit te voeren. Voeg de volgende regels toe:

```ini INI theme={null}
[opentelemetry]
extension=opentelemetry.so
```

<Note>
  Wanneer u het script [docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer) gebruikt om de `opentelemetry`-extensie te installeren, wordt de extensie automatisch ingeschakeld en hoeft u het `php.ini`-bestand niet handmatig aan te passen.
</Note>

## Een nieuwe AppSignal-applicatie aanmaken

Volg eerst de [installatiegids](/guides/new-application) wanneer u een nieuwe applicatie aan AppSignal toevoegt.

Aan het einde van die handleiding ontvangt u een Push API-sleutel en een URL voor het collector-endpoint. U hebt beide nodig om AppSignal voor PHP te configureren.