getWrappedType()); if ($astValue instanceof NullValue) { return null; } return $astValue; } if ($value === null) { return new NullValue([]); } // Convert PHP array to GraphQL list. If the GraphQLType is a list, but // the value is not an array, convert the value using the list's item type. if ($type instanceof ListOfType) { $itemType = $type->getWrappedType(); if (is_array($value) || ($value instanceof \Traversable)) { $valuesASTs = []; foreach ($value as $item) { $itemAST = self::astFromValue($item, $itemType); if ($itemAST) { $valuesASTs[] = $itemAST; } } return new ListValue(['values' => $valuesASTs]); } return self::astFromValue($value, $itemType); } // Populate the fields of the input object by creating ASTs from each value // in the PHP object according to the fields in the input type. if ($type instanceof InputObjectType) { $isArray = is_array($value); $isArrayLike = $isArray || $value instanceof \ArrayAccess; if ($value === null || (!$isArrayLike && !is_object($value))) { return null; } $fields = $type->getFields(); $fieldASTs = []; foreach ($fields as $fieldName => $field) { if ($isArrayLike) { $fieldValue = isset($value[$fieldName]) ? $value[$fieldName] : null; } else { $fieldValue = isset($value->{$fieldName}) ? $value->{$fieldName} : null; } // Have to check additionally if key exists, since we differentiate between // "no key" and "value is null": if (null !== $fieldValue) { $fieldExists = true; } else if ($isArray) { $fieldExists = array_key_exists($fieldName, $value); } else if ($isArrayLike) { /** @var \ArrayAccess $value */ $fieldExists = $value->offsetExists($fieldName); } else { $fieldExists = property_exists($value, $fieldName); } if ($fieldExists) { $fieldNode = self::astFromValue($fieldValue, $field->getType()); if ($fieldNode) { $fieldASTs[] = new ObjectField([ 'name' => new Name(['value' => $fieldName]), 'value' => $fieldNode ]); } } } return new ObjectValue(['fields' => $fieldASTs]); } // Since value is an internally represented value, it must be serialized // to an externally represented value before converting into an AST. if ($type instanceof LeafType) { $serialized = $type->serialize($value); } else { throw new InvariantViolation("Must provide Input Type, cannot use: " . Utils::printSafe($type)); } if (null === $serialized) { return null; } // Others serialize based on their corresponding PHP scalar types. if (is_bool($serialized)) { return new BooleanValue(['value' => $serialized]); } if (is_int($serialized)) { return new IntValue(['value' => $serialized]); } if (is_float($serialized)) { if ((int) $serialized == $serialized) { return new IntValue(['value' => $serialized]); } return new FloatValue(['value' => $serialized]); } if (is_string($serialized)) { // Enum types use Enum literals. if ($type instanceof EnumType) { return new EnumValue(['value' => $serialized]); } // ID types can use Int literals. $asInt = (int) $serialized; if ($type instanceof IDType && (string) $asInt === $serialized) { return new IntValue(['value' => $serialized]); } // Use json_encode, which uses the same string encoding as GraphQL, // then remove the quotes. return new StringValue([ 'value' => substr(json_encode($serialized), 1, -1) ]); } throw new InvariantViolation('Cannot convert value to AST: ' . Utils::printSafe($serialized)); } /** * Produces a PHP value given a GraphQL Value AST. * * A GraphQL type must be provided, which will be used to interpret different * GraphQL Value literals. * * Returns `null` when the value could not be validly coerced according to * the provided type. * * | GraphQL Value | PHP Value | * | -------------------- | ------------- | * | Input Object | Assoc Array | * | List | Array | * | Boolean | Boolean | * | String | String | * | Int / Float | Int / Float | * | Enum Value | Mixed | * | Null Value | stdClass | instance of NullValue::getNullValue() * * @param $valueAST * @param InputType $type * @param null $variables * @return array|null|\stdClass * @throws \Exception */ public static function valueFromAST($valueAST, InputType $type, $variables = null) { $undefined = Utils::undefined(); if (!$valueAST) { // When there is no AST, then there is also no value. // Importantly, this is different from returning the GraphQL null value. return $undefined; } if ($type instanceof NonNull) { if ($valueAST instanceof NullValue) { // Invalid: intentionally return no value. return $undefined; } return self::valueFromAST($valueAST, $type->getWrappedType(), $variables); } if ($valueAST instanceof NullValue) { // This is explicitly returning the value null. return null; } if ($valueAST instanceof Variable) { $variableName = $valueAST->name->value; if (!$variables || !array_key_exists($variableName, $variables)) { // No valid return value. return $undefined; } // Note: we're not doing any checking that this variable is correct. We're // assuming that this query has been validated and the variable usage here // is of the correct type. return $variables[$variableName]; } if ($type instanceof ListOfType) { $itemType = $type->getWrappedType(); if ($valueAST instanceof ListValue) { $coercedValues = []; $itemASTs = $valueAST->values; foreach ($itemASTs as $itemAST) { if (self::isMissingVariable($itemAST, $variables)) { // If an array contains a missing variable, it is either coerced to // null or if the item type is non-null, it considered invalid. if ($itemType instanceof NonNull) { // Invalid: intentionally return no value. return $undefined; } $coercedValues[] = null; } else { $itemValue = self::valueFromAST($itemAST, $itemType, $variables); if ($undefined === $itemValue) { // Invalid: intentionally return no value. return $undefined; } $coercedValues[] = $itemValue; } } return $coercedValues; } $coercedValue = self::valueFromAST($valueAST, $itemType, $variables); if ($undefined === $coercedValue) { // Invalid: intentionally return no value. return $undefined; } return [$coercedValue]; } if ($type instanceof InputObjectType) { if (!$valueAST instanceof ObjectValue) { // Invalid: intentionally return no value. return $undefined; } $coercedObj = []; $fields = $type->getFields(); $fieldASTs = Utils::keyMap($valueAST->fields, function($field) {return $field->name->value;}); foreach ($fields as $field) { /** @var Value $fieldAST */ $fieldName = $field->name; $fieldAST = isset($fieldASTs[$fieldName]) ? $fieldASTs[$fieldName] : null; if (!$fieldAST || self::isMissingVariable($fieldAST->value, $variables)) { if ($field->defaultValueExists()) { $coercedObj[$fieldName] = $field->defaultValue; } else if ($field->getType() instanceof NonNull) { // Invalid: intentionally return no value. return $undefined; } continue ; } $fieldValue = self::valueFromAST($fieldAST ? $fieldAST->value : null, $field->getType(), $variables); if ($undefined === $fieldValue) { // Invalid: intentionally return no value. return $undefined; } $coercedObj[$fieldName] = $fieldValue; } return $coercedObj; } if ($type instanceof LeafType) { $parsed = $type->parseLiteral($valueAST); if (null === $parsed) { // null represent a failure to parse correctly, // in which case no value is returned. return $undefined; } return $parsed; } throw new InvariantViolation('Must be input type'); } /** * Returns true if the provided valueAST is a variable which is not defined * in the set of variables. * @param $valueAST * @param $variables * @return bool */ private static function isMissingVariable($valueAST, $variables) { return $valueAST instanceof Variable && (!$variables || !array_key_exists($valueAST->name->value, $variables)); } }