Tout ce que fait sgcHTTP, réparti sur le serveur HTTP, la passerelle FastCGI / SCGI, le client HTTP/2, le client gRPC et les trois clients Google Cloud. Chaque capacité fonctionne de la même façon en Delphi et en C++ Builder, et chaque licence est livrée avec le code source complet. Les sous-pages par composant ne sont pas encore publiées pour ce lancement, chaque entrée ci-dessous est autonome sur cette page.
Points d'accès, fichiers statiques, sessions, TLS
PHP & Python derrière ton serveur
Flux multiplexés, HPACK, ALPN
RPC unaires et en streaming
Pub/Sub, Calendar et FCM
Delphi 7 à 13, C++ Builder
sgcHTTP est autonome. Il est livré avec le runtime sgcWebSockets Core inclus, ce n'est donc pas un complément. Le serveur HTTP, TsgcHTTPServer, fait partie de ce runtime.
HTTP/2 et gRPC ont besoin de sgcCustomIndy. Les deux classes exigent ALPN pour la négociation du protocole TLS, que la bibliothèque Indy standard ne prend pas en charge, elles sont donc bâties sur sgcCustomIndy à la place. Il est toujours inclus dans ta commande, et le prix sgcHTTP affiché le couvre déjà. Les trois clients Google Cloud sont en HTTPS pur et n'en ont pas besoin. La passerelle FastCGI / SCGI non plus, elle fonctionne avec l'Indy standard livré avec RAD Studio.
Quatre composants sur la page de palette SGC HTTP et trois classes pur code Google Cloud. Le serveur HTTP est déclaré dans l'unité sgcHTTP_Server du runtime Core inclus, la passerelle FastCGI / SCGI dans l'unité sgcHTTP_Gateway, tout le reste dans l'unité sgcHTTP.
| Composant | Classe | Palette ? | Description |
|---|---|---|---|
| Serveur HTTP | TsgcHTTPServer | Oui | Serveur HTTP : événements de requête, fichiers statiques depuis une racine de documents, compression, keep-alive, sessions, uploads, TLS et authentification. Livré avec le runtime Core. |
| Passerelle FastCGI / SCGI | TsgcHTTPGateway | Oui | Transmet les requêtes reçues par le serveur HTTP à des serveurs d'applications FastCGI et SCGI via TCP, comme PHP-FPM ou un serveur Python SCGI. Unité sgcHTTP_Gateway. Indy standard, sans sgcCustomIndy. |
| Client HTTP/2 | TsgcHTTP2Client | Oui | Client HTTP/2 natif : flux multiplexés, compression d'en-têtes HPACK, négociation ALPN. Nécessite sgcCustomIndy. |
| Client gRPC | TsgcGRPCClient | Oui | Client gRPC bâti sur le client HTTP/2 : RPC unaires, en streaming serveur, en streaming client et bidirectionnels. Nécessite sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Non, pur code | API REST Google Cloud Pub/Sub : sujets, abonnements, instantanés, publication et récupération. HTTPS pur sur le Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Non, pur code | API Google Calendar v3 : agendas et événements, création, modification, liste, suppression. HTTPS pur sur le Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Non, pur code | API HTTP v1 Firebase Cloud Messaging : envoie une charge utile de notification push en un seul appel. HTTPS pur sur le Core. |
TsgcHTTPServer publie des points d'accès HTTP et des fichiers statiques depuis ta propre application. C'est le même moteur que le serveur WebSocket de sgcWebSockets, sans la partie WebSocket, et il est livré avec le runtime Core inclus.
| Capacité | API | Notes |
|---|---|---|
| Écoute | Port, Bindings, Active | Règle le port, ou lie des adresses précises, puis active le serveur. |
| Requêtes | OnCommandGet, OnCommandOther | Chaque requête arrive dans ton code avec ses objets de requête et de réponse. OnCommandOther couvre les verbes comme PUT et DELETE. |
| Fichiers statiques | DocumentRoot | Renvoie les fichiers statiques du dossier vers lequel tu le pointes. |
| Compression | HTTPCompression | Options de compression des réponses. |
| Connexions | KeepAlive, MaxConnections | Garde les connexions ouvertes entre les requêtes, et plafonne le nombre de connexions ouvertes en même temps. |
| Sessions | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Sessions côté serveur avec un délai d'expiration, plus des événements de début et de fin. |
| Limites de requête | MaxRequestBodySize | Plafonne la taille d'un corps de requête. |
| Uploads | HTTPUploadFiles | Enregistre les fichiers uploadés dans un répertoire de ton choix. |
| TLS | SSL, SSLOptions | Sers du HTTPS avec ton propre certificat. |
| Authentification | Authentication, OnAuthentication | Valide les identifiants dans ton propre code avant qu'une requête soit servie. |
| Threads | ThreadPool, ThreadPoolOptions | Réutilise les threads de travail d'un pool au lieu d'en créer un par connexion. |
| Runtime | sgcWebSockets Core | Déclaré dans l'unité sgcHTTP_Server du runtime Core inclus, sur la page de palette SGC HTTP. |
TsgcHTTPGateway transmet les requêtes reçues par TsgcHTTPServer ou TsgcWebSocketHTTPServer à des serveurs d'applications FastCGI et SCGI via TCP. Il fait le travail d'Apache mod_proxy_fcgi et mod_proxy_scgi ou de nginx fastcgi_pass et scgi_pass, si bien que les applications PHP et Python sont servies depuis ton serveur Delphi, sans Apache ni nginx devant.
| Capacité | API | Notes |
|---|---|---|
| Backends | FastCGI, SCGI | PHP avec PHP-FPM ou php-cgi -b, et applications Python servies par un serveur SCGI ou FastCGI, par exemple flup. |
| Requêtes | Process | Appelle-le depuis les événements OnCommandGet et OnCommandOther du serveur. Il renvoie true quand un handler correspond et que la réponse est remplie, et false quand ton propre code répond à la requête. |
| Handlers | Handlers.Add | Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') ou Handlers.Add('/app/', 'scgi://127.0.0.1:4000'). Un handler correspond par extension (*.php), par préfixe (/app/) ou par chemin exact. |
| Réglages du handler | Path, URL, Protocol, Host, Port, DocumentRoot, Enabled | Oriente chaque handler vers son backend avec une seule URL, ou avec protocole, hôte et port, et règle la racine de documents du backend. |
| Environnement CGI | SCRIPT_NAME, PATH_INFO, SCRIPT_FILENAME, QUERY_STRING, REMOTE_ADDR, HTTPS | Construit selon RFC 3875, chaque en-tête de requête étant transmis comme variable HTTP_*. |
| Variables supplémentaires | Environment, OnBeforeRequest | Ajoute des variables par handler via Environment, ou par requête dans OnBeforeRequest. |
| Réponses | Réponse CGI | Analyse l'en-tête Status, les redirections Location, les en-têtes de réponse et le corps. Plusieurs en-têtes Set-Cookie sont tous conservés. |
| Erreurs de passerelle | OnError | 502 Bad Gateway, 503 Service Unavailable quand le backend FastCGI est surchargé, et 504 Gateway Timeout, chacune signalée dans OnError. |
| Erreurs du backend | OnStdErr | Livre la sortie stderr envoyée par le backend FastCGI. |
| Connexions | ConnectTimeout, ReadTimeout, KeepAlive, MaxIdleConnections | Délais par handler, plus un pool de connexions keep-alive optionnel pour FastCGI (FCGI_KEEP_CONN), désactivé par défaut. SCGI ouvre une connexion par requête. |
| Rôle FastCGI | Responder | Le rôle FastCGI Responder. Les requêtes ne sont pas multiplexées sur une connexion. |
| Sécurité | Intégrée | Un en-tête de requête Proxy n'est jamais transmis comme HTTP_PROXY (httpoxy), les chemins contenant .. sont rejetés avec 403, et les noms d'en-têtes avec des underscores sont ignorés. |
| Limites | TCP, tamponné | Backends TCP uniquement, les sockets de domaine Unix ne sont pas encore pris en charge. Le processus backend doit déjà tourner, la passerelle ne le lance pas. Les réponses sont mises en tampon, le streaming comme les server-sent events n'est donc pas pris en charge. |
| Dépendance | Indy standard | Fonctionne avec la bibliothèque Indy livrée avec RAD Studio, sans sgcCustomIndy. Windows et Linux. |
| Unité & démo | sgcHTTP_Gateway | Sur la page de palette SGC HTTP. La démo se trouve dans Demos\20.HTTP_Protocol\18.FastCGI_SCGI_Gateway. |
TsgcHTTP2Client parle HTTP/2 (RFC 9113) sur une seule connexion TLS, négociée avec ALPN, c'est pourquoi il est bâti sur sgcCustomIndy.
| Capacité | API | Notes |
|---|---|---|
| Connexion | Host, Port, Active | Une seule connexion TLS porte chaque flux de requête multiplexé. |
| Connexion initiale | Connect, ConnectAsync | Ouvre la connexion et émet une requête optionnelle dans le même appel. |
| Lecture | Get, GetAsync | Appel synchrone ou tir-et-oublie avec la réponse délivrée par événement. |
| Écriture | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Les corps de requête sont des flux, les envois n'ont donc pas à tenir en mémoire. |
| Delete et Options | Delete, DeleteAsync, Options, OptionsAsync | Le reste du jeu de verbes HTTP, avec la même paire synchrone/async. |
| Réponses | OnHTTP2Response | Délivre ensemble les objets requête et réponse, y compris Response.DataString et le statut. |
| Corps fragmentés | OnHTTP2ResponseFragment | Se déclenche à l'arrivée de chaque fragment d'une réponse fragmentée, avant l'OnHTTP2Response final. |
| Push serveur | OnHTTP2PushPromise | Expose les ressources poussées par le serveur HTTP/2 à leur arrivée. |
| Cycle de vie de la connexion | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Les signaux de connexion, déconnexion et réinitialisation de flux définis par HTTP/2. |
| Réglages | HTTP2Options, Settings | Les valeurs de la trame SETTINGS HTTP/2 locale envoyées au pair. |
| Fiabilité | WatchDog, HeartBeat, Throttle | Reconnexion automatique, maintien de connexion et limitation de débit, partagés avec le reste de la pile HTTP sgc. |
| Authentification et TLS | Authentication, TLSOptions, OnHTTP2Authorization | Schémas d'authentification standards et configuration TLS, plus un point d'accroche pour des en-têtes d'autorisation personnalisés. |
| Dépendance | sgcCustomIndy | ALPN négocie le protocole h2 pendant la poignée de main TLS ; la bibliothèque Indy standard ne peut pas le faire. |
TsgcGRPCClient transporte des charges utiles Protocol Buffers sur les flux multiplexés du client HTTP/2, il couvre donc les quatre formes d'appel gRPC.
| Capacité | API | Notes |
|---|---|---|
| Transport | Client | Une instance TsgcHTTP2Client ; le client gRPC repose dessus plutôt que d'ouvrir sa propre connexion. |
| RPC unaire | Call, CallAsync, CallString | Une requête, une réponse. Call bloque et renvoie un TsgcGRPCResponse ; CallAsync la délivre via OnGRPCResponse. |
| Streaming serveur | ServerStreamingCall | Une requête, un flux de réponses délivrées via OnGRPCStreamMessage jusqu'à OnGRPCStreamEnd. |
| Streaming client | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Un flux de requêtes, une réponse finale à la fermeture du flux. |
| Streaming bidirectionnel | OpenBidiStream, SendBidiMessage, CloseBidiStream | Les deux côtés diffusent indépendamment sur le même appel. |
| Annulation | CancelCall | Annule un appel en cours par son identifiant de flux. |
| Réponses | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse porte StatusCode, Data/DataString, Headers et Trailers. |
| Erreurs | OnGRPCError, OnGRPCException | Erreurs de code de statut gRPC et exceptions de niveau transport, délivrées séparément. |
| Métadonnées | DefaultMetadata, OnGRPCBeforeRequest | En-têtes de métadonnées gRPC par appel et par défaut. |
| Résilience | RetryPolicy, Interceptors, ServiceConfig | Comportement de réessai, chaîne d'intercepteurs transversale et configuration de service, sans toucher aux points d'appel individuels. |
| Observabilité | MetricsCollector | Collecte les métriques d'appel du client. |
| Dépendance | sgcCustomIndy | Héritée du client HTTP/2 sur lequel il est bâti ; ALPN est requis de la même façon. |
Trois classes pur code, authentifiées avec un compte de service Google et atteintes en HTTPS pur. Aucune n'a besoin de sgcCustomIndy.
| Capacité | API | Notes |
|---|---|---|
| Authentification | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT de compte de service : id de projet, e-mail client et clé privée. Forme partagée par les trois clients. |
| Pub/Sub : publier et récupérer | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Envoie des messages vers un sujet, récupère et accuse réception depuis un abonnement. |
| Pub/Sub : sujets | CreateTopic, DeleteTopic, GetTopic, ListTopics | Gère les sujets directement depuis le code. |
| Pub/Sub : abonnements | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Cycle de vie complet de l'abonnement, y compris les changements de délai d'accusé de réception et de configuration push. |
| Pub/Sub : instantanés | CreateSnapshot, DeleteSnapshot, ListSnapshots | Capture l'état d'accusé de réception d'un abonnement pour une relecture ultérieure. |
| Calendar : agendas | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Encapsule la liste d'agendas de l'API Google Calendar v3. |
| Calendar : événements | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Crée, modifie et supprime des événements sur un agenda donné. |
| Calendar : synchronisation | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Points d'accroche de synchronisation incrémentale pour les agendas et événements modifiés depuis la dernière synchronisation. |
| FCM : push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Un seul appel envoie une charge utile Firebase Cloud Messaging v1 à un projet. |
| TLS et journalisation | TLSOptions, LogFile | Partagés par les trois clients Google Cloud. |
Des standards publics sur le fil, et le même source sur chaque compilateur pris en charge.
| Domaine | Détail |
|---|---|
| Serveur HTTP | Requêtes et réponses HTTP, fichiers statiques, sessions et HTTPS avec TsgcHTTPServer. |
| FastCGI / SCGI | Le rôle FastCGI Responder et SCGI via TCP, avec l'environnement CGI construit selon RFC 3875, avec TsgcHTTPGateway. |
| HTTP/2 | RFC 9113, avec compression d'en-têtes HPACK et négociation de protocole ALPN. |
| gRPC | Charges utiles Protocol Buffers sur des flux HTTP/2, selon le protocole de câble gRPC. |
| Google Cloud | L'API REST Pub/Sub, l'API Google Calendar v3, et l'API HTTP v1 Firebase Cloud Messaging, toutes authentifiées avec un compte de service Google. |
| Plateformes | Windows Win32, Windows Win64, Linux64, macOS, iOS et Android pour les cinq classes clientes. La passerelle FastCGI / SCGI fonctionne sous Windows et Linux. |
| Dépendance | Les clients HTTP/2 et gRPC ont besoin de sgcCustomIndy pour ALPN. Les clients Google Cloud n'ont besoin que du runtime Core inclus. La passerelle FastCGI / SCGI fonctionne avec l'Indy standard livré avec RAD Studio et n'a pas besoin de sgcCustomIndy. |
| Compilateurs | Delphi et C++ Builder 7 à 13. |
| Éditions | HTTP/2, gRPC et la passerelle FastCGI / SCGI sont aussi livrés dans sgcWebSockets à partir d'Enterprise, et les clients Google Cloud à partir de Standard. Le serveur HTTP fait partie du runtime Core, toutes les éditions de sgcWebSockets l'incluent donc aussi. |
| Licence | Autonome. Le runtime sgcWebSockets Core est inclus et le code source complet est fourni. |