Same name and namespace in other branches
  1. 8.9.x core/modules/system/src/MachineNameController.php \Drupal\system\MachineNameController
  2. 9 core/modules/system/src/MachineNameController.php \Drupal\system\MachineNameController

Controller routines for machine name transliteration routes.

Hierarchy

Expanded class hierarchy of MachineNameController

Deprecated

in drupal:10.2.0 and is removed from drupal:11.0.0. There is no replacement.

See also

https://www.drupal.org/node/2662330

1 file declares its use of MachineNameController
MachineNameControllerTest.php in core/modules/system/tests/src/Unit/Transliteration/MachineNameControllerTest.php

File

core/modules/system/src/MachineNameController.php, line 21

Namespace

Drupal\system
View source
class MachineNameController implements ContainerInjectionInterface {

  /**
   * The transliteration helper.
   *
   * @var \Drupal\Component\Transliteration\TransliterationInterface
   */
  protected $transliteration;

  /**
   * The token generator.
   *
   * @var \Drupal\Core\Access\CsrfTokenGenerator
   */
  protected $tokenGenerator;

  /**
   * Constructs a MachineNameController object.
   *
   * @param \Drupal\Component\Transliteration\TransliterationInterface $transliteration
   *   The transliteration helper.
   * @param \Drupal\Core\Access\CsrfTokenGenerator $token_generator
   *   The token generator.
   */
  public function __construct(TransliterationInterface $transliteration, CsrfTokenGenerator $token_generator) {
    $this->transliteration = $transliteration;
    $this->tokenGenerator = $token_generator;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    return new static($container
      ->get('transliteration'), $container
      ->get('csrf_token'));
  }

  /**
   * Transliterates a string in given language. Various postprocessing possible.
   *
   * @param \Symfony\Component\HttpFoundation\Request $request
   *   The input string and language for the transliteration.
   *   Optionally may contain the replace_pattern, replace, lowercase parameters.
   *
   * @return \Symfony\Component\HttpFoundation\JsonResponse
   *   The transliterated string.
   */
  public function transliterate(Request $request) {
    @trigger_error(__METHOD__ . '() is deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. There is no replacement. See https://www.drupal.org/node/3367037', E_USER_DEPRECATED);
    $text = $request->query
      ->get('text');
    $langcode = $request->query
      ->get('langcode');
    $replace_pattern = $request->query
      ->get('replace_pattern');
    $replace_token = $request->query
      ->get('replace_token');
    $replace = $request->query
      ->get('replace');
    $lowercase = $request->query
      ->get('lowercase');
    $transliterated = $this->transliteration
      ->transliterate($text, $langcode, '_');
    if ($lowercase) {
      $transliterated = mb_strtolower($transliterated);
    }
    if (isset($replace_pattern) && isset($replace)) {
      if (!isset($replace_token)) {
        throw new AccessDeniedHttpException("Missing 'replace_token' query parameter.");
      }
      elseif (!$this->tokenGenerator
        ->validate($replace_token, $replace_pattern)) {
        throw new AccessDeniedHttpException("Invalid 'replace_token' query parameter.");
      }

      // Quote the pattern delimiter and remove null characters to avoid the e
      // or other modifiers being injected.
      $transliterated = preg_replace('@' . strtr($replace_pattern, [
        '@' => '\\@',
        chr(0) => '',
      ]) . '@', $replace, $transliterated);
    }
    return new JsonResponse($transliterated);
  }

}

Members

Namesort descending Modifiers Type Description Overrides
MachineNameController::$tokenGenerator protected property The token generator.
MachineNameController::$transliteration protected property The transliteration helper.
MachineNameController::create public static function Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create
MachineNameController::transliterate public function Transliterates a string in given language. Various postprocessing possible.
MachineNameController::__construct public function Constructs a MachineNameController object.