function SelectInterface::orderBy

Same name in other branches
  1. 9 core/lib/Drupal/Core/Database/Query/SelectInterface.php \Drupal\Core\Database\Query\SelectInterface::orderBy()
  2. 8.9.x core/lib/Drupal/Core/Database/Query/SelectInterface.php \Drupal\Core\Database\Query\SelectInterface::orderBy()
  3. 11.x core/lib/Drupal/Core/Database/Query/SelectInterface.php \Drupal\Core\Database\Query\SelectInterface::orderBy()

Orders the result set by a given field.

If called multiple times, the query will order by each specified field in the order this method is called.

If the query uses DISTINCT or GROUP BY conditions, fields or expressions that are used for the order must be selected to be compatible with some databases like PostgreSQL. The PostgreSQL driver can handle simple cases automatically but it is suggested to explicitly specify them. Additionally, when ordering on an alias, the alias must be added before orderBy() is called.

Parameters

$field: The field on which to order. The field is escaped for security so only valid field and alias names are possible. To order by an expression, add the expression with addExpression() first and then use the alias to order on.

Example:

$query->addExpression('SUBSTRING([thread], 1, (LENGTH([thread]) - 1))', 'order_field');
$query->orderBy('order_field', 'ASC');

$direction: The direction to sort. Legal values are "ASC" and "DESC". Any other value will be converted to "ASC".

Return value

$this The called object.

2 methods override SelectInterface::orderBy()
Select::orderBy in core/lib/Drupal/Core/Database/Query/Select.php
Orders the result set by a given field.
SelectExtender::orderBy in core/lib/Drupal/Core/Database/Query/SelectExtender.php
Orders the result set by a given field.

File

core/lib/Drupal/Core/Database/Query/SelectInterface.php, line 393

Class

SelectInterface
Interface definition for a Select Query object.

Namespace

Drupal\Core\Database\Query

Code

public function orderBy($field, $direction = 'ASC');

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.