vendor/propel/propel/src/Propel/Runtime/ActiveQuery/Criterion/BasicCriterion.php line 18

Open in your IDE?
  1. <?php
  3. /**
  4.  * MIT License. This file is part of the Propel package.
  5.  * For the full copyright and license information, please view the LICENSE
  6.  * file that was distributed with this source code.
  7.  */
  9. namespace Propel\Runtime\ActiveQuery\Criterion;
  11. use Propel\Runtime\ActiveQuery\Criteria;
  12. use Propel\Runtime\ActiveQuery\Criterion\Exception\InvalidValueException;
  14. /**
  15.  * Specialized Criterion used for traditional expressions,
  16.  * e.g. table.column = ? or table.column >= ? etc.
  17.  */
  18. class BasicCriterion extends AbstractCriterion
  19. {
  20.     /**
  21.      * @var bool
  22.      */
  23.     protected $ignoreStringCase = false;
  25.     /**
  26.      * Create a new instance.
  27.      *
  28.      * @param \Propel\Runtime\ActiveQuery\Criteria $outer The outer class (this is an "inner" class).
  29.      * @param string $column ignored
  30.      * @param string $value The condition to be added to the query string
  31.      * @param string $comparison One of Criteria::LIKE and Criteria::NOT_LIKE
  32.      */
  33.     public function __construct(Criteria $outer, $column, $value, $comparison = Criteria::EQUAL)
  34.     {
  35.         parent::__construct($outer, $column, $value, $comparison);
  36.     }
  38.     /**
  39.      * Sets ignore case.
  40.      *
  41.      * @param bool $b True if case should be ignored.
  42.      *
  43.      * @return $this A modified Criterion object.
  44.      */
  45.     public function setIgnoreCase($b)
  46.     {
  47.         $this->ignoreStringCase = (bool)$b;
  49.         return $this;
  50.     }
  52.     /**
  53.      * Is ignore case on or off?
  54.      *
  55.      * @return bool True if case is ignored.
  56.      */
  57.     public function isIgnoreCase()
  58.     {
  59.         return $this->ignoreStringCase;
  60.     }
  62.     /**
  63.      * Appends a Prepared Statement representation of the Criterion onto the buffer
  64.      *
  65.      * @param string $sb The string that will receive the Prepared Statement
  66.      * @param array $params A list to which Prepared Statement parameters will be appended
  67.      *
  68.      * @throws \Propel\Runtime\ActiveQuery\Criterion\Exception\InvalidValueException
  69.      *
  70.      * @return void
  71.      */
  72.     protected function appendPsForUniqueClauseTo(&$sb, array &$params)
  73.     {
  74.         $field = ($this->table === null) ? $this->column : $this->table . '.' . $this->column;
  75.         // NULL VALUES need special treatment because the SQL syntax is different
  76.         // i.e. table.column IS NULL rather than table.column = null
  77.         if ($this->value !== null) {
  78.             // ANSI SQL functions get inserted right into SQL (not escaped, etc.)
  79.             if ($this->value === Criteria::CURRENT_DATE || $this->value === Criteria::CURRENT_TIME || $this->value === Criteria::CURRENT_TIMESTAMP) {
  80.                 $sb .= $field . $this->comparison . $this->value;
  81.             } else {
  82.                 $params[] = ['table' => $this->realtable, 'column' => $this->column, 'value' => $this->value];
  84.                 // default case, it is a normal col = value expression; value
  85.                 // will be replaced w/ '?' and will be inserted later using PDO bindValue()
  86.                 if ($this->ignoreStringCase) {
  87.                     /** @var \Propel\Runtime\Adapter\SqlAdapterInterface $sqlAdapter */
  88.                     $sqlAdapter = $this->getAdapter();
  89.                     $sb .= $sqlAdapter->ignoreCase($field) . $this->comparison . $sqlAdapter->ignoreCase(':p' . count($params));
  90.                 } else {
  91.                     $sb .= $field . $this->comparison . ':p' . count($params);
  92.                 }
  93.             }
  94.         } else {
  95.             // value is null, which means it was either not specified or specifically
  96.             // set to null.
  97.             if ($this->comparison === Criteria::EQUAL || $this->comparison === Criteria::ISNULL) {
  98.                 $sb .= $field . Criteria::ISNULL;
  99.             } elseif ($this->comparison === Criteria::NOT_EQUAL || $this->comparison === Criteria::ISNOTNULL) {
  100.                 $sb .= $field . Criteria::ISNOTNULL;
  101.             } else {
  102.                 // for now throw an exception, because not sure how to interpret this
  103.                 throw new InvalidValueException(sprintf('Could not build SQL for expression: %s %s NULL', $field, $this->comparison));
  104.             }
  105.         }
  106.     }
  107. }