A simple yet powerful GraphQL query builder

Writing GraphQL queries can be a painful process. With GraphpQL query builder write PHP and get GraphQL

When finding an Hero to be his sidekick one finds himself overwhelmed with the number of Heros out there. There are all sort of Heros so lets list them all

$hero = new GraphQL\Graph('hero');
echo $hero->use('name')
    ->friends
        ->use('name')
            ->query();

will generate

{
    hero {
        name
        friends {
            name
        }
    }
}

A Hero will have many friends which can make it hard to walk through, it would be great limit the Hero's friends to 2

$hero = new GraphQL\Graph('hero');
echo $hero->use('name')
    ->friends(['first'=>2])
        ->use('name')
            ->query();

will generate

{
    hero {
        name
        friends(first: 2) {
            name
        }
    }
}

Sometimes you might need to know more about this Hero, like when you want to know a hero friends and costumes. We then need to go back in the Hero tree. For that we'll use $node->prev()

$hero = new GraphQL\Graph('hero');
echo $hero->use('name')
    ->friends(['first'=>2])
        ->use('name')
    ->prev()
    ->costumes
        ->color
        ->query();

will generate

{
    hero {
        name
        friends(first: 2) {
            name
        }
        costumes {
            color
        }
    }
}

Sometimes you don't quite know the type of hero you looking for. Maybe you looking a flying Hero, maybe a Strong Hero

$hero = new GraphQL\Graph('hero');
echo $hero->use('name')
    ->on('FlyingHero')
        ->use('hasCape')
    ->prev()
    ->on('StrongHero')
        ->use('strengthLevel)
    ->prev()
    ->friends(['first'=>2])
        ->use('name')
    ->prev()
    ->costumes
        ->color
        ->query();

Will generate

{
    hero {
        name
        ... on FlyingHero {
            hasCape
        }
        ... on StrongHero {
            strengthLevel
        }
        friends(first: 2) {
            name
        }
        costumes {
            color
        }
    }
}

After you chose your Hero and he takes you as his sidekick he will let you do some help him with some of his daily routine. He might even let you choose his costume color. How cool is that?

$mutation = new GraphQL\Mutation('changeHeroCostumeColor', ['id' => 'theHeroId', 'color'=>'red']);
echo $mutation
    ->hero
        ->use('name')
        ->costumes
            ->use('color')
            ->query();

Will generate

mutation changeHeroCostumeColor(id: 'theHeroId', color: 'red') {
    hero {
        name
        costumes {
            color
        }
    }
}