public function Select::addJoin in Drupal 9

Same name and namespace in other branches

8 core/lib/Drupal/Core/Database/Query/Select.php \Drupal\Core\Database\Query\Select::addJoin()

Join against another table in the database.

This method does the "hard" work of queuing up a table to be joined against. In some cases, that may include dipping into the Schema API to find the necessary fields on which to join.

Parameters

$type: The type of join. Typically one one of INNER, LEFT OUTER, and RIGHT OUTER.

$table: The table against which to join. May be a string or another SelectQuery object. If a query object is passed, it will be used as a subselect. Unless the table name starts with the database / schema name and a dot it will be prefixed.

$alias: The alias for the table. In most cases this should be the first letter of the table, or the first letter of each "word" in the table. If omitted, one will be dynamically generated.

$condition: The condition on which to join this table. If the join requires values, this clause should use a named placeholder and the value or values to insert should be passed in the 4th parameter. For the first table joined on a query, this value is ignored as the first table is taken as the base table. The token %alias can be used in this string to be replaced with the actual alias. This is useful when $alias is modified by the database system, for example, when joining the same table more than once.

$arguments: An array of arguments to replace into the $condition of this join.

Return value

The unique alias that was assigned for this table.

Overrides SelectInterface::addJoin

4 calls to Select::addJoin()

Select::innerJoin in core/lib/Drupal/Core/Database/Query/Select.php: Inner Join against another table in the database.
Select::join in core/lib/Drupal/Core/Database/Query/Select.php: Default Join against another table in the database.
Select::leftJoin in core/lib/Drupal/Core/Database/Query/Select.php: Left Outer Join against another table in the database.
Select::__construct in core/lib/Drupal/Core/Database/Query/Select.php: Constructs a Select object.

File

core/lib/Drupal/Core/Database/Query/Select.php, line 620

Class

Select: Query builder for SELECT statements.

Namespace

Drupal\Core\Database\Query

Code

public function addJoin($type, $table, $alias = NULL, $condition = NULL, $arguments = []) {
  if (empty($alias)) {
    if ($table instanceof SelectInterface) {
      $alias = 'subquery';
    }
    else {
      $alias = $table;
    }
  }
  $alias_candidate = $alias;
  $count = 2;
  while (!empty($this->tables[$alias_candidate])) {
    $alias_candidate = $alias . '_' . $count++;
  }
  $alias = $alias_candidate;
  if (is_string($condition)) {
    $condition = str_replace('%alias', $alias, $condition);
  }
  $this->tables[$alias] = [
    'join type' => $type,
    'table' => $table,
    'alias' => $alias,
    'condition' => $condition,
    'arguments' => $arguments,
  ];
  return $alias;
}

You are here