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

# Prérequis d'AppSignal pour PHP

Il y a deux prérequis pour commencer avec le paquet PHP :

1. Une [version PHP](https://www.php.net/supported-versions) activement prise en charge. Consultez notre [politique de maintenance](/support/maintenance-policy).
2. L'extension PHP OpenTelemetry.

Nous vous guiderons à travers l'installation de l'extension OpenTelemetry.

## Installer l'extension PHP OpenTelemetry

L'extension PHP OpenTelemetry fournit des hooks dans les fonctions PHP que ce paquet utilise pour instrumenter votre application. Il s'agit d'une extension PHP que vous devez installer et activer dans votre environnement PHP.

Tout d'abord, assurez-vous que les dépendances de compilation requises sont disponibles sur votre système.

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

Ensuite, installez l'extension PHP OpenTelemetry à l'aide de [PECL](https://pecl.php.net/), [pie](https://github.com/php/pie), [pickle](https://github.com/FriendsOfPHP/pickle) ou [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>

Enfin, activez l'extension dans le fichier de configuration de votre installation PHP. Le fichier de configuration est généralement nommé `php.ini`, et son emplacement peut être trouvé en exécutant `php --ini`. Ajoutez-y les lignes suivantes :

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

<Note>
  Lorsque vous utilisez le script [docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer) pour installer l'extension `opentelemetry`, l'extension est activée automatiquement et vous n'avez pas besoin de modifier manuellement le fichier `php.ini`.
</Note>

## Créer une nouvelle application AppSignal

Veuillez suivre d'abord le [guide d'installation](/guides/new-application) lors de l'ajout d'une nouvelle application à AppSignal.

À la fin de ce guide, vous recevrez une clé Push API et une URL de point d'accès du collecteur. Vous aurez besoin des deux pour configurer AppSignal pour PHP.