Home

Awesome

<p align="center"> <a href="https://twirphp.github.io"> <picture> <source media="(prefers-color-scheme: dark)" srcset="resources/logo-dark.png"> <img alt="TwirPHP logo" src="resources/logo.png"> </picture> </a> <h1 align="center"> TwirPHP </h1> </p>

GitHub Workflow Status Twirp Version Go Report Card Composer Package

PHP port of Twitch's Twirp RPC framework

Installation

Download prebuilt binaries for the protoc plugin from the releases page.

Alternatively, you can use the following oneliner to install the plugin:

curl -Ls https://git.io/twirphp | bash -s -- -b path/to/bin

See the documentation for details.

Documentation

See the official documentation.

Development

For an optimal developer experience, it is recommended to install Nix and direnv.

Alternatively, install Go, PHP and Composer on your computer then run make deps to install the rest of the dependencies.

Install dependencies:

go mod download
composer install

If you change something in the protoc plugin, regenerate the examples:

make generate

When all coding and testing is done, please run the test suite:

make check

Security

If you discover any security related issues, please contact us at twirphp@sagikazarmark.dev.

License

The project is licensed under the MIT License.

The original Twirp library is licensed under the Apache 2.0 License.