Zum Hauptinhalt springen
Für den Einstieg in das PHP-Paket gibt es zwei Anforderungen:
  1. Eine aktiv unterstützte PHP-Version. Siehe unsere Wartungsrichtlinie.
  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.
sudo apt-get install gcc make autoconf
brew install gcc make autoconf
Installieren Sie anschließend die OpenTelemetry-PHP-Erweiterung mit PECL, pie, pickle oder docker-php-extension-installer:
pecl install opentelemetry
# 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
# 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
# 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
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
[opentelemetry]
extension=opentelemetry.so
Wenn Sie das Skript 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.

Neue AppSignal-Anwendung erstellen

Bitte folgen Sie zuerst dem Installationsleitfaden, 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.