drupal-graphql / graphql

graphql.module

<?php

/**
 * @file
 * The GraphQL module.
 */

use Drupal\graphql\Utility\StringHelper;
use Drupal\Core\Url;

define('GRAPHQL_SCALAR_PLUGIN', 'scalar');
define('GRAPHQL_FIELD_PLUGIN', 'field');
define('GRAPHQL_MUTATION_PLUGIN', 'mutation');
define('GRAPHQL_INTERFACE_PLUGIN', 'interface');
define('GRAPHQL_UNION_TYPE_PLUGIN', 'union');
define('GRAPHQL_INPUT_TYPE_PLUGIN', 'input');
define('GRAPHQL_TYPE_PLUGIN', 'type');
define('GRAPHQL_ENUM_PLUGIN', 'enum');

/**
 * Implements hook_help().
 */
function graphql_help($routeName) {
  if ($routeName !== 'help.page.graphql') {
    return;
  }

  $title = t('About');
  $description = t('
<p>This module generates and exposes a
  <a href="http://graphql.org/" target="_blank">GraphQL</a> schema for
  <a href="https://www.drupal.org/8" target="_blank">Drupal 8</a> entities,
  and allows you to expose your own custom schema in a consistent way and with
  minimal effort.</p>');

  $help = <<<EOT
<h3>$title</h3>
$description
EOT;

  return $help;
}

/**
 * Implements hook_theme().
 */
function graphql_theme() {
  return [
    'page__graphql_explorer' => [
      'render element' => 'elements',
      'base hook' => 'block',
    ],
    'page__graphql_voyager' => [
      'render element' => 'elements',
      'base hook' => 'block',
    ],
  ];
}

/**
 * Implements hook_graphql_interfaces_alter().
 *
 * Flatten the interface inheritance tree.
 */
function graphql_graphql_interfaces_alter(&$definitions) {
  $interfaces = array_map(function($definition) use ($definitions) {
    return graphql_list_interfaces($definitions, $definition);
  }, $definitions);

  foreach ($interfaces as $index => $list) {
    $definition['interfaces'] = $list;

$definition was never initialized. Although not strictly required by PHP, it is generally a good practice to add $definition = array(); before regardless.

  }
}

/**
 * Implements hook_graphql_types_alter().
 *
 * Flatten the interface inheritance tree.
 */
function graphql_graphql_types_alter(&$definitions) {
  $interfaceDefinitions = \Drupal::service('plugin.manager.graphql.interface')->getDefinitions();

  $interfaces = array_map(function($definition) use ($interfaceDefinitions) {
    return graphql_list_interfaces($interfaceDefinitions, $definition);
  }, $definitions);

  foreach ($interfaces as $index => $list) {
    $definitions[$index]['interfaces'] = $list;
  }
}

/**
 * Get a flattened list of a plugins interface inheritance tree.
 *
 * @param array $definitions
 *   The list of interface definitions.
 * @param mixed $definition
 *   A plugin definition.
 *
 * @return string[]
 *   A list of interface names.
 */
function graphql_list_interfaces(array &$definitions, $definition) {
  $parents = array_filter($definitions, function($parent) use ($definition) {
    return in_array($parent['name'], $definition['interfaces']);
  });

  $interfaces = array_reduce(array_map(function($parent) use ($definitions) {
    return graphql_list_interfaces($definitions, $parent);
  }, $parents), 'array_merge', $definition['interfaces']);

  return $interfaces;
}

/**
 * Alter the subrequest payload and add contextual data.
 */
function graphql_graphql_subrequest_alter(&$data, $requirements) {
  /** @var \Drupal\Core\Plugin\Context\ContextRepositoryInterface $repository */
  $repository = \Drupal::service('graphql.context_repository');
  $requiredContexts = array_intersect(array_keys($repository->getAvailableContexts()), $requirements);
  $runtimeContexts = $repository->getRuntimeContexts($requiredContexts);
  foreach ($requiredContexts as $contextId) {
    if (array_key_exists($contextId, $runtimeContexts)) {
      $data[$contextId] = $runtimeContexts[$contextId]->getContextValue();
    }
  }
}

/**
 * Implements hook_graphql_schema_operations().
 */
function graphql_graphql_schema_operations($pluginId, array $pluginDefinition) {

The parameter $pluginDefinition is not used and could be removed.

  $operations = [];

  if (\Drupal::currentUser()->hasPermission('use graphql explorer')) {

This code seems to be duplicated across your project.

    $operations['explorer'] = [
      'title' => 'Explorer',
      'weight' => 10,
      'url' => Url::fromRoute("graphql.explorer.$pluginId"),
    ];
  }

  if (\Drupal::currentUser()->hasPermission('use graphql voyager')) {

This code seems to be duplicated across your project.

    $operations['voyager'] = [
      'title' => 'Voyager',
      'weight' => 10,
      'url' => Url::fromRoute("graphql.voyager.$pluginId"),
    ];
  }

  return $operations;
}

/**
 * Turn a list of machine names into a camel-cased string.
 *
 * @deprecated in graphql 3.x and will be removed before 3.0-alpha6.
 *   Use \Drupal\graphql\Utility\StringHelper::camelCase() instead.
 */
function graphql_camelcase($components) {
  return StringHelper::camelCase($components);
}

/**
 * Turn a list of machine names into a property-cased string.
 *
 * @deprecated in graphql 3.x and will be removed before 3.0-alpha6.
 *   Use \Drupal\graphql\Utility\StringHelper::propCase() instead.
 */
function graphql_propcase($components) {
  return StringHelper::propCase($components);
}