W3cubDocs

/Drupal 8

protected function Insert::preExecute

protected Insert::preExecute()

Preprocesses and validates the query.

Return value

bool TRUE if the validation was successful, FALSE if not.

Throws

\Drupal\Core\Database\Query\FieldsOverlapException

\Drupal\Core\Database\Query\NoFieldsException

File

core/lib/Drupal/Core/Database/Query/Insert.php, line 143

Class

Insert
General class for an abstracted INSERT query.

Namespace

Drupal\Core\Database\Query

Code

protected function preExecute() {
  // Confirm that the user did not try to specify an identical
  // field and default field.
  if (array_intersect($this->insertFields, $this->defaultFields)) {
    throw new FieldsOverlapException('You may not specify the same field to have a value and a schema-default value.');
  }

  if (!empty($this->fromQuery)) {
    // We have to assume that the used aliases match the insert fields.
    // Regular fields are added to the query before expressions, maintain the
    // same order for the insert fields.
    // This behavior can be overridden by calling fields() manually as only the
    // first call to fields() does have an effect.
    $this->fields(array_merge(array_keys($this->fromQuery->getFields()), array_keys($this->fromQuery->getExpressions())));
  }
  else {
    // Don't execute query without fields.
    if (count($this->insertFields) + count($this->defaultFields) == 0) {
      throw new NoFieldsException('There are no fields available to insert with.');
    }
  }

  // If no values have been added, silently ignore this query. This can happen
  // if values are added conditionally, so we don't want to throw an
  // exception.
  if (!isset($this->insertValues[0]) && count($this->insertFields) > 0 && empty($this->fromQuery)) {
    return FALSE;
  }
  return TRUE;
}

© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/core!lib!Drupal!Core!Database!Query!Insert.php/function/Insert::preExecute/8.1.x