func main() {
    ctx := context.Background()

    // 1. Запускаем gRPC-сервер на :50051
    go runGRPCServer()

    // 2. Запускаем REST gateway на :8080
    mux := runtime.NewServeMux()
    opts := []grpc.DialOption{grpc.WithTransportCredentials(insecure.NewCredentials())}

    if err := pb.RegisterUserServiceHandlerFromEndpoint(ctx, mux, "localhost:50051", opts); err != nil {
        log.Fatal(err)
    }

    log.Println("REST gateway on :8080, gRPC on :50051")
    log.Fatal(http.ListenAndServe(":8080", mux))
}

<?php
declare(strict_types=1);

namespace App\Controller;

use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Attribute\Route;
use User\CreateUserRequest;
use User\GetUserRequest;
use User\UserServiceClient;

#[Route('/v1/users')]
final readonly class UserController
{
    public function __construct(
        private UserServiceClient $client,
    ) {}

    #[Route('', methods: ['POST'])]
    public function create(Request $request): JsonResponse
    {
        $payload = json_decode($request->getContent(), true, flags: JSON_THROW_ON_ERROR);

        $req = (new CreateUserRequest())->setName($payload['name'] ?? '');
        [$response, $status] = $this->client->CreateUser($req)->wait();

        if ($status->code !== \Grpc\STATUS_OK) {
            return new JsonResponse(['error' => $status->details], 400);
        }
        return new JsonResponse(['id' => $response->getUser()->getId()], 201);
    }

    #[Route('/{id}', methods: ['GET'])]
    public function get(string $id): JsonResponse
    {
        $req = (new GetUserRequest())->setId($id);
        [$response, $status] = $this->client->GetUser($req)->wait();

        return match ($status->code) {
            \Grpc\STATUS_OK        => new JsonResponse([
                'id'   => $response->getUser()->getId(),
                'name' => $response->getUser()->getName(),
            ]),
            \Grpc\STATUS_NOT_FOUND => new JsonResponse(['error' => 'not found'], 404),
            default                => new JsonResponse(['error' => $status->details], 500),
        };
    }
}

В мире PHP плагина «grpc-gateway» нет - REST-фасад пишут руками. Стандартная стратегия: Symfony (или Slim) обслуживает HTTP, внутри контроллеров вызывает gRPC-stub. Это даёт полный контроль над форматом ошибок, аутентификацией и rate limiting. Symfony-контроллер выглядит так.

mux := runtime.NewServeMux(
    runtime.WithErrorHandler(customErrorHandler),
    runtime.WithMarshalerOption(runtime.MIMEWildcard, &runtime.JSONPb{}),
    runtime.WithIncomingHeaderMatcher(func(key string) (string, bool) {
        // Какие HTTP headers пробрасываем в gRPC metadata
        return runtime.DefaultHeaderMatcher(key)
    }),
)

<?php
declare(strict_types=1);

namespace App\EventListener;

use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpKernel\Event\ExceptionEvent;

#[AsEventListener]
final readonly class GrpcErrorListener
{
    public function __invoke(ExceptionEvent $event): void
    {
        $exception = $event->getThrowable();
        $event->setResponse(new JsonResponse(
            ['error' => $exception->getMessage(), 'code' => $exception->getCode()],
            $this->mapHttpStatus($exception->getCode()),
        ));
    }

    private function mapHttpStatus(int $grpcCode): int
    {
        return match ($grpcCode) {
            \Grpc\STATUS_INVALID_ARGUMENT  => 400,
            \Grpc\STATUS_UNAUTHENTICATED   => 401,
            \Grpc\STATUS_PERMISSION_DENIED => 403,
            \Grpc\STATUS_NOT_FOUND         => 404,
            \Grpc\STATUS_ALREADY_EXISTS    => 409,
            \Grpc\STATUS_UNAVAILABLE       => 503,
            default                         => 500,
        };
    }
}

В Symfony-гейте те же концерны решает стандартная инфраструктура: ExceptionListener под кастомный формат ошибок, nelmio/cors-bundle для CORS, symfony/rate-limiter для rate limit, monolog для логов. Прокидывание HTTP headers в gRPC metadata - явный код в контроллере или middleware.

OpenAPI-документация в Symfony-гейте генерируется через zircote/swagger-php с аттрибутами на контроллерах. Это даёт ту же выдачу, что и --openapiv2_out в gRPC-Gateway, но описание ведётся вручную:

<?php
declare(strict_types=1);

namespace App\Controller;

use OpenApi\Attributes as OA;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Attribute\Route;

#[OA\Info(version: '1.0.0', title: 'UserService Gateway')]
#[Route('/v1/users')]
final readonly class UserApiController
{
    #[OA\Post(
        path: '/v1/users',
        summary: 'Create user',
        requestBody: new OA\RequestBody(
            required: true,
            content: new OA\JsonContent(properties: [
                new OA\Property(property: 'name', type: 'string'),
            ]),
        ),
        responses: [
            new OA\Response(response: 201, description: 'created'),
            new OA\Response(response: 400, description: 'invalid'),
        ],
    )]
    #[Route('', methods: ['POST'])]
    public function create(Request $request): JsonResponse
    {
        // ...
        return new JsonResponse(['ok' => true], 201);
    }
}

Запуск генератора: vendor/bin/openapi src/Controller --output public/openapi.json. Файл подхватывает любой Swagger UI - получаете живую документацию.