Guzzle ist ein beliebter PHP-HTTP-Client, der das Senden von HTTP-Anfragen und das Erstellen von Webdienstbibliotheken vereinfacht. Die beliebtesten PHP-Frameworks bieten einen internen HTTP-Client-Dienst und sind lediglich eine angepasste Implementierung des Guzzle-HTTP-Clients:
Guzzle wird aus zwei Hauptgründen häufig verwendet:
Für Fans von Designmustern ist Guzzle offen für Erweiterungen. Dies bedeutet, dass Sie problemlos neue Funktionalitäten in Guzzle implementieren können, indem Sie dessen Kernkomponenten (Http-Client, Anfrage, Antwort, Milddeware usw.) erweitern.
Das Guzzle-Middleware-System ermöglicht es Entwicklern, mit einer Anfrage zu interagieren, bevor sie gesendet wird, und mit einer Antwort, bevor sie verarbeitet wird. Es kann erweiterte Funktionen wie Protokollierung, Authentifizierung und Fehlerbehandlung aktivieren.
In diesem Tutorial werde ich Sie durch den Prozess der Erstellung eines benutzerdefinierten Guzzle-HTTP-Clients führen, um die Überwachung jeder von Ihrer Anwendung gestellten Anfrage gegenüber externen Diensten zu vereinfachen.
Ich zeige Ihnen auch, wie Sie diese Implementierung in den IoC-Container (oder Services-Container) einfügen, um diese Implementierung in Ihrer gesamten Anwendung verfügbar zu machen.
Wir werden die Grundlagen und Anpassungsoptionen behandeln und echte Codebeispiele bereitstellen.
Stellen Sie sicher, dass Guzzle installiert ist. Wenn nicht, installieren Sie es mit Composer:
composer require guzzlehttp/guzzle
Beginnen wir mit der Erstellung eines einfachen benutzerdefinierten Guzzle-HTTP-Clients:
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);
}
}
In diesem Beispiel erweitern wir die Guzzle Http Client-Klasse und passen den Konstruktor an, um allen von diesem Client gestellten Anforderungen einen benutzerdefinierten Header hinzuzufügen.
Guzzle bietet Verknüpfungsmethoden zum Ausführen von HTTP-Anfragen:
$client->get('/endpoint');
$client->post('/endpoint');
$client->put('/endpoint');
Alle diese Methoden verwenden die generische Anforderungsmethode im Inneren. Der Screenshot unten wurde aus dem Guzzle-Client-Code entnommen:
Sie können die Anforderungsmethode überschreiben, um die Verwaltung von HTTP-Aufrufen Ihrer Anwendung an externe Dienste anzupassen.
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}");
}
}
In diesem Beispiel füge ich einfach für jede Anfrage ein neues Element in der Zeitleiste der Transaktion hinzu. Jetzt können Sie die von Guzzle getätigten API-Aufrufe in Ihrer Überwachungsansicht sehen:
Wenn Sie neu bei Inspector sind, können Sie diesem Tutorial für den Einstieg folgen:
https://inspector.dev/laravel-real-time-performance-monitoring-using-inspector-part-1/
Sie können auch den Segment-Parameter in den Rückruf einfügen, um mit dem Element zu interagieren oder weitere Informationen hinzuzufügen:
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");
}
}
Jetzt können Sie Ihren benutzerdefinierten Client in Ihrer Anwendung verwenden. Da die Erweiterung keine Änderungen am Verhalten des Standard-Guzzle-HTTP-Clients mit sich bringt, können Sie eine Instanz der benutzerdefinierten Klasse erstellen und diese wie gewohnt verwenden:
// 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');
Ich werde in diesem Beispiel Laravel verwenden, aber das Grundkonzept ist das gleiche für die beliebtesten PHP-Frameworks, die am Anfang des Artikels erwähnt wurden. Alle arbeiten mit einem Service Container.
Wir erstellen eine Singleton-Bindung im Container für die Guzzle Http Client-Klasse. Daher erhält jeder Dienst, der nach dieser Klasse fragt, eine Instanz unseres benutzerdefinierten Clients, der Echtzeitüberwachung unterstützt.
use GuzzleHttp\Client;
use App\Extensions\Guzzle\CustomGuzzleClient;
use Illuminate\Contracts\Foundation\Application;
$this->app->singleton(Client::class, function (Application $app) {
return new CustomGuzzleClient();
});
Jetzt können Sie versuchen, die Guzzle-HTTP-Client-Klasse in einen Artisan-Befehl einzufügen und nur zum Testen einen HTTP-Aufruf auszuführen:
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;
}
}
Führen Sie den Befehl aus, um zu überprüfen, ob der HTTP-Aufruf in der Zeitleiste der Transaktion sichtbar ist:
php artisan try
Inspector ist ein Tool zur Codeausführungsüberwachung, das speziell für Softwareentwickler entwickelt wurde. Sie müssen nichts in Ihrer Cloud-Infrastruktur oder Ihren Servern installieren, installieren Sie einfach das Composer-Paket und schon kann es losgehen.
Im Gegensatz zu anderen komplexen All-in-One-Plattformen ist Inspector supereinfach und PHP-freundlich. Sie können unser Laravel- oder Symfony-Paket ausprobieren.
Wenn Sie auf der Suche nach effektiver Automatisierung, umfassenden Einblicken und der Möglichkeit sind, Warnungen und Benachrichtigungen an Ihre Messaging-Umgebung weiterzuleiten, testen Sie Inspector kostenlos. Registrieren Sie Ihr Konto.
Oder erfahren Sie mehr auf der Website: https://inspector.dev
Das obige ist der detaillierte Inhalt vonSo überwachen Sie den Guzzle-HTTP-Client – PHP-Schnelltipps. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!
