Ist es richtig, PHP und Apache-Version in Benutzer-Agent-Zeichenfolge für eine API zu senden?

Question

Ich habe ein API-Framework erstellt, das eine Vielzahl von Kommunikationsoptionen enthält, einschließlich Eingabevalidierungen und -verschlüsselungen.

Ich dachte, dass die Erstellung einer API-Wrapper-Klasse wegen all dieser Optionen erforderlich wäre, um den Prozess zu vereinfachen, wenn ein anderes System eine Verbindung zu meiner API herstellen möchte. So können sie im Grunde eine einzige Klasse herunterladen und sehr einfach von ihrem System über diese Klasse mit meinem System verbinden.

Diese Wrapper-Klasse nimmt Anfragen mit cURL vor.

Mein System enthält auch einen Logger, der API-Aufrufe für zukünftige Referenz und Untersuchung verfolgt (wenn Probleme sowie Leistung Grading), einschließlich Tracking-User-Agent-String für alle diese Anfragen.

Meine Frage ist, wie gut oder schlecht ist es, wenn ich Apache und PHP-Versionsnummern in dieser Zeichenfolge neben der API-Wrapper-Klasse-Version, wie diese enthalten:

myApi/1.0 (Apache 2.2.17;PHP 5.4.0) 

Ich mache mir Sorgen, wenn es sich um eine Problem, wenn die PHP-Versionsnummer so über das Web übertragen wird, obwohl sie zwischen Servern und nicht zwischen Client-Computer und Server liegt?

Answer 1

Ich denke, dass Sie die Unterscheidung zwischen API und Client überschreiten. In Anlehnung an Ihre Frage, es klingt wie Sie gebaut haben:

1. eine API mit verschiedenen Diensten/Ressourcen

2. eine Client-Klasse (der „Wrapper“), dass ein Drittanbieter-Entwickler verwenden können, in ihre eigene Anwendung mit Ihrem API

zu kommunizieren Wenn das der Fall ist, dann ist die Serverinformationen Sie suchen zu vermitteln, sind die Systemanforderungen für eine Anwendung, die Ihre Client-Klasse verwenden. Das hat keine Beziehung zu der Version von PHP, auf der Ihre API ausgeführt wird, außer dass Sie zufällig API und Client auf derselben Plattform entwickelt haben. Wenn Sie beispielsweise die API in PHP und den Wrapper in Java erstellt hätten, wäre es einfacher, die Unterscheidung zu sehen.

Die minimale PHP-Version für die Client/Wrapper-Klasse ist eine wichtige Information, die an Drittentwickler weitergegeben werden muss, damit sie die Klasse wie gewünscht verwenden können. In diesem Fall, dann ja, sollten Sie es irgendwo bereitstellen (mein Vorschlag wäre in der Dokumentation für die Wrapper-Klasse).