Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. SysLog.php

class SysLog

Redirects logging messages to syslog.

Hierarchy

  • class \Drupal\syslog\Logger\SysLog implements \Psr\Log\LoggerInterface uses \Drupal\Core\Logger\RfcLoggerTrait

Expanded class hierarchy of SysLog

5 string references to 'SysLog'
d6_syslog_settings.yml in core/modules/syslog/migrations/d6_syslog_settings.yml
core/modules/syslog/migrations/d6_syslog_settings.yml
d7_syslog_settings.yml in core/modules/syslog/migrations/d7_syslog_settings.yml
core/modules/syslog/migrations/d7_syslog_settings.yml
syslog.info.yml in core/modules/syslog/syslog.info.yml
core/modules/syslog/syslog.info.yml
syslog.migrate_drupal.yml in core/modules/syslog/migrations/state/syslog.migrate_drupal.yml
core/modules/syslog/migrations/state/syslog.migrate_drupal.yml
syslog.services.yml in core/modules/syslog/syslog.services.yml
core/modules/syslog/syslog.services.yml
1 service uses SysLog
logger.syslog in core/modules/syslog/syslog.services.yml
Drupal\syslog\Logger\SysLog

File

core/modules/syslog/src/Logger/SysLog.php, line 15

Namespace

Drupal\syslog\Logger
View source
class SysLog implements LoggerInterface {
    use RfcLoggerTrait;
    
    /**
     * A configuration object containing syslog settings.
     *
     * @var \Drupal\Core\Config\Config
     */
    protected $config;
    
    /**
     * The message's placeholders parser.
     *
     * @var \Drupal\Core\Logger\LogMessageParserInterface
     */
    protected $parser;
    
    /**
     * Stores whether there is a system logger connection opened or not.
     *
     * @var bool
     */
    protected $connectionOpened = FALSE;
    
    /**
     * Constructs a SysLog object.
     *
     * @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
     *   The configuration factory object.
     * @param \Drupal\Core\Logger\LogMessageParserInterface $parser
     *   The parser to use when extracting message variables.
     */
    public function __construct(ConfigFactoryInterface $config_factory, LogMessageParserInterface $parser) {
        $this->config = $config_factory->get('syslog.settings');
        $this->parser = $parser;
    }
    
    /**
     * Opens a connection to the system logger.
     */
    protected function openConnection() {
        if (!$this->connectionOpened) {
            // Do not connect if identity or facility are not configured.
            $identity = $this->config
                ->get('identity');
            $facility = $this->config
                ->get('facility');
            if ($identity === NULL || $facility === NULL) {
                return;
            }
            $this->connectionOpened = openlog($identity, LOG_NDELAY, $facility);
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function log($level, string|\Stringable $message, array $context = []) : void {
        global $base_url;
        $format = $this->config
            ->get('format');
        // If no format is configured then a message will not be written to syslog
        // so return early. This occurs during installation of the syslog module
        // before configuration has been written.
        if (empty($format)) {
            return;
        }
        // Ensure we have a connection available.
        $this->openConnection();
        if (!$this->connectionOpened) {
            return;
        }
        // Populate the message placeholders and then replace them in the message.
        $message_placeholders = $this->parser
            ->parseMessagePlaceholders($message, $context);
        $message = empty($message_placeholders) ? $message : strtr($message, $message_placeholders);
        $entry = strtr($format, [
            '!base_url' => $base_url,
            '!timestamp' => $context['timestamp'],
            '!type' => $context['channel'],
            '!ip' => $context['ip'],
            '!request_uri' => $context['request_uri'],
            '!referer' => $context['referer'],
            '!severity' => $level,
            '!uid' => $context['uid'],
            '!link' => strip_tags($context['link']),
            '!message' => strip_tags($message),
        ]);
        $this->syslogWrapper($level, $entry);
    }
    
    /**
     * A syslog wrapper to make syslog functionality testable.
     *
     * @param int $level
     *   The syslog priority.
     * @param string $entry
     *   The message to send to syslog function.
     */
    protected function syslogWrapper($level, $entry) {
        syslog($level, $entry);
    }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
RfcLoggerTrait::alert public function
RfcLoggerTrait::critical public function
RfcLoggerTrait::debug public function
RfcLoggerTrait::emergency public function
RfcLoggerTrait::error public function
RfcLoggerTrait::info public function
RfcLoggerTrait::notice public function
RfcLoggerTrait::warning public function
SysLog::$config protected property A configuration object containing syslog settings.
SysLog::$connectionOpened protected property Stores whether there is a system logger connection opened or not.
SysLog::$parser protected property The message's placeholders parser.
SysLog::log public function Logs with an arbitrary level. Overrides RfcLoggerTrait::log
SysLog::openConnection protected function Opens a connection to the system logger.
SysLog::syslogWrapper protected function A syslog wrapper to make syslog functionality testable.
SysLog::__construct public function Constructs a SysLog object.

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal