Move all files to 2017/

This commit is contained in:
Oliver Davies 2025-09-29 22:25:17 +01:00
parent ac7370f67f
commit 2875863330
15717 changed files with 0 additions and 0 deletions

View file

@ -0,0 +1,6 @@
identity: drupal
# The default facility setting depends on the operating system, and will be
# overwritten during installation.
# @see syslog_install().
facility: 8
format: '!base_url|!timestamp|!type|!ip|!request_uri|!referer|!uid|!link|!message'

View file

@ -0,0 +1,15 @@
# Schema for the configuration files of the syslog module.
syslog.settings:
type: config_object
label: 'Syslog settings'
mapping:
identity:
type: string
label: 'Identity'
facility:
type: integer
label: 'Facility'
format:
type: string
label: 'Format'

View file

@ -0,0 +1,17 @@
id: d6_syslog_settings
label: System log configuration
migration_tags:
- Drupal 6
- Configuration
source:
plugin: variable
variables:
- syslog_identity
- syslog_facility
source_module: syslog
process:
identity: syslog_identity
facility: syslog_facility
destination:
plugin: config
config_name: syslog.settings

View file

@ -0,0 +1,19 @@
id: d7_syslog_settings
label: Syslog configuration
migration_tags:
- Drupal 7
- Configuration
source:
plugin: variable
variables:
- syslog_facility
- syslog_format
- syslog_identity
source_module: syslog
process:
facility: syslog_facility
format: syslog_format
identity: syslog_identity
destination:
plugin: config
config_name: syslog.settings

View file

@ -0,0 +1,101 @@
<?php
namespace Drupal\syslog\Logger;
use Drupal\Core\Config\ConfigFactoryInterface;
use Drupal\Core\Logger\LogMessageParserInterface;
use Drupal\Core\Logger\RfcLoggerTrait;
use Psr\Log\LoggerInterface;
/**
* Redirects logging messages to syslog.
*/
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) {
$facility = $this->config->get('facility');
$this->connectionOpened = openlog($this->config->get('identity'), LOG_NDELAY, $facility);
}
}
/**
* {@inheritdoc}
*/
public function log($level, $message, array $context = []) {
global $base_url;
// Ensure we have a connection available.
$this->openConnection();
// 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($this->config->get('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);
}
}

View file

@ -0,0 +1,7 @@
name: Syslog
type: module
description: 'Logs and records system events to syslog.'
package: Core
version: VERSION
core: 8.x
configure: system.logging_settings

View file

@ -0,0 +1,24 @@
<?php
/**
* @file
* Install, update and uninstall functions for the syslog module.
*/
/**
* Implements hook_install().
*/
function syslog_install() {
// The default facility setting depends on the operating system, so it needs
// to be set dynamically during installation.
\Drupal::configFactory()->getEditable('syslog.settings')->set('facility', defined('LOG_LOCAL0') ? LOG_LOCAL0 : LOG_USER)->save();
}
/**
* Convert syslog.settings.facility to an integer.
*/
function syslog_update_8400() {
$config = \Drupal::configFactory()->getEditable('syslog.settings');
$facility = (int) $config->get('facility');
$config->set('facility', $facility)->save(TRUE);
}

View file

@ -0,0 +1,93 @@
<?php
/**
* @file
* Redirects logging messages to syslog.
*/
use Drupal\Core\Url;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Routing\RouteMatchInterface;
/**
* Implements hook_help().
*/
function syslog_help($route_name, RouteMatchInterface $route_match) {
switch ($route_name) {
case 'help.page.syslog':
$output = '';
$output .= '<h3>' . t('About') . '</h3>';
$output .= '<p>' . t('The Syslog module logs events by sending messages to the logging facility of your web server\'s operating system. Syslog is an operating system administrative logging tool that provides valuable information for use in system management and security auditing. Most suited to medium and large sites, Syslog provides filtering tools that allow messages to be routed by type and severity. For more information, see the <a href=":syslog">online documentation for the Syslog module</a>, as well as PHP\'s documentation pages for the <a href="http://php.net/manual/function.openlog.php">openlog</a> and <a href="http://php.net/manual/function.syslog.php">syslog</a> functions.', [':syslog' => 'https://www.drupal.org/documentation/modules/syslog']) . '</p>';
$output .= '<h3>' . t('Uses') . '</h3>';
$output .= '<dl>';
$output .= '<dt>' . t('Logging for UNIX, Linux, and Mac OS X') . '</dt>';
$output .= '<dd>' . t('On UNIX, Linux, and Mac OS X, you will find the configuration in the file <em>/etc/syslog.conf</em>, or in <em>/etc/rsyslog.conf</em> or in the directory <em>/etc/rsyslog.d</em>. These files define the routing configuration. Messages can be flagged with the codes <code>LOG_LOCAL0</code> through <code>LOG_LOCAL7</code>. For information on Syslog facilities, severity levels, and how to set up <em>syslog.conf</em> or <em>rsyslog.conf</em>, see the <em>syslog.conf</em> or <em>rsyslog.conf</em> manual page on your command line.') . '</dd>';
$output .= '<dt>' . t('Logging for Microsoft Windows') . '</dt>';
$output .= '<dd>' . t('On Microsoft Windows, messages are always sent to the Event Log using the code <code>LOG_USER</code>.') . '</dd>';
$output .= '</dl>';
return $output;
}
}
/**
* Implements hook_form_FORM_ID_alter().
*/
function syslog_form_system_logging_settings_alter(&$form, FormStateInterface $form_state) {
$config = \Drupal::configFactory()->getEditable('syslog.settings');
$help = \Drupal::moduleHandler()->moduleExists('help') ? ' ' . \Drupal::l(t('More information'), new Url('help.page', ['name' => 'syslog'])) . '.' : NULL;
$form['syslog_identity'] = [
'#type' => 'textfield',
'#title' => t('Syslog identity'),
'#default_value' => $config->get('identity'),
'#description' => t('A string that will be prepended to every message logged to Syslog. If you have multiple sites logging to the same Syslog log file, a unique identity per site makes it easy to tell the log entries apart.') . $help,
];
if (defined('LOG_LOCAL0')) {
$form['syslog_facility'] = [
'#type' => 'select',
'#title' => t('Syslog facility'),
'#default_value' => $config->get('facility'),
'#options' => syslog_facility_list(),
'#description' => t('Depending on the system configuration, Syslog and other logging tools use this code to identify or filter messages from within the entire system log.') . $help,
];
}
$form['syslog_format'] = [
'#type' => 'textarea',
'#title' => t('Syslog format'),
'#default_value' => $config->get('format'),
'#description' => t('Specify the format of the syslog entry. Available variables are: <dl><dt><code>!base_url</code></dt><dd>Base URL of the site.</dd><dt><code>!timestamp</code></dt><dd>Unix timestamp of the log entry.</dd><dt><code>!type</code></dt><dd>The category to which this message belongs.</dd><dt><code>!ip</code></dt><dd>IP address of the user triggering the message.</dd><dt><code>!request_uri</code></dt><dd>The requested URI.</dd><dt><code>!referer</code></dt><dd>HTTP Referer if available.</dd><dt><code>!severity</code></dt><dd>The severity level of the event; ranges from 0 (Emergency) to 7 (Debug).</dd><dt><code>!uid</code></dt><dd>User ID.</dd><dt><code>!link</code></dt><dd>A link to associate with the message.</dd><dt><code>!message</code></dt><dd>The message to store in the log.</dd></dl>'),
];
$form['#submit'][] = 'syslog_logging_settings_submit';
}
/**
* Form submission handler for system_logging_settings().
*
* @see syslog_form_system_logging_settings_alter()
*/
function syslog_logging_settings_submit($form, FormStateInterface $form_state) {
\Drupal::configFactory()->getEditable('syslog.settings')
->set('identity', $form_state->getValue('syslog_identity'))
->set('facility', $form_state->getValue('syslog_facility'))
->set('format', $form_state->getValue('syslog_format'))
->save();
}
/**
* Lists all possible syslog facilities for UNIX/Linux.
*
* @return array
* An array of syslog facilities for UNIX/Linux.
*/
function syslog_facility_list() {
return [
LOG_LOCAL0 => 'LOG_LOCAL0',
LOG_LOCAL1 => 'LOG_LOCAL1',
LOG_LOCAL2 => 'LOG_LOCAL2',
LOG_LOCAL3 => 'LOG_LOCAL3',
LOG_LOCAL4 => 'LOG_LOCAL4',
LOG_LOCAL5 => 'LOG_LOCAL5',
LOG_LOCAL6 => 'LOG_LOCAL6',
LOG_LOCAL7 => 'LOG_LOCAL7',
];
}

View file

@ -0,0 +1,6 @@
services:
logger.syslog:
class: Drupal\syslog\Logger\SysLog
arguments: ['@config.factory', '@logger.log_message_parser']
tags:
- { name: logger }

View file

@ -0,0 +1,21 @@
<?php
namespace Drupal\syslog_test\Logger;
use Drupal\syslog\Logger\SysLog;
use Psr\Log\LoggerInterface;
/**
* Redirects logging messages to error_log.
*/
class SysLogTest extends SysLog implements LoggerInterface {
/**
* {@inheritdoc}
*/
protected function syslogWrapper($level, $entry) {
$log_path = \Drupal::service('file_system')->realpath('public://syslog.log');
error_log($entry . PHP_EOL, 3, $log_path);
}
}

View file

@ -0,0 +1,8 @@
name: 'Syslog test'
type: module
description: 'Provides a test logger for syslog module.'
package: Testing
version: VERSION
core: 8.x
dependencies:
- drupal:syslog

View file

@ -0,0 +1,7 @@
services:
logger.syslog_test:
parent: logger.syslog
class: Drupal\syslog_test\Logger\SysLogTest
arguments: ['@config.factory', '@logger.log_message_parser']
tags:
- { name: logger }

View file

@ -0,0 +1,40 @@
<?php
namespace Drupal\Tests\syslog\Functional;
use Drupal\Tests\BrowserTestBase;
/**
* Tests syslog settings.
*
* @group syslog
*/
class SyslogTest extends BrowserTestBase {
/**
* Modules to enable.
*
* @var array
*/
public static $modules = ['syslog'];
/**
* Tests the syslog settings page.
*/
public function testSettings() {
$admin_user = $this->drupalCreateUser(['administer site configuration']);
$this->drupalLogin($admin_user);
// If we're on Windows, there is no configuration form.
if (defined('LOG_LOCAL6')) {
$this->drupalPostForm('admin/config/development/logging', ['syslog_facility' => LOG_LOCAL6], t('Save configuration'));
$this->assertText(t('The configuration options have been saved.'));
$this->drupalGet('admin/config/development/logging');
// Should be one field.
$field = $this->xpath('//option[@value=:value]', [':value' => LOG_LOCAL6]);
$this->assertSame('selected', $field[0]->getAttribute('selected'), 'Facility value saved.');
}
}
}

View file

@ -0,0 +1,40 @@
<?php
namespace Drupal\Tests\syslog\Functional\Update;
use Drupal\FunctionalTests\Update\UpdatePathTestBase;
/**
* Tests that syslog settings are properly updated during database updates.
*
* @group syslog
* @group legacy
*/
class SyslogUpdateTest extends UpdatePathTestBase {
/**
* {@inheritdoc}
*/
protected function setDatabaseDumpFiles() {
$this->databaseDumpFiles = [
__DIR__ . '/../../../../../system/tests/fixtures/update/drupal-8.filled.standard.php.gz',
];
}
/**
* Tests that syslog.settings.facility has been converted from string to int.
*
* @see syslog_update_8400()
*/
public function testSyslogSettingsFacilityDataType() {
$config = $this->config('syslog.settings');
$this->assertIdentical('128', $config->get('facility'));
// Run updates.
$this->runUpdates();
$config = $this->config('syslog.settings');
$this->assertIdentical(128, $config->get('facility'));
}
}

View file

@ -0,0 +1,40 @@
<?php
namespace Drupal\Tests\syslog\Kernel\Migrate\d6;
use Drupal\Tests\SchemaCheckTestTrait;
use Drupal\Tests\migrate_drupal\Kernel\d6\MigrateDrupal6TestBase;
/**
* Upgrade variables to syslog.settings.yml.
*
* @group migrate_drupal_6
*/
class MigrateSyslogConfigsTest extends MigrateDrupal6TestBase {
use SchemaCheckTestTrait;
/**
* {@inheritdoc}
*/
public static $modules = ['syslog'];
/**
* {@inheritdoc}
*/
protected function setUp() {
parent::setUp();
$this->executeMigration('d6_syslog_settings');
}
/**
* Tests migration of syslog variables to syslog.settings.yml.
*/
public function testSyslogSettings() {
$config = $this->config('syslog.settings');
$this->assertIdentical('drupal', $config->get('identity'));
$this->assertIdentical(128, $config->get('facility'));
$this->assertConfigSchema(\Drupal::service('config.typed'), 'syslog.settings', $config->get());
}
}

View file

@ -0,0 +1,44 @@
<?php
namespace Drupal\Tests\syslog\Kernel\Migrate\d7;
use Drupal\Tests\SchemaCheckTestTrait;
use Drupal\Tests\migrate_drupal\Kernel\d7\MigrateDrupal7TestBase;
/**
* Upgrade variables to syslog.settings.yml.
*
* @group syslog
*/
class MigrateSyslogConfigsTest extends MigrateDrupal7TestBase {
use SchemaCheckTestTrait;
/**
* Modules to enable.
*
* @var array
*/
public static $modules = ['syslog'];
/**
* {@inheritdoc}
*/
protected function setUp() {
parent::setUp();
$this->installConfig(static::$modules);
$this->executeMigration('d7_syslog_settings');
}
/**
* Tests migration of syslog variables to syslog.settings.yml.
*/
public function testSyslogSettings() {
$config = $this->config('syslog.settings');
// 8 == LOG_USER
$this->assertIdentical(8, $config->get('facility'));
$this->assertIdentical('!base_url|!timestamp|!type|!ip|!request_uri|!referer|!uid|!link|!message', $config->get('format'));
$this->assertIdentical('drupal', $config->get('identity'));
}
}

View file

@ -0,0 +1,78 @@
<?php
namespace Drupal\Tests\syslog\Kernel;
use Drupal\KernelTests\KernelTestBase;
use Symfony\Component\HttpFoundation\Request;
/**
* Test syslog logger functionality.
*
* @group syslog
* @coversDefaultClass \Drupal\syslog\Logger\SysLog
*/
class SyslogTest extends KernelTestBase {
public static $modules = ['syslog', 'syslog_test'];
/**
* {@inheritdoc}
*/
protected function setUp() {
parent::setUp();
$this->installConfig(['syslog']);
}
/**
* @covers ::log
*/
public function testSyslogWriting() {
$request = Request::create('/page-not-found', 'GET', [], [], [], ['REMOTE_ADDR' => '1.2.3.4']);
$request->headers->set('Referer', 'other-site');
\Drupal::requestStack()->push($request);
$user = $this->getMockBuilder('Drupal\Core\Session\AccountInterface')->getMock();
$user->method('id')->willReturn(42);
$this->container->set('current_user', $user);
\Drupal::logger('my_module')->warning('My warning message.', ['link' => '/my-link']);
$log_filename = $this->container->get('file_system')->realpath('public://syslog.log');
$logs = explode(PHP_EOL, file_get_contents($log_filename));
$log = explode('|', $logs[0]);
global $base_url;
$this->assertEquals($base_url, $log[0]);
$this->assertEquals('my_module', $log[2]);
$this->assertEquals('1.2.3.4', $log[3]);
$this->assertEquals($base_url . '/page-not-found', $log[4]);
$this->assertEquals('other-site', $log[5]);
$this->assertEquals('42', $log[6]);
$this->assertEquals('/my-link', $log[7]);
$this->assertEquals('My warning message.', $log[8]);
}
/**
* Test severity level logging.
*
* @covers ::log
*/
public function testSyslogSeverity() {
/* @var \Drupal\Core\Config\Config $config */
$config = $this->container->get('config.factory')->getEditable('syslog.settings');
$config->set('format', '!type|!message|!severity');
$config->save();
\Drupal::logger('my_module')->warning('My warning message.');
$log_filename = $this->container->get('file_system')->realpath('public://syslog.log');
$logs = explode(PHP_EOL, file_get_contents($log_filename));
$log = explode('|', $logs[0]);
$this->assertEquals('my_module', $log[0]);
$this->assertEquals('My warning message.', $log[1]);
$this->assertEquals('4', $log[2]);
}
}