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

# Anforderungen für AppSignal für PHP

Für den Einstieg in das PHP-Paket gibt es zwei Anforderungen:

1. Eine aktiv unterstützte [PHP-Version](https://www.php.net/supported-versions). Siehe unsere [Wartungsrichtlinie](/support/maintenance-policy).
2. Die OpenTelemetry-PHP-Erweiterung.

Wir führen Sie durch die Installation der OpenTelemetry-Erweiterung.

## OpenTelemetry-PHP-Erweiterung installieren

Die OpenTelemetry-PHP-Erweiterung stellt Hooks in PHP-Funktionen bereit, die dieses Paket verwendet, um Ihre Anwendung zu instrumentieren. Dies ist eine PHP-Erweiterung, die Sie in Ihrer PHP-Umgebung installieren und aktivieren müssen.

Stellen Sie zunächst sicher, dass die erforderlichen Build-Abhängigkeiten auf Ihrem System verfügbar sind.

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

Installieren Sie anschließend die OpenTelemetry-PHP-Erweiterung mit [PECL](https://pecl.php.net/), [pie](https://github.com/php/pie), [pickle](https://github.com/FriendsOfPHP/pickle) oder [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>

Aktivieren Sie die Erweiterung schließlich in der Konfigurationsdatei Ihrer PHP-Installation. Die Konfigurationsdatei heißt üblicherweise `php.ini`; ihren Speicherort können Sie mit `php --ini` ermitteln. Fügen Sie ihr die folgenden Zeilen hinzu:

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

<Note>
  Wenn Sie das Skript [docker-php-extension-installer](https://github.com/mlocati/docker-php-extension-installer) zur Installation der `opentelemetry`-Erweiterung verwenden, wird die Erweiterung automatisch aktiviert und Sie müssen die Datei `php.ini` nicht manuell bearbeiten.
</Note>

## Neue AppSignal-Anwendung erstellen

Bitte folgen Sie zuerst dem [Installationsleitfaden](/guides/new-application), wenn Sie eine neue Anwendung zu AppSignal hinzufügen.

Am Ende dieses Leitfadens erhalten Sie einen Push-API-Key und eine Collector-Endpoint-URL. Sie benötigen beide, um AppSignal für PHP zu konfigurieren.