Integracja

Drupal

Moduł dla Drupala 10.2+ i 11

Dostępna bezpłatnie Drupal 10.2+ lub 11, PHP 8.2+ drupal/dockray
Skąd wziąć Drupal.org
Instalacja
# Moduł leży w repozytorium Composera drupal.org. Jeśli projekt powstał

# z drupal/recommended-project, to repozytorium jest już wpięte -

# jeśli nie, dopnij je raz:

composer config repositories.drupal composer https://packages.drupal.org/8

composer require drupal/dockray
drush en dockray

# Klucz prywatny trzymaj poza eksportem konfiguracji, w settings.php:

#   $settings['dockray']['private_key'] = 'TWOJ_KLUCZ_PRYWATNY';
Moduł DockRay integruje się z systemem logowania Drupala i przekazuje do panelu błędy PHP, nieobsłużone wyjątki oraz wpisy o odpowiednim poziomie ważności generowane przez moduły własne i kontrybuowane. Instalacja odbywa się przez Composer i Drush, zgodnie ze standardowym procesem zarządzania modułami Drupala. Token projektu można ustawić w formularzu administracyjnym, natomiast klucz prywatny warto nadpisać w settings.php, aby nie został zapisany w eksporcie konfiguracji ani w repozytorium.

Jak tego użyć

Wyjątki integracja raportuje sama. To jest do zgłoszeń, które chcesz wysłać świadomie.

php
<?php
// Moduł podpina się pod kanał loggera, więc to, co i tak logujesz przez
// \Drupal::logger(), trafia do panelu bez żadnej dodatkowej linijki.
\Drupal::logger('commerce')->error('Zamówienie @id bez pozycji', ['@id' => $order->id()]);

// Zgłoszenie wprost - gdy masz obiekt wyjątku i nie chcesz go rzucać dalej.
try {
    $client->syncStock();
} catch (\Throwable $e) {
    \Drupal::service('dockray.hub')->captureException($e);
}

Artykuły w bazie wiedzy

Instalacja - Drupal Wymagania, instalacja i przygotowanie Drupal do bezpiecznego raportowania danych produkcyjnych. Konfiguracja - Drupal Bezpieczna konfiguracja poświadczeń, środowisk i zakresu danych raportowanych przez Drupal. Weryfikacja i typowe problemy - Drupal Kontrolowane potwierdzenie działania Drupal oraz diagnostyka najczęstszych problemów z wysyłką.