Alles, was sgcHTTP kann, aufgeschlüsselt nach dem HTTP-Server, dem FastCGI / SCGI Gateway, dem HTTP/2-Client, dem gRPC-Client und den drei Google-Cloud-Clients. Jede Fähigkeit arbeitet in Delphi und C++ Builder identisch, und jede Lizenz enthält den vollständigen Quellcode. Für diesen Launch sind noch keine Komponenten-Unterseiten veröffentlicht, jeder Eintrag unten ist auf dieser Seite in sich abgeschlossen.
Endpunkte, statische Dateien, Sitzungen, TLS
PHP & Python hinter deinem Server
Gemultiplexte Streams, HPACK, ALPN
Unary- & Streaming-RPC
Pub/Sub, Calendar & FCM
Delphi 7 bis 13, C++ Builder
sgcHTTP ist in sich geschlossen. Es bringt die sgcWebSockets Core Runtime mit, es ist also kein Add-on. Der HTTP-Server, TsgcHTTPServer, ist Teil dieser Runtime.
HTTP/2 und gRPC brauchen sgcCustomIndy. Beide Klassen brauchen ALPN für die TLS-Protokollaushandlung, was die Standard-Indy-Bibliothek nicht unterstützt, sie bauen also stattdessen auf sgcCustomIndy auf. Es ist immer in deiner Bestellung enthalten, und der angezeigte sgcHTTP-Preis deckt es bereits ab. Die drei Google-Cloud-Clients sind reines HTTPS und brauchen es nicht. Das gilt auch für das FastCGI / SCGI Gateway, das mit der Standard-Indy-Bibliothek arbeitet, die mit RAD Studio ausgeliefert wird.
Vier Komponenten auf der Palettenseite SGC HTTP und drei reine Code-Klassen für Google Cloud. Der HTTP-Server ist in der Unit sgcHTTP_Server der mitgelieferten Core Runtime deklariert, das FastCGI / SCGI Gateway in der Unit sgcHTTP_Gateway, alles andere in der Unit sgcHTTP.
| Komponente | Klasse | Auf der Palette? | Beschreibung |
|---|---|---|---|
| HTTP-Server | TsgcHTTPServer | Ja | HTTP-Server: Anfrage-Ereignisse, statische Dateien aus einem Document Root, Kompression, Keep-Alive, Sitzungen, Uploads, TLS und Authentifizierung. Wird mit der Core Runtime ausgeliefert. |
| FastCGI / SCGI Gateway | TsgcHTTPGateway | Ja | Leitet Anfragen, die der HTTP-Server empfängt, über TCP an FastCGI- und SCGI-Anwendungsserver weiter, etwa PHP-FPM oder einen Python-SCGI-Server. Unit sgcHTTP_Gateway. Standard-Indy, kein sgcCustomIndy nötig. |
| HTTP/2 Client | TsgcHTTP2Client | Ja | Nativer HTTP/2-Client: gemultiplexte Streams, HPACK-Header-Kompression, ALPN-Aushandlung. Braucht sgcCustomIndy. |
| gRPC Client | TsgcGRPCClient | Ja | gRPC-Client, aufgebaut auf dem HTTP/2-Client: Unary-, Server-Streaming-, Client-Streaming- und bidirektionale RPC. Braucht sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Nein, reine Code-Klasse | Google Cloud Pub/Sub REST API: Topics, Subscriptions, Snapshots, Publish und Pull. Reines HTTPS auf Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Nein, reine Code-Klasse | Google Calendar API v3: Kalender und Ereignisse, erstellen, aktualisieren, auflisten, löschen. Reines HTTPS auf Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Nein, reine Code-Klasse | Firebase Cloud Messaging HTTP v1 API: eine Push-Benachrichtigungs-Payload mit einem Aufruf senden. Reines HTTPS auf Core. |
TsgcHTTPServer veröffentlicht HTTP-Endpunkte und statische Dateien aus deiner eigenen Anwendung. Es ist dieselbe Engine wie der sgcWebSockets-WebSocket-Server, nur ohne den WebSocket-Teil, und er wird mit der mitgelieferten Core Runtime ausgeliefert.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Lauschen | Port, Bindings, Active | Setze den Port oder binde an bestimmte Adressen, und aktiviere dann den Server. |
| Anfragen | OnCommandGet, OnCommandOther | Jede Anfrage erreicht deinen Code mit ihren Request- und Response-Objekten. OnCommandOther deckt Verben wie PUT und DELETE ab. |
| Statische Dateien | DocumentRoot | Liefert statische Dateien aus dem Ordner aus, auf den du es richtest. |
| Kompression | HTTPCompression | Optionen für die Antwortkompression. |
| Verbindungen | KeepAlive, MaxConnections | Hält Verbindungen zwischen Anfragen offen und begrenzt, wie viele gleichzeitig offen sind. |
| Sitzungen | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Serverseitige Sitzungen mit Timeout, plus Start- und Ende-Ereignisse. |
| Anfragelimits | MaxRequestBodySize | Begrenzt die Größe eines Request-Bodys. |
| Uploads | HTTPUploadFiles | Speichert hochgeladene Dateien in einem Verzeichnis deiner Wahl. |
| TLS | SSL, SSLOptions | Liefere HTTPS mit deinem eigenen Zertifikat aus. |
| Authentifizierung | Authentication, OnAuthentication | Prüfe Zugangsdaten in deinem eigenen Code, bevor eine Anfrage bedient wird. |
| Threads | ThreadPool, ThreadPoolOptions | Verwendet Worker-Threads aus einem Pool wieder, statt pro Verbindung einen zu erzeugen. |
| Runtime | sgcWebSockets Core | Deklariert in der Unit sgcHTTP_Server der mitgelieferten Core Runtime, auf der Palettenseite SGC HTTP. |
TsgcHTTPGateway leitet Anfragen, die TsgcHTTPServer oder TsgcWebSocketHTTPServer empfängt, über TCP an FastCGI- und SCGI-Anwendungsserver weiter. Es übernimmt die Aufgabe von Apache mod_proxy_fcgi und mod_proxy_scgi oder von nginx fastcgi_pass und scgi_pass, sodass PHP- und Python-Anwendungen von deinem Delphi-Server bedient werden, ohne Apache oder nginx davor.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Backends | FastCGI, SCGI | PHP über PHP-FPM oder php-cgi -b, und Python-Anwendungen, die von einem SCGI- oder FastCGI-Server bedient werden, zum Beispiel flup. |
| Anfragen | Process | Rufe es aus den Ereignissen OnCommandGet und OnCommandOther des Servers auf. Es liefert true, wenn ein Handler gepasst hat und die Antwort gefüllt ist, und false, wenn dein eigener Code die Anfrage beantwortet. |
| Handler | Handlers.Add | Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') oder Handlers.Add('/app/', 'scgi://127.0.0.1:4000'). Ein Handler passt nach Erweiterung (*.php), nach Präfix (/app/) oder nach exaktem Pfad. |
| Handler-Einstellungen | Path, URL, Protocol, Host, Port, DocumentRoot, Enabled | Richte jeden Handler mit einer einzigen URL oder mit Protokoll, Host und Port auf sein Backend aus und setze das Document Root des Backends. |
| CGI-Umgebung | SCRIPT_NAME, PATH_INFO, SCRIPT_FILENAME, QUERY_STRING, REMOTE_ADDR, HTTPS | Aufgebaut nach RFC 3875, wobei jeder Request-Header als HTTP_*-Variable weitergegeben wird. |
| Zusätzliche Variablen | Environment, OnBeforeRequest | Füge Variablen pro Handler über Environment hinzu, oder pro Anfrage in OnBeforeRequest. |
| Antworten | CGI-Antwort | Parst den Status-Header, Location-Weiterleitungen, die Antwort-Header und den Body. Mehrere Set-Cookie-Header bleiben alle erhalten. |
| Gateway-Fehler | OnError | 502 Bad Gateway, 503 Service Unavailable, wenn das FastCGI-Backend überlastet ist, und 504 Gateway Timeout, jeweils in OnError gemeldet. |
| Backend-Fehler | OnStdErr | Liefert die stderr-Ausgabe, die das FastCGI-Backend sendet. |
| Verbindungen | ConnectTimeout, ReadTimeout, KeepAlive, MaxIdleConnections | Timeouts pro Handler, dazu ein optionaler Keep-Alive-Verbindungspool für FastCGI (FCGI_KEEP_CONN), standardmäßig aus. SCGI öffnet pro Anfrage eine Verbindung. |
| FastCGI-Rolle | Responder | Die FastCGI-Rolle Responder. Anfragen werden nicht auf einer Verbindung gemultiplext. |
| Sicherheit | Eingebaut | Ein Proxy-Request-Header wird nie als HTTP_PROXY weitergegeben (httpoxy), Pfade mit .. werden mit 403 abgelehnt, und Header-Namen mit Unterstrichen werden ignoriert. |
| Einschränkungen | TCP, gepuffert | Nur TCP-Backends, Unix-Domain-Sockets werden noch nicht unterstützt. Der Backend-Prozess muss bereits laufen, das Gateway startet ihn nicht. Antworten werden gepuffert, daher wird Streaming wie Server-Sent Events nicht unterstützt. |
| Abhängigkeit | Standard-Indy | Arbeitet mit der Indy-Bibliothek, die mit RAD Studio ausgeliefert wird, kein sgcCustomIndy nötig. Windows und Linux. |
| Unit & Demo | sgcHTTP_Gateway | Auf der Palettenseite SGC HTTP. Die Demo liegt in Demos\20.HTTP_Protocol\18.FastCGI_SCGI_Gateway. |
TsgcHTTP2Client spricht HTTP/2 (RFC 9113) über eine einzige TLS-Verbindung, ausgehandelt per ALPN, weshalb es auf sgcCustomIndy aufbaut.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Verbindung | Host, Port, Active | Eine TLS-Verbindung trägt jeden gemultiplexten Anfrage-Stream. |
| Verbinden | Connect, ConnectAsync | Öffnet die Verbindung und stellt im selben Aufruf optional eine Anfrage. |
| Lesen | Get, GetAsync | Synchroner Aufruf oder Fire-and-Forget mit der Antwort per Ereignis. |
| Schreiben | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Anfrage-Bodys sind Streams, Uploads müssen also nicht in den Speicher passen. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | Der Rest der HTTP-Verb-Menge, dieselbe synchrone/asynchrone Paarung. |
| Antworten | OnHTTP2Response | Liefert das Anfrage- und das Antwortobjekt zusammen, einschließlich Response.DataString und Status. |
| Chunked Bodies | OnHTTP2ResponseFragment | Feuert bei jedem Fragment einer chunked Antwort, noch vor dem abschließenden OnHTTP2Response. |
| Server Push | OnHTTP2PushPromise | Macht per HTTP/2 vom Server gepushte Ressourcen sichtbar, sobald sie eintreffen. |
| Verbindungs-Lebenszyklus | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Die Connect-, Disconnect- und Stream-Reset-Signale, die HTTP/2 definiert. |
| Settings | HTTP2Options, Settings | Die lokalen HTTP/2-SETTINGS-Frame-Werte, die an die Gegenstelle gesendet werden. |
| Zuverlässigkeit | WatchDog, HeartBeat, Throttle | Auto-Reconnect, Keep-Alive und Anfrage-Drosselung, geteilt mit dem übrigen sgc-HTTP-Stack. |
| Auth & TLS | Authentication, TLSOptions, OnHTTP2Authorization | Gängige Authentifizierungsschemata und TLS-Konfiguration, dazu ein Hook für benutzerdefinierte Authorization-Header. |
| Abhängigkeit | sgcCustomIndy | ALPN handelt das h2-Protokoll während des TLS-Handshakes aus; die Standard-Indy-Bibliothek kann das nicht. |
TsgcGRPCClient trägt Protocol-Buffers-Payloads über die gemultiplexten Streams des HTTP/2-Clients, es deckt also alle vier gRPC-Aufrufformen ab.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Transport | Client | Eine TsgcHTTP2Client-Instanz; der gRPC-Client reitet darauf, statt eine eigene Verbindung zu öffnen. |
| Unary-RPC | Call, CallAsync, CallString | Eine Anfrage, eine Antwort. Call blockiert und liefert eine TsgcGRPCResponse; CallAsync liefert sie über OnGRPCResponse. |
| Server-Streaming | ServerStreamingCall | Eine Anfrage, ein Antwort-Stream, geliefert über OnGRPCStreamMessage bis OnGRPCStreamEnd. |
| Client-Streaming | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Ein Anfrage-Stream, eine finale Antwort, wenn der Stream schließt. |
| Bidirektionales Streaming | OpenBidiStream, SendBidiMessage, CloseBidiStream | Beide Seiten streamen unabhängig über denselben Aufruf. |
| Abbruch | CancelCall | Bricht einen laufenden Aufruf über seine Stream-ID ab. |
| Antworten | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse trägt StatusCode, Data/DataString, Headers und Trailers. |
| Fehler | OnGRPCError, OnGRPCException | gRPC-Statuscode-Fehler und Transport-Ebene-Exceptions, getrennt geliefert. |
| Metadaten | DefaultMetadata, OnGRPCBeforeRequest | Aufruf- und Standard-gRPC-Metadaten-Header. |
| Resilienz | RetryPolicy, Interceptors, ServiceConfig | Retry-Verhalten, eine übergreifende Interceptor-Kette und Service-Konfiguration, ohne einzelne Aufrufstellen anzufassen. |
| Observability | MetricsCollector | Sammelt Aufruf-Metriken für den Client. |
| Abhängigkeit | sgcCustomIndy | Vom HTTP/2-Client geerbt, auf dem er aufbaut; ALPN wird auf dieselbe Weise benötigt. |
Drei reine Code-Klassen, authentifiziert mit einem Google-Service-Konto und über reines HTTPS erreicht. Keine davon braucht sgcCustomIndy.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Authentifizierung | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | Service-Konto-JWT: Projekt-ID, Client-E-Mail und privater Schlüssel. Dieselbe Form über alle drei Clients hinweg. |
| Pub/Sub: Publish & Pull | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Sende Nachrichten an ein Topic, hole ab und bestätige von einer Subscription. |
| Pub/Sub: Topics | CreateTopic, DeleteTopic, GetTopic, ListTopics | Verwalte Topics direkt aus dem Code. |
| Pub/Sub: Subscriptions | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Vollständiger Subscription-Lebenszyklus, einschließlich Ack-Deadline- und Push-Config-Änderungen. |
| Pub/Sub: Snapshots | CreateSnapshot, DeleteSnapshot, ListSnapshots | Erstelle einen Snapshot des Bestätigungsstatus einer Subscription für spätere Wiederholung. |
| Calendar: Kalender | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Umhüllt die Kalenderliste der Google Calendar API v3. |
| Calendar: Ereignisse | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Erstelle, ändere und entferne Ereignisse in einem gegebenen Kalender. |
| Calendar: Synchronisierung | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Inkrementelle Synchronisierungs-Hooks für Kalender und Ereignisse, die sich seit der letzten Synchronisierung geändert haben. |
| FCM: Push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Ein Aufruf sendet eine Firebase-Cloud-Messaging-v1-Payload an ein Projekt. |
| TLS und Logging | TLSOptions, LogFile | Geteilt über alle drei Google-Cloud-Clients. |
Öffentliche Standards auf der Leitung, und derselbe Quellcode über jeden unterstützten Compiler hinweg.
| Bereich | Detail |
|---|---|
| HTTP-Server | HTTP-Anfragen und -Antworten, statische Dateien, Sitzungen und HTTPS über TsgcHTTPServer. |
| FastCGI / SCGI | Die FastCGI-Responder-Rolle und SCGI über TCP, mit der nach RFC 3875 aufgebauten CGI-Umgebung, über TsgcHTTPGateway. |
| HTTP/2 | RFC 9113, mit HPACK-Header-Kompression und ALPN-Protokollaushandlung. |
| gRPC | Protocol-Buffers-Payloads über HTTP/2-Streams, gemäß dem gRPC-Wire-Protokoll. |
| Google Cloud | Die Pub/Sub-REST-API, die Google Calendar API v3 und die Firebase Cloud Messaging HTTP v1 API, alle authentifiziert mit einem Google-Service-Konto. |
| Plattformen | Windows Win32, Windows Win64, Linux64, macOS, iOS und Android für alle fünf Client-Klassen. Das FastCGI / SCGI Gateway läuft unter Windows und Linux. |
| Abhängigkeit | Der HTTP/2- und der gRPC-Client brauchen sgcCustomIndy für ALPN. Die Google-Cloud-Clients brauchen nur die mitgelieferte Core Runtime. Das FastCGI / SCGI Gateway arbeitet mit der Standard-Indy-Bibliothek, die mit RAD Studio ausgeliefert wird, und braucht kein sgcCustomIndy. |
| Compiler | Delphi und C++ Builder 7 bis 13. |
| Editionen | HTTP/2, gRPC und das FastCGI / SCGI Gateway sind außerdem ab der Enterprise-Edition in sgcWebSockets enthalten, und die Google-Cloud-Clients ab Standard. Der HTTP-Server ist Teil der Core Runtime, daher enthält ihn auch jede sgcWebSockets-Edition. |
| Lizenzierung | Eigenständig. Die sgcWebSockets Core Runtime ist mitgeliefert und der vollständige Quellcode ist enthalten. |