A collection of custom scalar types for usage with https://github.com/webonyx/graphql-php
Branch: master
Clone or download

README.md

graphql-php-scalars

A collection of custom scalar types for usage with https://github.com/webonyx/graphql-php

Build Status codecov StyleCI GitHub license Packagist Packagist

Installation

composer require mll-lab/graphql-php-scalars

Usage

You can use the provided Scalars just like any other type in your schema definition. Check SchemaUsageTest for an example.

Simple Scalars

This package comes with a bunch of scalars that are ready-to-use and just work out of the box.

Email

A RFC 5321 compliant email.

Mixed

Loose type that allows any value. Be careful when passing in large Int or Float literals, as they may not be parsed correctly on the server side. Use String literals if you are dealing with really large numbers to be on the safe side.

Advanced Scalars

Regex

The Regex class allows you to define a custom scalar that validates that the given value matches a regular expression.

The quickest way to define a custom scalar is the make factory method. Just provide a name and a regular expression and you will receive a ready-to-use custom regex scalar.

<?php

use MLL\GraphQLScalars\Regex;

$hexValue = Regex::make(
    'HexValue',
    'A hexadecimal color is specified with: #RRGGBB, where RR (red), GG (green) and BB (blue) are hexadecimal integers between 00 and FF specifying the intensity of the color.',
    '/^#?([a-f0-9]{6}|[a-f0-9]{3})$/'
);

You may also define your regex scalar as a class.

<?php

use MLL\GraphQLScalars\Regex;

// The name is implicitly set through the class name here
class HexValue extends Regex
{
    /**
     * The description that is used for schema introspection.
     *
     * @var string
     */
    public $description = <<<'DESCRIPTION'
A hexadecimal color is specified with: #RRGGBB, where RR (red), GG (green) and BB (blue)
are hexadecimal integers between 00 and FF specifying the intensity of the color.
DESCRIPTION;

    public static function regex() : string
    {
        return '/^#?([a-f0-9]{6}|[a-f0-9]{3})$/';
    }
}

StringScalar

The StringScalar encapsulates all the boilerplate associated with creating a string-based Scalar type. It does the proper string checking for you and let's you focus on the minimal logic that is specific to your use case.

All you have to specify is a function that checks if the given string is valid. Use the factory method to generate an instance on the fly.

<?php

use MLL\GraphQLScalars\StringScalar;

$coolName = StringScalar::make(
    'CoolName',
    'A name that is most definitely cool.',
    function(string $name): bool {
        return in_array($name, [
           'Vladar',
           'Benedikt',
           'Christopher',
        ]);
    }
);

Or you may simply extend the class, check out the implementation of the Email scalar to see how.