roadrunner / goridge

4.5.0 2026-10-10 12:23 UTC

Requires

• php: >=8.2
• ext-json: *
• ext-sockets: *
• spiral/roadrunner: ^3.0

Requires (Dev)

• google/protobuf: ^3.22 || ^4.0 || ^5.0
• jetbrains/phpstorm-attributes: ^1.0
• rybakit/msgpack: ^0.7
• spiral/code-style: ^2.3.1
• testo/testo: ^0.10.55
• vimeo/psalm: ^6 || ^7

Suggests

• ext-msgpack: MessagePack codec support
• ext-protobuf: Protobuf codec support
• google/protobuf: (^3.22 || ^4.0 || ^5.0) Protobuf codec support
• rybakit/msgpack: (^0.7) MessagePack codec support

Replaces

• spiral/goridge: 4.5.0

MIT

• Anton Titov
• Valery Piashchynski
• Aleksei Gagarin
• Pavel Buchnev
• Maksim Smakouz
• RoadRunner Community

• rpc
• Socket
• ipc
• pipes
• msgpack
• protobuf
• golang
• Relay
• roadrunner
• goridge

Published on Packagist.org on 2026-10-10 12:23 UTC

README

High-performance PHP-to-Golang IPC bridge

Goridge is a high-performance PHP-to-Golang codec library which works over native PHP sockets and the Golang net/rpc package. The library allows you to call Go service methods from PHP with minimal footprint, structures and []byte support. The Golang part lives in roadrunner-server/goridge; the library is the transport layer of RoadRunner, a high-performance PHP application server, load-balancer and process manager written in Golang.

Get Started

Installation

composer require roadrunner/goridge

Calling a Go service

<?php

use Spiral\Goridge;
require "vendor/autoload.php";

$rpc = new Goridge\RPC\RPC(
    Goridge\Relay::create('tcp://127.0.0.1:6001')
);

//or, using factory:
$tcpRPC = Goridge\RPC\RPC::create('tcp://127.0.0.1:6001');
$unixRPC = Goridge\RPC\RPC::create('unix:///tmp/rpc.sock');
$streamRPC = Goridge\RPC\RPC::create('pipes://stdin:stdout');

echo $rpc->call("App.Hi", "Antony");

Factory applies the next format: <protocol>://<arg1>:<arg2>

More examples, including the Go server side, can be found in this directory.

Codecs

JSON is the default codec. Use withCodec() to switch to MsgpackCodec, ProtobufCodec or RawCodec from the Spiral\Goridge\RPC\Codec namespace.

Features

• no external dependencies or services, drop-in (64bit PHP version required)
• sockets over TCP or Unix (ext-sockets is required), standard pipes
• very fast (300k calls per second on Ryzen 1700X over 20 threads)
• native net/rpc integration, ability to connect to existing application(s)
• standalone protocol usage
• structured data transfer using JSON, MessagePack or Protobuf, and raw payloads
• []byte transfer, including big payloads
• asynchronous calls over a pool of relays with MultiRPC
• service, message and transport level error handling
• hackable
• works on Windows
• unix sockets powered (also on Windows)