Bagaimana untuk memantau Pelanggan Guzzle Http – Petua pantas PHP

Guzzle ialah klien HTTP PHP popular yang memudahkan untuk menghantar permintaan HTTP dan membuat perpustakaan perkhidmatan web. Rangka kerja PHP yang paling popular menyediakan perkhidmatan Pelanggan Http dalaman, dan ia hanyalah pelaksanaan tersuai bagi Pelanggan Http Guzzle:

• Pelanggan Laravel Http
• Pelanggan Symfony Http
• Laminas (dahulunya Zend Framework) Pelanggan Http

Guzzle digunakan secara meluas untuk dua sebab utama:

1) Penyesuaian dan Fleksibiliti

Untuk peminat corak reka bentuk Guzzle terbuka kepada sambungan. Bermakna anda boleh melaksanakan fungsi baharu dengan mudah ke dalam Guzzle dengan memanjangkan komponen terasnya (Klien Http, Permintaan, Respons, Milddeware, dll).

2) Sokongan untuk Middleware

Sistem perisian tengah Guzzle membenarkan pembangun berinteraksi dengan Permintaan sebelum ia dihantar dan Respons sebelum ia diproses. Ia boleh mendayakan ciri lanjutan seperti pengelogan, pengesahan dan pengendalian ralat.

Pengenalan kepada Pelanggan HTTP Guzzle

Dalam tutorial ini, saya akan membimbing anda melalui proses mencipta Pelanggan Guzzle Http tersuai untuk memudahkan anda memantau setiap permintaan yang dibuat daripada aplikasi anda terhadap perkhidmatan luaran.

Saya juga akan menunjukkan kepada anda cara untuk menyuntik pelaksanaan ini ke dalam bekas IoC (atau Bekas Perkhidmatan) untuk menjadikan pelaksanaan ini tersedia sepanjang aplikasi anda.

Kami akan merangkumi asas, pilihan penyesuaian dan memberikan contoh kod sebenar.

Pasang Guzzle

Pastikan anda telah memasang Guzzle. Jika tidak, pasangkannya menggunakan Komposer:

composer require guzzlehttp/guzzle

Penyesuaian Asas

Mari mulakan dengan mencipta Pelanggan Http Guzzle tersuai asas:

namespace App\Extensions\Guzzle;

use GuzzleHttp\Client;

class CustomGuzzleClient extends Client 
{
    public function __construct(array $config = []) 
    {
        $config['headers']['Custom-Header'] = 'Custom-Value';
        parent::__construct($config);
    }
}

Dalam contoh ini, kami melanjutkan kelas Pelanggan Guzzle Http dan menyesuaikan pembina untuk menambah pengepala tersuai pada semua permintaan yang dibuat oleh pelanggan ini.

Pantau Permintaan Http Guzzle

Guzzle menyediakan kaedah pintasan untuk menjalankan permintaan Http:

$client->get('/endpoint');
$client->post('/endpoint');
$client->put('/endpoint');

Semua kaedah ini menggunakan kaedah permintaan generik di dalam. Tangkapan skrin di bawah diambil daripada kod Pelanggan Guzzle:

Anda boleh mengatasi kaedah permintaan untuk menyesuaikan pengurusan panggilan HTTP yang dibuat oleh aplikasi anda kepada perkhidmatan luaran.

namespace App\Extensions\Guzzle;

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;


class CustomGuzzleClient extends Client 
{
    public function request($method, $uri, array $options = []) 
    {
        return inspector()->addSegment(function () use ($method, $uri, $options) {

            return parent::request($method, $uri, $options);

        }, "http", "{$method} {$uri}");
    }
}

Dalam contoh ini saya hanya menambah item baharu dalam garis masa transaksi untuk setiap permintaan. Kini anda boleh melihat panggilan API yang dibuat oleh Guzzle dalam paparan pemantauan anda:

Jika anda baru menggunakan Inspektor, anda boleh mengikuti tutorial ini tentang cara untuk bermula:

https://inspector.dev/laravel-real-time-performance-monitoring-using-inspector-part-1/

Anda juga boleh menyuntik parameter Segmen dalam panggilan balik untuk berinteraksi dengan item atau menambah maklumat lanjut:

namespace App\Extensions\Guzzle;

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
use Inspector\Models\Segment;

class CustomGuzzleClient extends Client 
{
    public function request($method, $uri, array $options = []) 
    {
        return inspector()->addSegment(function (Segment $segment) use ($method, $uri, $options) {

            $response = parent::request($method, $uri, $options);
            $segment->label = "{$response->getStatusCode()} {$method} {$uri}";
            return $response;

        }, "http");
    }
}

Gunakan Pelanggan Http tersuai

Kini, anda boleh menggunakan pelanggan tersuai anda dalam aplikasi anda. Memandangkan sambungan itu tidak memperkenalkan sebarang perubahan pada gelagat Pelanggan Guzzle Http standard, anda boleh membuat contoh kelas tersuai dan menggunakannya seperti biasa:

// Create an instance of the custom client
$client = new CustomGuzzleClient(['base_uri' => 'https://api.example.com']);

// Make an API request. It will be automatically monitored by Inspector.
$response = $client->get('/endpoint');

Ikat Pelanggan Http Guzzle ke dalam bekas

Saya akan menggunakan Laravel dalam contoh ini, tetapi konsep asasnya adalah sama untuk rangka kerja PHP paling popular yang disebut pada permulaan artikel. Kesemuanya berfungsi dengan Bekas Perkhidmatan.

Kami mencipta satu pengikat tunggal ke dalam bekas untuk kelas Pelanggan Http Guzzle. Jadi setiap perkhidmatan yang meminta kelas ini akan menerima contoh pelanggan tersuai kami yang menyokong pemantauan masa nyata.

use GuzzleHttp\Client;
use App\Extensions\Guzzle\CustomGuzzleClient;
use Illuminate\Contracts\Foundation\Application;

$this->app->singleton(Client::class, function (Application $app) {
    return new CustomGuzzleClient();
});

Kini anda boleh cuba menyuntik kelas Pelanggan Http Guzzle dalam Perintah Artisan dan menjalankan panggilan Http hanya untuk ujian:

namespace App\Console\Commands;


use Illuminate\Console\Command;
use GuzzleHttp\Client;

class TryCommand extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'try';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Test Guzzle Http Client monitoring.';

    /**
     * Inject the Guzzle Http Client class into the constructor.
     * The CustomGuzzleClient will be the concrete class.
     */
    public function __construct(protected Client $client)
    {
        parent::__construct();
    }

    /**
     * Handle the command execution.
     */
    public function handle()
    {
        $this->line($this->description);

        $this->line("Concrete class: ".get_class($this->client));

        $this->client->get('https://google.com');

        return Command::SUCCESS;
    }
}

Jalankan arahan untuk mengesahkan sama ada Panggilan Http akan kelihatan dalam garis masa transaksi:

php artisan try

Baru Kepada Inspektor? Pantau aplikasi anda secara percuma

Inspektor ialah alat Pemantauan Pelaksanaan Kod yang direka khusus untuk pembangun perisian. Anda tidak perlu memasang apa-apa dalam infrastruktur atau pelayan awan anda, cuma pasang pakej komposer dan anda sudah bersedia untuk pergi.

Tidak seperti platform lain yang kompleks, semua-dalam-satu, Inspektor sangat mudah dan mesra PHP. Anda boleh mencuba pakej Laravel atau Symfony kami.

Jika anda mencari automasi yang berkesan, cerapan mendalam dan keupayaan untuk memajukan makluman dan pemberitahuan ke dalam persekitaran pemesejan anda cuba Inspektor secara percuma. Daftar akaun anda.

Atau ketahui lebih lanjut di tapak web: https://inspector.dev

Atas ialah kandungan terperinci Bagaimana untuk memantau Pelanggan Guzzle Http – Petua pantas PHP. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!