1.20.x query.inc public Query::comment($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.


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

Return value

Query: The called object.


includes/database/query.inc, line 412
Non-specific Database query code. Used by all engines.


Base class for query builders.


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