PHP Academy · Les

Servicecommunicatie: REST en gRPC

Verbind services synchroon en efficiënt.

Les 2 van 413 stappen

Servicecommunicatie: REST en gRPC is een gratis PHP Academy-les op CoddyKit. Dit is les 2 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject PHP Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus PHP Academy bevat in totaal 4 lessen.

REST en gRPC

Services moeten synchroon met elkaar kunnen communiceren: er gaat een verzoek uit en er komt een antwoord terug. De twee belangrijkste keuzes zijn REST via HTTP/JSON en gRPC via HTTP/2 + Protobuf. Ze optimaliseren voor verschillende zaken — REST voor bereik en gebruiksvriendelijkheid, gRPC voor snelheid en strikte contracten.

Deze les laat beide opties zien vanuit PHP-perspectief en legt uit wanneer je welke kiest.

REST: de gemeenschappelijke taal

REST modelleert bronnen achter URL's en gebruikt HTTP-werkwoorden en statuscodes voor de betekenis. De sterke punten zijn universele hulpmiddelen, cachebaarheid, debugbaarheid met curl en geen speciale clientvereisten. De zwakke punten zijn uitgebreide JSON, geen afgedwongen schema en uitsluitend verzoeken en antwoorden.

Voor openbare API's en eindpunten voor browsers is REST bijna altijd de juiste keuze.

Een REST-service aanroepen

Gebruik een PSR-18 HTTP-client (hier Guzzle). Stel altijd een verbindings- en verzoek-time-out in — een onbeperkte aanroep naar een trage peer kan je PHP-FPM-werkprocessen uitputten en de storing verder verspreiden.

<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;

$http = new Client([
    'base_uri'        => 'http://customers-svc/',
    'connect_timeout' => 1.0,  // never block forever on connect
    'timeout'         => 3.0,  // total request budget
    'http_errors'     => false,
]);

$res = $http->get('customers/42', ['headers' => ['Accept' => 'application/json']]);
if ($res->getStatusCode() === 200) {
    $customer = json_decode((string) $res->getBody(), true);
    echo $customer['email'] . "\n";
}

Statuscodes zijn het contract

Bij REST tussen services zijn HTTP-statuscodes je foutprotocol. Behandel ze bewust:

2xx betekent succes; 4xx betekent een fout van de aanroeper (probeer niet blind opnieuw); 5xx en time-outs kunnen opnieuw worden geprobeerd.
Gebruik 409 voor conflicten, 422 voor validatie en 429 voor aanroeplimieten (respecteer Retry-After).

Opnieuw proberen bij een 400 verspilt alleen aanroepen; opnieuw proberen bij een 503 met oplopende wachttijd is correct.

<?php
function isRetryable(int $status): bool {
    return $status === 0          // timeout/connection error
        || $status === 429
        || ($status >= 500 && $status !== 501);
}
var_dump(isRetryable(503)); // true
var_dump(isRetryable(400)); // false

gRPC: contract eerst en snel

gRPC gebruikt Protocol Buffers: je definieert services en berichten in een .proto-bestand en genereert daarna sterk getypeerde client- en serverstubs. Via HTTP/2 met binaire Protobuf is het veel compacter en heeft het een lagere latentie dan JSON, en het ondersteunt gegevensstromen.

syntax = "proto3";
package customers;

service Customers {
  rpc GetCustomer (GetCustomerRequest) returns (Customer);
}

message GetCustomerRequest { string id = 1; }
message Customer {
  string id = 1;
  string email = 2;
  int32  loyalty_points = 3;
}

PHP-stubs genereren

Installeer de gRPC PHP-extensie en de protoc-plug-in en genereer daarna clientklassen vanuit de .proto. PHP kan via ext-grpc fungeren als een volwaardige gRPC-client; voor het uitvoeren van een native PHP gRPC-server heb je doorgaans Roadrunner of Swoole nodig.

pecl install grpc
composer require grpc/grpc google/protobuf

protoc --proto_path=. \
  --php_out=./generated \
  --grpc_out=./generated \
  --plugin=protoc-gen-grpc=$(which grpc_php_plugin) \
  customers.proto

Een gRPC-clientaanroep

Gegenereerde stubs leveren getypeerde verzoeken en antwoorden. Een gRPC-aanroep retourneert het bericht en een status-object — controleer altijd de statuscode voordat je het antwoord vertrouwt.

<?php
require 'vendor/autoload.php';
use Customers\CustomersClient;
use Customers\GetCustomerRequest;
use Grpc\ChannelCredentials;

$client = new CustomersClient('customers-svc:50051', [
    'credentials' => ChannelCredentials::createInsecure(),
]);

$req = (new GetCustomerRequest())->setId('42');
[$reply, $status] = $client->GetCustomer($req)->wait();

if ($status->code === \Grpc\STATUS_OK) {
    echo $reply->getEmail(), "\n";
} else {
    fwrite(STDERR, "gRPC error: {$status->details}\n");
}

Evolutie van schema's

Protobuf is gebouwd voor voorwaartse en achterwaartse compatibiliteit — als je de regels ervan respecteert:

Gebruik een veldnummer nooit opnieuw en wijzig het nooit. Voeg nieuwe velden toe met nieuwe nummers.
Markeer verwijderde velden als reserved, zodat het nummer niet opnieuw kan worden gebruikt.
Oude clients negeren onbekende velden; ontbrekende velden krijgen de standaardwaarde van hun type.

JSON/REST biedt dit niet vanzelf — je bewaakt compatibiliteit op basis van afspraken (en idealiter met een gedeeld OpenAPI-schema en contracttests).

message Customer {
  string id = 1;
  string email = 2;
  reserved 3;            // old 'loyalty_points', never reuse 3
  reserved "loyalty_points";
  string display_name = 4; // new field, safe additive change
}

Gegevensstromen

gRPC ondersteunt vier aanroeptypen; REST ondersteunt standaard alleen het eerste:

Unary — één verzoek, één antwoord.
Server streaming — één verzoek, een stroom antwoorden (bijvoorbeeld live-updates).
Client streaming — een stroom verzoeken, één antwoord (bijvoorbeeld een bulkupload).
Bidirectioneel — beide stromen gelijktijdig.

Als je gebruiksscenario push of een langdurige gegevensstroom vereist, is gRPC-streaming beter dan een REST-eindpunt periodiek opvragen.

Context en tijdslimieten doorgeven

Synchrone aanroepen vormen ketens, dus twee zaken moeten met elk verzoek meegaan: een correlatie-/trace-id voor tracering van begin tot eind en een tijdslimiet, zodat een trage eindservice niet de hele keten laat vastlopen. gRPC heeft ingebouwde tijdslimieten; bij REST boots je die na met een afnemend time-outbudget dat je doorgeeft aan volgende services.

<?php
// REST: shrink the remaining budget as the call chain deepens
function forwardHeaders(array $incoming, float $remainingMs): array {
    return [
        'X-Correlation-Id' => $incoming['X-Correlation-Id'] ?? bin2hex(random_bytes(8)),
        // downstream must finish within what's left of our budget
        'X-Timeout-Ms'     => (string) max(0, (int) $remainingMs),
    ];
}
print_r(forwardHeaders(['X-Correlation-Id' => 'trace-9'], 1500));

Tussen beide kiezen

Een praktische keuzehulp:

REST voor openbare API's en partner-API's, browserclients, eenvoudige CRUD, eenvoudig debuggen en brede cacheondersteuning.
gRPC voor interne service-aanroepen met hoge volumes en lage latentie, strikt getypeerde contracten en gegevensstromen.

Veel systemen gebruiken beide: gRPC achter de gateway tussen services en REST aan de rand voor de buitenwereld. Dwing één hulpmiddel niet om het werk van het andere te doen.

Snelle controle

Het protocol aan het gebruiksscenario koppelen.

Beantwoord dit in de interactieve les

Samenvatting

Synchrone communicatie tussen services:

REST/JSON — universeel, goed te debuggen en cachebaar; statuscodes zijn het contract; stel altijd time-outs in.
gRPC/Protobuf — contract eerst, compact, snel en geschikt voor gegevensstromen; genereer getypeerde PHP-stubs.
Bepaal op basis van status- en gRPC-codes of opnieuw proberen zinvol is; probeer nooit opnieuw bij fouten van de client.
Ontwikkel schema's additief — gebruik Protobuf-veldnummer nooit opnieuw.
REST aan de rand en gRPC tussen interne services is een veelgebruikte, solide verdeling.

Volgende stap: al deze services routeren en vinden met gateways en serviceregistratie.

Gratis beginnen

Leer PHP met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen: 49
Lessen: 195

Gratis beginnen met leren Bekijk de volledige cursus

Veelgestelde vragen

Is de les “Servicecommunicatie: REST en gRPC” gratis?

Ja — de volledige tekst van “Servicecommunicatie: REST en gRPC” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus PHP Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus PHP Academy bevat in totaal 4 lessen.

Wat leer ik in “Servicecommunicatie: REST en gRPC”?

Verbind services synchroon en efficiënt. Je oefent met PHP Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met PHP Academy te beginnen?

Ervaring vooraf is niet nodig. PHP Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.

Hoe lang duurt de les “Servicecommunicatie: REST en gRPC”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over PHP Academy?

Ja. Elke les over PHP Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

← Terug naar PHP Academy