GraphQL

MonkeysLegion GraphQL adds a full GraphQL stack to the MonkeysLegion framework:

Installation

composer require monkeyscloud/monkeyslegion-graphql

The package injects itself into

composer.json → extra.monkeyslegion.providers, so your bootstrap

automatically calls MonkeysLegion\GraphQL\GraphQL::register().

Quick Start

// app/GraphQL/Types/Post.php
namespace App\GraphQL\Types;

use MonkeysLegion\GraphQL\Attribute\Type;
use GraphQL\Type\Definition\{ObjectType, Type as GQL};

#[Type]
final class Post extends ObjectType
{
    public function __construct()
    {
        parent::__construct([
            'name'   => 'Post',
            'fields' => [
                'id'    => GQL::nonNull(GQL::id()),
                'title' => GQL::string(),
                'body'  => GQL::string(),
            ],
        ]);
    }
}

// app/GraphQL/Query/PostQuery.php
namespace App\GraphQL\Query;

use MonkeysLegion\GraphQL\Attribute\Query;
use App\Repository\PostRepository;

#[Query(name: 'posts')]
final class PostQuery
{
    public function __construct(private PostRepository $repo) {}

    public function __invoke(): array
    {
        return $this->repo->findAll();
    }
}

GET /graphiql → run:

{
  posts { id title }
}

Defining Schema Elements

Example Mutation

#[Mutation(name: 'createPost')]
final class CreatePost
{
    public function __construct(private PostRepository $repo) {}

    public function __invoke(null $_, array $args): int
    {
        return $this->repo->insert($args['title'], $args['body']);
    }
}

Subscriptions

1. Start the WebSocket server (CLI, Supervisor, or systemd):

use MonkeysLegion\GraphQL\WebSocket\SubscriptionServer;

SubscriptionServer::run(
    $container->get(SubscriptionManager::class),
    $container->get(PubSubInterface::class), // default InMemoryPubSub
);

2. Define a subscription type:

#[Subscription('counter')]
class CounterSub extends ObjectType
{
    public function __construct(PubSubInterface $ps)
    {
        parent::__construct([
            'name'       => 'CounterSub',
            'fields'     => [ 'count' => ['type' => GQL::int()] ],
            'subscribe'  => fn() => $ps->subscribe('counter', fn($v)=>['count'=>$v]),
            'resolve'    => fn($root) => $root,
        ]);
    }
}

3. Publish events anywhere in your app:

$pubsub->publish('counter', $value++);

4. Client:

const ws = new WebSocket('ws://localhost:6001');
ws.onopen = () => ws.send(JSON.stringify({
  query: 'subscription { counter { count } }'
}));
ws.onmessage = e => console.log(JSON.parse(e.data));

Switching to Redis Pub/Sub

Swap the entry for PubSubInterface::class in your DI config to a Redis-backed implementation (community driver).

Add these keys to config/graphql.mlc:

playground = env("GQL_PLAYGROUND", true)
ws.port    = 6001
ws.host    = "0.0.0.0"
pubsub     = "in_memory"

MlcConfig is loaded automatically by the provider.

CLI Helpers

php vendor/bin/ml graphql:subscriptions   # start WS server
php vendor/bin/ml graphql:schema:print    # dump SDL

Troubleshooting

Roadmap

• v0.3 – DataLoader batching, per-request cache

• v0.4 – Relay cursor-based pagination helpers

• v1.0 – Federation helpers, Apollo Gateway integration

Contributing

1. git clone & composer install

2. Run tests: vendor/bin/phpunit – must stay green.

3. Follow PSR-12, add doc-blocks & tests.

4. Open PRs against main.

MIT license – happy hacking! 🐒🚀