public function Query::comment

Adds a comment to the query.

By adding a comment to a query, you can more easily find it in your query log or the list of active queries on an SQL server. This allows for easier debugging and allows you to more easily find where a query with a performance problem is being generated.

The comment string will be sanitized to remove * / and other characters that may terminate the string early so as to avoid SQL injection attacks.

Parameters

$comment: The comment string to be inserted into the query.

Return value

Drupal\Core\Database\Query\Query The called object.

File

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

Class

Query
Base class for query builders.

Namespace

Drupal\Core\Database\Query

Code

public function comment($comment) {
  $this->comments[] = $comment;
  return $this;
}