PHPackages                             spiral/app-grpc - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. spiral/app-grpc

ActiveProject[Database &amp; ORM](/categories/database)

spiral/app-grpc
===============

Spiral Skeleton GRPC Application

v2.0.0(3y ago)358233[1 issues](https://github.com/spiral/app-grpc/issues)MITPHPPHP &gt;=8.1

Since May 24Pushed 1y ago5 watchersCompare

[ Source](https://github.com/spiral/app-grpc)[ Packagist](https://packagist.org/packages/spiral/app-grpc)[ Docs](https://spiral.dev)[ RSS](/packages/spiral-app-grpc/feed)WikiDiscussions 1.0 Synced 2d ago

READMEChangelog (10)Dependencies (5)Versions (14)Used By (0)

Warning

The repository is deprecated in favor of [`spiral/app`](https://github.com/spiral/app).
=======================================================================================

[](#the-repository-is-deprecated-in-favor-of-spiralapp)

Details[![Spiral Framework](https://user-images.githubusercontent.com/2461257/112313394-d926c580-8cb8-11eb-84ea-717df4e4d167.png)](https://user-images.githubusercontent.com/2461257/112313394-d926c580-8cb8-11eb-84ea-717df4e4d167.png)

Spiral GRPC Application Skeleton [![Latest Stable Version](https://camo.githubusercontent.com/a8c12da41272947862c6aff3326c14374c323feff8183e74ac37247b16ce6a7d/68747470733a2f2f706f7365722e707567782e6f72672f73706972616c2f6170702d677270632f76657273696f6e)](https://packagist.org/packages/spiral/app-grpc)
=============================================================================================================================================================================================================================================================================================================

[](#spiral-grpc-application-skeleton-)

Spiral Framework is a High-Performance PHP/Go Full-Stack framework and group of over sixty PSR-compatible components. The Framework execution model based on a hybrid runtime where some services (GRPC, Queue, WebSockets, etc.) handled by Application Server [RoadRunner](https://github.com/spiral/roadrunner) and the PHP code of your application stays in memory permanently (anti-memory leak tools included).

[App Skeleton](https://github.com/spiral/app) ([CLI](https://github.com/spiral/app-cli), [GRPC](https://github.com/spiral/app-grpc)) | [**Documentation**](https://spiral.dev/docs) | [Twitter](https://twitter.com/spiralphp) | [CHANGELOG](/CHANGELOG.md) | [Contributing](https://github.com/spiral/guide/blob/master/contributing.md)

Server Requirements
-------------------

[](#server-requirements)

Make sure that your server is configured with following PHP version and extensions:

- PHP 8.0+, 64bit
- **mb-string** extension
- PDO Extension with desired database drivers
- [Install](https://github.com/protocolbuffers/protobuf/tree/master/php) `protobuf-ext` to gain higher performance.

Application Bundle
------------------

[](#application-bundle)

Application bundle includes the following components:

- GRPC Server server based on [RoadRunner](https://roadrunner.dev)
- Console commands via Symfony/Console
- Queue support for AMQP, Beanstalk, Amazon SQS, in-Memory
- DBAL and migrations support
- Monolog, Dotenv
- Prometheus metrics
- [Cycle DataMapper ORM](https://github.com/cycle)

Installation
------------

[](#installation)

```
composer create-project spiral/app-grpc

```

> Application server will be downloaded automatically (`php-curl` and `php-zip` required).

Once the application is installed you can ensure that it was configured properly by executing:

```
$ php ./app.php configure

```

Running GRPC Server
-------------------

[](#running-grpc-server)

In order to run GRPC server you must specify location of server key and certificate in `.rr.yaml` file:

```
grpc:
    listen: "tcp://0.0.0.0:50051"
    proto:
        - "proto/service.proto"
    tls:
        key: "app.key"
        cert: "app.crt"
    pool:
        num_workers: 2
        supervisor:
            max_worker_memory: 100
```

To issue local certificate:

```
$ openssl req -newkey rsa:2048 -nodes -keyout app.key -x509 -days 365 -out app.crt

```

To start application server execute:

```
$ ./rr serve

```

On Windows:

```
$ rr.exe serve

```

You can test your endpoints using any GRPC client. For example using [grpcui](https://github.com/fullstorydev/grpcui):

```
$ grpcui -insecure -import-path ./proto/ -proto service.proto localhost:50051

```

> Make sure to use `-insecure` option while using a self-signed certificate.

Generating Services
-------------------

[](#generating-services)

In order to compile protobuf declarations into service code make sure to install:

- [protoc compiler](https://github.com/protocolbuffers/protobuf)
- [protoc-gen-php-grpc plugin](https://github.com/spiral/php-grpc)

To update or generate service code for your application run:

```
$ php ./app.php grpc:generate

```

Generated code will be available in `app/src/Service`. Implemented service will be automatically registered in your application.

License:
--------

[](#license)

MIT License (MIT). Please see [`LICENSE`](./LICENSE) for more information. Maintained by [Spiral Scout](https://spiralscout.com).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 75.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~160 days

Recently: every ~337 days

Total

13

Last Release

617d ago

Major Versions

v1.4.0 → v2.0.02022-08-30

PHP version history (4 changes)v1.0.0PHP &gt;=7.1

v1.0.5PHP &gt;=7.2

v1.4.0PHP &gt;=8.0

v2.0.0PHP &gt;=8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/796136?v=4)[Anton Tsitou](/maintainers/wolfy-j)[@wolfy-j](https://github.com/wolfy-j)

---

Top Contributors

[![wolfy-j](https://avatars.githubusercontent.com/u/796136?v=4)](https://github.com/wolfy-j "wolfy-j (50 commits)")[![SerafimArts](https://avatars.githubusercontent.com/u/2461257?v=4)](https://github.com/SerafimArts "SerafimArts (10 commits)")[![msmakouz](https://avatars.githubusercontent.com/u/67324318?v=4)](https://github.com/msmakouz "msmakouz (3 commits)")[![butschster](https://avatars.githubusercontent.com/u/773481?v=4)](https://github.com/butschster "butschster (2 commits)")[![roxblnfk](https://avatars.githubusercontent.com/u/4152481?v=4)](https://github.com/roxblnfk "roxblnfk (1 commits)")

---

Tags

grpcormphpphp7protobufqueueskeletonspiral

### Embed Badge

![Health badge](/badges/spiral-app-grpc/health.svg)

```
[![Health](https://phpackages.com/badges/spiral-app-grpc/health.svg)](https://phpackages.com/packages/spiral-app-grpc)
```

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb

MongoDB driver library

1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
