final public static function Database::startLog

Starts logging a given logging key on the specified connection.

Parameters

$logging_key: The logging key to log.

$key: The database connection key for which we want to log.

Return value

Drupal\Core\Database\Log The query log object. Note that the log object does support richer methods than the few exposed through the Database class, so in some cases it may be desirable to access it directly.

See also

Drupal\Core\Database\Log

6 calls to Database::startLog()
LoggingTest::testEnableLogging in drupal/core/modules/system/lib/Drupal/system/Tests/Database/LoggingTest.php
Tests that we can log the existence of a query.
LoggingTest::testEnableMultiConnectionLogging in drupal/core/modules/system/lib/Drupal/system/Tests/Database/LoggingTest.php
Tests that we can log queries separately on different connections.
LoggingTest::testEnableMultiLogging in drupal/core/modules/system/lib/Drupal/system/Tests/Database/LoggingTest.php
Tests that we can run two logs in parallel.
LoggingTest::testEnableTargetLogging in drupal/core/modules/system/lib/Drupal/system/Tests/Database/LoggingTest.php
Tests logging queries against multiple targets on the same connection.
LoggingTest::testEnableTargetLoggingNoTarget in drupal/core/modules/system/lib/Drupal/system/Tests/Database/LoggingTest.php
Tests that logs to separate targets utilize the same connection properly.

... See full list

File

drupal/core/lib/Drupal/Core/Database/Database.php, line 100
Definition of Drupal\Core\Database\Database

Class

Database
Primary front-controller for the database system.

Namespace

Drupal\Core\Database

Code

public static final function startLog($logging_key, $key = 'default') {
  if (empty(self::$logs[$key])) {
    self::$logs[$key] = new Log($key);

    // Every target already active for this connection key needs to have the
    // logging object associated with it.
    if (!empty(self::$connections[$key])) {
      foreach (self::$connections[$key] as $connection) {
        $connection
          ->setLogger(self::$logs[$key]);
      }
    }
  }
  self::$logs[$key]
    ->start($logging_key);
  return self::$logs[$key];
}