通过OpenTelemetry Php接入APM

华为云APM兼容OpenTelemetry协议，支持直接接收通过OpenTelemetry SDK或Agent上报的链路追踪数据。本文将介绍如何通过OpenTelemetry Java Php实现通过链路数据对接到APM。

限制条件

非侵入式接入，需使用PHP 8.0以及以上版本。

环境准备

准备插件/工具：PHP 8.0+、PECL、composer。

安装，命令如下：

apt update 
apt install -y php-pear 
apt install composer

环境验证，命令如下：
```
pecl version 
composer --version
```

示例demo

初始化demo应用。

在空白的项目目录中，初始化一个简单的composer.json文件。

composer init \   
--no-interaction \   
--require slim/slim:"^4" \   
--require slim/psr7:"^1"  

composer update

编写应用代码。创建index.php文件，内容如下：

<?php 
use Psr\Http\Message\ResponseInterface as Response; 
use Psr\Http\Message\ServerRequestInterface as Request; 
use Slim\Factory\AppFactory;  
require __DIR__ . '/vendor/autoload.php';  

$app = AppFactory::create();  

$app->get('/rolldice', function (Request $request, Response $response) { 
    $result = random_int(1,6); 
    $response->getBody()->write(strval($result)); 
    return $response; });  

$app->run();

运行程序，命令如下：

php -S localhost:8080 & 
curl http://localhost:8080/rolldice

非侵入式接入

安装必须构建工具，命令如下：
```
sudo apt-get install gcc make autoconf
```
使用构建安装扩展组件，命令如下：
```
sudo apt-get install php-dev 
pecl install opentelemetry  
pecl install grpc   //安装编译时间较长（20-30分钟），请耐心等待 
pecl install protobuf-3.21.12  //与 PHP 8兼容
```
根据php需要选择对应的插件版本，比如php8.0，opentelemetry需要选择1.1.3或者之前的版本，protobuf 使用3.21.0相近的版本。

启用扩展组件。

定位当前环境加载的php.ini配置文件路径，命令如下：
```
php --ini | grep "Configuration File"
```

在php中添加以下内容：

[opentelemetry]
extension=opentelemetry.so[
[PHP]
extensionxtension=grpc.so
extensionextension=protobuf.so

验证命令如下：

php --ri opentelemetry
php --ri grpc
php --ri protobuf

安装服务框架所依赖的opentelemetry自动插件包，命令如下：

composer config allow-plugins.php-http/discovery false
composer require open-telemetry/sdk
composer require open-telemetry/exporter-otlp
composer require open-telemetry/transport-grpc
composer require open-telemetry/opentelemetry-auto-slim
composer update

添加云服务配置参数到环境中并启动，命令如下：

env OTEL_EXPORTER_OTLP_ENDPOINT=http://xxx.xxx.xx.xxx:4317 \
OTEL_EXPORTER_OTLP_HEADERS=Authentication=LV***9l \
OTEL_EXPORTER_OTLP_PROTOCOL=grpc \
OTEL_PHP_AUTOLOAD_ENABLED=true \
OTEL_SERVICE_NAME=应用名称.组件名称.环境名称 \
php -S localhost:8080 &