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

Query: The called object.

File

core/includes/database/query.inc, line 412

Non-specific Database query code. Used by all engines.

Class

Query

Base class for query builders.

Code

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