0 追蹤者

類別 yii\db\conditions\LikeConditionBuilder

繼承yii\db\conditions\LikeConditionBuilder
實作yii\db\ExpressionBuilderInterface
使用 Traityii\db\ExpressionBuilderTrait
子類別yii\db\cubrid\conditions\LikeConditionBuilder, yii\db\mssql\conditions\LikeConditionBuilder, yii\db\oci\conditions\LikeConditionBuilder, yii\db\sqlite\conditions\LikeConditionBuilder
自版本起可用2.0.14
原始碼 https://github.com/yiisoft/yii2/blob/master/framework/db/conditions/LikeConditionBuilder.php

LikeConditionBuilder 類別建構 yii\db\conditions\LikeCondition 的物件

受保護的屬性

隱藏繼承的屬性

屬性 類型 描述 定義於

公開方法

隱藏繼承的方法

方法 描述 定義於
__construct() ExpressionBuilderTrait 建構子。 yii\db\ExpressionBuilderTrait
build() 此方法從 $expression 建構原始 SQL,將不會額外進行跳脫或引用。 yii\db\conditions\LikeConditionBuilder

屬性詳情

隱藏繼承的屬性

$escapeCharacter 受保護的屬性

用於跳脫 LIKE 條件中特殊字元的字元。預設情況下,假定為 \

protected string|null $escapeCharacter null
$escapingReplacements 受保護的屬性

字元對應表,用於定義 LIKE 條件中的替換規則。預設情況下,設定為使用 \ 跳脫 %_\

protected array $escapingReplacements = [
    
'%' => '\%',
    
'_' => '\_',
    
'\\' => '\\\\',
]

方法詳情

隱藏繼承的方法

__construct() 公開方法

定義於: yii\db\ExpressionBuilderTrait::__construct()

ExpressionBuilderTrait 建構子。

public void __construct ( yii\db\QueryBuilder $queryBuilder )
$queryBuilder yii\db\QueryBuilder

                public function __construct(QueryBuilder $queryBuilder)
{
    $this->queryBuilder = $queryBuilder;
}

            
build() 公開方法

此方法從 $expression 建構原始 SQL,將不會額外進行跳脫或引用。

public string build ( yii\db\ExpressionInterface $expression, array &$params = [] )
$expression yii\db\ExpressionInterface|yii\db\conditions\LikeCondition

要建構的表達式。

$params array

綁定參數。

回傳 string

原始 SQL,將不會額外進行跳脫或加上引號。

                public function build(ExpressionInterface $expression, array &$params = [])
{
    $operator = strtoupper($expression->getOperator());
    $column = $expression->getColumn();
    $values = $expression->getValue();
    $escape = $expression->getEscapingReplacements();
    if ($escape === null || $escape === []) {
        $escape = $this->escapingReplacements;
    }
    list($andor, $not, $operator) = $this->parseOperator($operator);
    if (!is_array($values)) {
        $values = [$values];
    }
    if (empty($values)) {
        return $not ? '' : '0=1';
    }
    if ($column instanceof ExpressionInterface) {
        $column = $this->queryBuilder->buildExpression($column, $params);
    } elseif (is_string($column) && strpos($column, '(') === false) {
        $column = $this->queryBuilder->db->quoteColumnName($column);
    }
    $escapeSql = $this->getEscapeSql();
    $parts = [];
    foreach ($values as $value) {
        if ($value instanceof ExpressionInterface) {
            $phName = $this->queryBuilder->buildExpression($value, $params);
        } else {
            $phName = $this->queryBuilder->bindParam(empty($escape) ? $value : ('%' . strtr((string)$value, $escape) . '%'), $params);
        }
        $parts[] = "{$column} {$operator} {$phName}{$escapeSql}";
    }
    return implode($andor, $parts);
}

            
parseOperator() 受保護的方法

protected array parseOperator ( $operator )
$operator string

                protected function parseOperator($operator)
{
    if (!preg_match('/^(AND |OR |)(((NOT |))I?LIKE)/', $operator, $matches)) {
        throw new InvalidArgumentException("Invalid operator '$operator'.");
    }
    $andor = ' ' . (!empty($matches[1]) ? $matches[1] : 'AND ');
    $not = !empty($matches[3]);
    $operator = $matches[2];
    return [$andor, $not, $operator];
}