官术网_书友最值得收藏!

  • Drupal 8 Module Development
  • Daniel Sipos
  • 484字
  • 2021-07-02 12:22:43

Logging for Hello World

Now that we have all the tools at our disposal, and more importantly, understand how logging works in Drupal 8, let's add some logging to our module.

There is one place where we can log an action that may prove helpful. Let's log an info message when an administrator changes the greeting message via the form we wrote. This should naturally happen in the submit handler of SalutationConfigurationForm.

If you remember my rant in the previous chapter, there is no way we should use a service statically if we can instead inject it, and we can easily inject services into our form. So, let's do this now.

First of all, FormBase already implements ContainerInjectionInterface, so we don't need to implement it in our class, as we are extending from it somewhere down the line. Second of all, the ConfigFormBase class we are directly extending already has config.factory injected, so this complicates things for us a bit—well, not really. All we need to do is copy over the constructor and create() method, add our own service, store it in a property, and pass the services the parent needs to the parent constructor call. It will look like this:

/**
* @var \Drupal\Core\Logger\LoggerChannelInterface
*/
protected $logger;

/**
* SalutationConfigurationForm constructor.
*
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
* The factory for configuration objects.
* @param \Drupal\Core\Logger\LoggerChannelInterface $logger
* The logger.
*/
public function __construct(ConfigFactoryInterface $config_factory, LoggerChannelInterface $logger) {
parent::__construct($config_factory);
$this->logger = $logger;
}

/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container) {
return new static(
$container->get('config.factory'),
$container->get('hello_world.logger.channel.hello_world')
);
}

And the relevant use statements at the top:

use Drupal\Core\Config\ConfigFactoryInterface;
use Drupal\Core\Logger\LoggerChannelInterface;
use Symfony\Component\DependencyInjection\ContainerInterface;

As you can see, we get all the services that any of the parents need, plus the one we want (the logger channel) via the create() method. Also, in our constructor, we store the channel as a property and then pass the parent arguments to the parent constructor. Now, we have our hello_world logger channel available in our configuration form class. So, let's use it.

At the end of the submitForm() method, let's add the following line:

$this->logger->info('The Hello World salutation has been changed to @message.', ['@message' => $form_state->getValue('salutation')]);

We are logging a regular information message. However, since we also want to log the message that has been set, we use the second argument, which represents an array of context values. Under the hood, the database logger will extract the context variables that start with @, !, or % with the values from the entire context array. This is done using the LogMessageParser service but we'll see more of this in a later chapter when we discuss internationalization. If you implement your own logger plugin, you will have to handle this yourself as well—but we'll see that in action soon.

And now we are done with logging a message when the salutation configuration form is saved.

主站蜘蛛池模板: 通榆县| 龙口市| 二连浩特市| 烟台市| 托克托县| 富平县| 湘潭县| 赞皇县| 平阴县| 尼勒克县| 德兴市| 永登县| 黄浦区| 湘阴县| 钟祥市| 会理县| 麟游县| 绥滨县| 锡林浩特市| 和龙市| 连城县| 灵璧县| 安溪县| 托克托县| 曲阳县| 永年县| 太保市| 石楼县| 南皮县| 曲沃县| 宁夏| 本溪市| 阿图什市| 德钦县| 福鼎市| 千阳县| 保德县| 岐山县| 平顺县| 邵阳市| 乐至县|