Was sind die entsprechenden Funktionen, die ich für die HTTP-Verarbeitung verwenden sollte?

Bei Betrachtung der Funktionen, die auf der HTTP-Seite für Drupal 7 aufgeführt sind , habe ich festgestellt, dass die folgenden Funktionen in Drupal 8 nicht mehr vorhanden sind. (Die Links beziehen sich auf die Drupal 7-Dokumentationsseiten, auf denen die Links zur Drupal 8-Dokumentation für diese enthalten sind Funktionen fehlen.)

• drupal_access_denied ()
• drupal_get_query_array ()
• drupal_goto ()
• drupal_http_request ()
• drupal_not_found ()
• drupal_site_offline ()

Welche Funktionen / Methoden sollte ich stattdessen in Drupal 8 verwenden?

Dies sind die Funktionen / Methoden / Klassen, die in Drupal 8.6.x-Code verwendet werden sollten.

• drupal_access_denied()wurde von der AccessDeniedHttpException- Klasse ersetzt. Seitenrückrufe, die den Fehler "Zugriff verweigert" zurückgeben müssen, sollten einen ähnlichen Code wie den folgenden verwenden.

  // system_batch_page()
  public function batchPage(Request $request) {
    require_once $this->root . '/core/includes/batch.inc';
    $output = _batch_page($request);
    if ($output === FALSE) {
      throw new AccessDeniedHttpException();
    }
    elseif ($output instanceof Response) {
      return $output;
    }
    elseif (isset($output)) {
      $title = isset($output['#title']) ? $output['#title'] : NULL;
      $page = [
        '#type' => 'page',
        '#title' => $title,
        '#show_messages' => FALSE,
        'content' => $output,
      ];
  
      // Also inject title as a page header (if available).
      if ($title) {
        $page['header'] = [
          '#type' => 'page_title',
          '#title' => $title,
        ];
      }
      return $page;
    }
  }
  

• Stattdessen drupal_get_query_array()gibt es parse_query()(eine Funktion im GuzzleHttp\Psr7Namespace), die Teil von Guzzle ist.

• drupal_goto()wurde aus der RedirectResponseKlasse ersetzt. Seitenrückrufe, die Benutzer umleiten müssen, sollten Code verwenden, der dem folgenden ähnelt. (Beachten Sie, dass Formularübermittlungs-Handler diese Klasse nicht verwenden sollten.)

  // AddSectionController::build()
  public function build(SectionStorageInterface $section_storage, $delta, $plugin_id) {
    $section_storage
      ->insertSection($delta, new Section($plugin_id));
    $this->layoutTempstoreRepository
      ->set($section_storage);
    if ($this->isAjax()) {
      return $this->rebuildAndClose($section_storage);
    }
    else {
      $url = $section_storage->getLayoutBuilderUrl();
      return new RedirectResponse($url->setAbsolute()->toString());
    }
  }

• drupal_http_request()wurde von einem Drupal 8-Dienst ersetzt, der die ClientInterface- Schnittstelle implementiert . Drupal 8-Code sollte dem folgenden ähnlich sein.

  // system_retrieve_file()
  try {
    $data = (string) \Drupal::httpClient()->get($url)->getBody();
    $local = $managed ? file_save_data($data, $path, $replace) : file_unmanaged_save_data($data, $path, $replace);
  } catch (RequestException $exception) {
    \Drupal::messenger()->addError(t('Failed to fetch file due to error "%error"', ['%error' => $exception->getMessage()]));
    return FALSE;
  }

• drupal_not_found()wurde von der NotFoundHttpException- Klasse ersetzt. Seitenrückrufe sollten Code verwenden, der dem folgenden ähnelt.

  // BookController::bookExport()
  public function bookExport($type, NodeInterface $node) {
    $method = 'bookExport' . Container::camelize($type);
  
    // @todo Convert the custom export functionality to serializer.
    if (!method_exists($this->bookExport, $method)) {
      $this->messenger()->addStatus(t('Unknown export format.'));
      throw new NotFoundHttpException();
    }
    $exported_book = $this->bookExport->{$method}($node);
    return new Response($this->renderer->renderRoot($exported_book));
  }

• drupal_site_offline() sollte durch einen Ereignis-Abonnenten ersetzt werden, ähnlich dem folgenden.

  public static function getSubscribedEvents() {
    $events[KernelEvents::REQUEST][] = ['onKernelRequestMaintenance', 30];
    $events[KernelEvents::EXCEPTION][] = ['onKernelRequestMaintenance'];
    return $events;
  }
  
  public function onKernelRequestMaintenance(GetResponseEvent $event) {
    $request = $event->getRequest();
    $route_match = RouteMatch::createFromRequest($request);
    if ($this->maintenanceMode->applies($route_match)) {
      // Don't cache maintenance mode pages.
      \Drupal::service('page_cache_kill_switch')->trigger();
      if (!$this->maintenanceMode->exempt($this->account)) {
        // Deliver the 503 page if the site is in maintenance mode and the
        // logged in user is not allowed to bypass it.
        // If the request format is not 'html' then show default maintenance
        // mode page else show a text/plain page with maintenance message.
        if ($request->getRequestFormat() !== 'html') {
          $response = new Response($this->getSiteMaintenanceMessage(), %03, ['Content-Type' => 'text/plain']);
          $event->setResponse($response);
          return;
        }
        drupal_maintenance_theme();
        $response = $this->bareHtmlPageRenderer->renderBarePage([          '#markup' => $this->getSiteMaintenanceMessage()], $this->t('Site under maintenance'), 'maintenance_page');
        $response->setStatusCode(503);
        $event->setResponse($response);
      }
      else {
        // Display a message if the logged in user has access to the site in
        // maintenance mode. However, suppress it on the maintenance mode
        // settings page.
        if ($route_match->getRouteName() != 'system.site_maintenance_mode') {
          if ($this->account->hasPermission('administer site configuration')) {
            $this->messenger->addMessage($this
        ->t('Operating in maintenance mode. <a href=":url">Go online.</a>', [':url' => $this->urlGenerator->generate('system.site_maintenance_mode')]), 'status', FALSE);
          }
          else {
            $this->messenger->addMessage($this->t('Operating in maintenance mode.'), 'status', FALSE);
          }
        }
      }
    }
  }

  • drupal_encode_path() wurde ersetzt durch UrlHelper::encodePath()
  • drupal_get_query_parameters() wurde ersetzt durch UrlHelper::filterQueryParameters()
  • drupal_http_build_query()wurde ersetzt durch UrlHelper::buildQuery(), welches entfernt wird, sobald der Drupal-Kern mindestens PHP 5.4 erfordert http_build_query().
  • drupal_parse_url() wurde ersetzt durch UrlHelper::parse()

Beachten Sie, dass es im Vergleich zu früheren Drupal-Versionen einige wichtige Änderungen gibt. Beispielsweise wurden einige Methoden, die sich in der UrlKlasse befanden, in die Klasse verschoben UrlHelper. Einige der Guzzle-Klassen werden nicht mehr verwendet.