README

这是一个OpenZipkin的非官方PHP库。

要求

PHP > 7.0

状态

不完整，只有一个传输方式且没有集成。这个库仅包含向zipkin发送span的极简实现。

入门

推荐通过Composer安装PHP-Zipkin。

composer require shlj/php-zipkin:^1.*

示例用法

<?php
$client   = new \GuzzleHttp\Client();
$logger   = new \Drefined\Zipkin\Transport\HTTPLogger($client);
$tracer   = new \Drefined\Zipkin\Tracer($logger, 1.0, true);
$endpoint = new \Drefined\Zipkin\Core\Endpoint('127.0.0.1', 8080, 'test-trace');
$trace    = new \Drefined\Zipkin\Core\Trace($tracer, $endpoint);

$trace->createNewSpan('test-server-trace');

$trace->record(
    [Annotation::generateServerRecv()],
    [BinaryAnnotation::generateString('server.request.uri', '/server')]
);

$trace->record(
    [Annotation::generateServerSend()],
    [BinaryAnnotation::generateString('server.response', 200)]
);

Laravel集成（简单）

在合适的位置添加中间件和服务提供者。

<?php // laravel-project/app/Http/Kernel.php

namespace App\Http;

use ...
use Drefined\Zipkin\Instrumentation\Laravel\Middleware\EnableZipkinTracing;

class Kernel extends HttpKernel
{
    ...
    protected $middleware = [
        ...
        EnableZipkinTracing::class,
    ];
    ...
}

<?php // laravel-project/config/app.php

use Drefined\Zipkin\Instrumentation\Laravel\Providers\ZipkinTracingServiceProvider;

return [
    ...
    'providers' => [
        ...
        ZipkinTracingServiceProvider::class,
    ],
    ...
];

Lumen集成（简单）

在合适的位置添加中间件和服务提供者。

<?php // lumen-project/app/bootstrap/app.php

require_once __DIR__.'/../vendor/autoload.php';

    ...
    $app->middleware([
        ...
        \Drefined\Zipkin\Instrumentation\Lumen\Middleware\EnableZipkinTracing::class
    ]);
    
    ...
    // $app->register(App\Providers\AppServiceProvider::class);
    $app->register(\Drefined\Zipkin\Instrumentation\Lumen\Providers\ZipkinTracingServiceProvider::class);

待办事项

添加完整的Laravel集成（目前支持不带应用环境配置的简单实现）
添加Symfony集成
添加Redis包装器
添加HTTP包装器
添加PDO包装器
添加Scribe传输
添加Kafka传输

shlj / php-zipkin

维护者

详细信息

README

要求

状态

入门

示例用法

Laravel集成（简单）

Lumen集成（简单）

待办事项

灵感来源

参考

生成PHP Thrift类

许可证

贡献者