README
¶
PHP-GRPC
PHP-GRPC is an open-source (MIT) high-performance PHP GRPC server build at top of RoadRunner. Server support both PHP and Golang services running within one application.
Features:
- native Golang GRPC implementation compliant
- minimal configuration, plug-and-play model
- very fast, low footprint proxy
- simple TLS configuration
- debug tools included
- middleware and server customization support
- code generation using
protocplugin (go get github.com/spiral/php-grpc/cmd/protoc-gen-php-grpc) - transport, message, worker error management
- response error codes over php exceptions
- works on Windows
Usage:
Install rr-grpc and protoc-gen-php-grpc by building it or use pre-build binaries.
Define your service schema using proto file. You can scaffold protobuf classes and GRPC service interfaces using:
$ protoc --php_out=target-dir/ --php-grpc_out=target-dir/ sample.proto
Make sure to install protoc compiler and run
composer require spiral/php-grpcfirst
Implement needed classes and create worker.php to invoke your services.
Place .rr.yaml (or any other format supported by viper configurator) into the root of your project. You can run your application now:
$ rr-grpc serve -v -d
To reset workers state:
$ rr-grpc grpc:reset
To show workers statistics:
$ rr-grpc grpc:workers -i
See example.
You can find more details regarding server configuration at RoadRunner Wiki.
License:
MIT License (MIT). Please see LICENSE for more information. Maintained by SpiralScout.
Documentation
¶
Index ¶
- Constants
- type Config
- type Proxy
- type Service
- func (s *Service) AddListener(l func(event int, ctx interface{}))
- func (s *Service) AddOption(opt grpc.ServerOption)
- func (s *Service) AddService(r func(server *grpc.Server)) error
- func (s *Service) Init(cfg *Config, r *rpc.Service, e env.Environment) (ok bool, err error)
- func (s *Service) Serve() (err error)
- func (s *Service) Stop()
- type TLS
- type WorkerList
Constants ¶
const ID = "grpc"
ID sets public GRPC service ID for roadrunner.Container.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Config ¶
type Config struct {
// Address to listen.
Listen string
// Proto file associated with the service.
Proto string
// TLS defined authentication method (TLS for now).
TLS TLS
// Workers configures roadrunner grpc and worker pool.
Workers *roadrunner.ServerConfig
}
Config describes GRPC service configuration.
type Proxy ¶
type Proxy struct {
// contains filtered or unexported fields
}
Proxy manages GRPC/RoadRunner bridge.
func NewProxy ¶
func NewProxy(name string, metadata string, rr *roadrunner.Server) *Proxy
NewProxy creates new service proxy object.
func (*Proxy) RegisterMethod ¶
RegisterMethod registers new RPC method.
func (*Proxy) ServiceDesc ¶
func (p *Proxy) ServiceDesc() *grpc.ServiceDesc
ServiceDesc returns service description for the proxy.
type Service ¶
type Service struct {
// contains filtered or unexported fields
}
Service manages set of GPRC registerServices, options and connections.
func (*Service) AddListener ¶
AddListener attaches grpc event watcher.
func (*Service) AddOption ¶
func (s *Service) AddOption(opt grpc.ServerOption)
AddOption adds new GRPC server option. Codec and TLS options are controlled by service internally.
func (*Service) AddService ¶
AddService would be invoked after GRPC service creation.
type TLS ¶
type TLS struct {
// Key defined private server key.
Key string
// Cert is https certificate.
Cert string
}
TLS defines auth credentials.
type WorkerList ¶
WorkerList contains list of workers.
Source Files
Directories