/** * Produces a GraphQL Value AST given a PHP value. * * Optionally, a GraphQL type may be provided, which will be used to * disambiguate between value primitives. * * | PHP Value | GraphQL Value | * | ------------- | -------------------- | * | Object | Input Object | * | Assoc Array | Input Object | * | Array | List | * | Boolean | Boolean | * | String | String / Enum Value | * | Int | Int | * | Float | Int / Float | * | Mixed | Enum Value | * * @param $value * @param InputType $type * @return ObjectValue|ListValue|BooleanValue|IntValue|FloatValue|EnumValue|StringValue */ static function astFromValue($value, InputType $type) { if ($type instanceof NonNull) { // Note: we're not checking that the result is non-null. // This function is not responsible for validating the input value. return self::astFromValue($value, $type->getWrappedType()); } if ($value === null) { return null; } // 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) { $isArrayLike = is_array($value) || $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; } $fieldValue = self::astFromValue($fieldValue, $field->getType()); if ($fieldValue) { $fieldASTs[] = new ObjectField(['name' => new Name(['value' => $fieldName]), 'value' => $fieldValue]); } } 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 GraphQL Value AST given a PHP value. * * Optionally, a GraphQL type may be provided, which will be used to * disambiguate between value primitives. * * | PHP Value | GraphQL Value | * | ------------- | -------------------- | * | Object | Input Object | * | Assoc Array | Input Object | * | Array | List | * | Boolean | Boolean | * | String | String / Enum Value | * | Int | Int | * | Float | Int / Float | * | Mixed | Enum Value | * | null | NullValue | * * @param $value * @param InputType $type * @return ObjectValueNode|ListValueNode|BooleanValueNode|IntValueNode|FloatValueNode|EnumValueNode|StringValueNode|NullValueNode */ static function astFromValue($value, InputType $type) { if ($type instanceof NonNull) { $astValue = self::astFromValue($value, $type->getWrappedType()); if ($astValue instanceof NullValueNode) { return null; } return $astValue; } if ($value === null) { return new NullValueNode([]); } // 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) { $valuesNodes = []; foreach ($value as $item) { $itemNode = self::astFromValue($item, $itemType); if ($itemNode) { $valuesNodes[] = $itemNode; } } return new ListValueNode(['values' => $valuesNodes]); } 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(); $fieldNodes = []; 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) { $fieldNodes[] = new ObjectFieldNode(['name' => new NameNode(['value' => $fieldName]), 'value' => $fieldNode]); } } } return new ObjectValueNode(['fields' => $fieldNodes]); } // 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 BooleanValueNode(['value' => $serialized]); } if (is_int($serialized)) { return new IntValueNode(['value' => $serialized]); } if (is_float($serialized)) { if ((int) $serialized == $serialized) { return new IntValueNode(['value' => $serialized]); } return new FloatValueNode(['value' => $serialized]); } if (is_string($serialized)) { // Enum types use Enum literals. if ($type instanceof EnumType) { return new EnumValueNode(['value' => $serialized]); } // ID types can use Int literals. $asInt = (int) $serialized; if ($type instanceof IDType && (string) $asInt === $serialized) { return new IntValueNode(['value' => $serialized]); } // Use json_encode, which uses the same string encoding as GraphQL, // then remove the quotes. return new StringValueNode(['value' => substr(json_encode($serialized), 1, -1)]); } throw new InvariantViolation('Cannot convert value to AST: ' . Utils::printSafe($serialized)); }