91 lines
2.3 KiB
PHP
91 lines
2.3 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
|
|
* Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
|
|
*
|
|
* Licensed under The MIT License
|
|
* For full copyright and license information, please see the LICENSE.txt
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
|
|
* @link https://cakephp.org CakePHP(tm) Project
|
|
* @since 3.0.0
|
|
* @license https://opensource.org/licenses/mit-license.php MIT License
|
|
*/
|
|
namespace Cake\Database\Expression;
|
|
|
|
use Cake\Database\ExpressionInterface;
|
|
use Cake\Database\Query;
|
|
use Cake\Database\ValueBinder;
|
|
use Closure;
|
|
|
|
/**
|
|
* An expression object for complex ORDER BY clauses
|
|
*/
|
|
class OrderClauseExpression implements ExpressionInterface, FieldInterface
|
|
{
|
|
use FieldTrait;
|
|
|
|
/**
|
|
* The direction of sorting.
|
|
*
|
|
* @var string
|
|
*/
|
|
protected $_direction;
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param \Cake\Database\ExpressionInterface|string $field The field to order on.
|
|
* @param string $direction The direction to sort on.
|
|
*/
|
|
public function __construct($field, $direction)
|
|
{
|
|
$this->_field = $field;
|
|
$this->_direction = strtolower($direction) === 'asc' ? 'ASC' : 'DESC';
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function sql(ValueBinder $binder): string
|
|
{
|
|
/** @var \Cake\Database\ExpressionInterface|string $field */
|
|
$field = $this->_field;
|
|
if ($field instanceof Query) {
|
|
$field = sprintf('(%s)', $field->sql($binder));
|
|
} elseif ($field instanceof ExpressionInterface) {
|
|
$field = $field->sql($binder);
|
|
}
|
|
|
|
return sprintf('%s %s', $field, $this->_direction);
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function traverse(Closure $callback)
|
|
{
|
|
if ($this->_field instanceof ExpressionInterface) {
|
|
$callback($this->_field);
|
|
$this->_field->traverse($callback);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Create a deep clone of the order clause.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function __clone()
|
|
{
|
|
if ($this->_field instanceof ExpressionInterface) {
|
|
$this->_field = clone $this->_field;
|
|
}
|
|
}
|
|
}
|