CActiveRelation

Подробности свойств

alias свойство

public string $alias;

псевдоним для таблицы, на которую ссылается эта связь. По умолчанию null, что означает, что псевдоним будет таким же, как имя связи.

joinType свойство

public string $joinType;

тип соединения. По умолчанию 'LEFT OUTER JOIN'.

on свойство

public string $on;

запрос ON. Условие, указанное здесь, будет добавлено к условию соединения с использованием оператора AND.

scopes свойство (доступно с версии 1.1.9)

public mixed $scopes;

применяемые области видимости. Может быть установлено в одно из следующих значений:

• Одиночный область: 'scopes'=>'scopeName'.
• Множественные области: 'scopes'=>массив('scopeName1','scopeName2').

through свойство (доступно начиная с v1.1.7)

public string $through;

имя отношения, которое должно использоваться в качестве моста к этому отношению. По умолчанию null, что означает, что мост не используется.

together свойство

public boolean $together;

указывает, следует ли присоединять эту таблицу к основной таблице. Если установить это свойство в false, таблица, связанная с этим отношением, будет отображаться в отдельном операторе JOIN. Если это свойство установлено в true, соответствующая таблица ВСЕГДА будет присоединена к основной таблице, независимо от того, ограничена ли основная таблица. Если это свойство не установлено, соответствующая таблица будет присоединена к основной таблице только тогда, когда основная таблица не ограничена.

with свойство

public string|array $with;

указывается, какие связанные объекты следует загружать немедленно, когда этот связанный объект загружается лениво. Более подробную информацию об этом свойстве можно найти в CActiveRecord::with().

Подробное описание методов

mergeWith() метод

public void mergeWith(array $criteria, boolean $fromScope=false)

public function mergeWith($criteria,$fromScope=false)
{
    if($criteria instanceof CDbCriteria)
        $criteria=$criteria->toArray();
    if($fromScope)
    {
        if(isset($criteria['condition']) && $this->on!==$criteria['condition'])
        {
            if($this->on==='')
                $this->on=$criteria['condition'];
            elseif($criteria['condition']!=='')
                $this->on="({$this->on}) AND ({$criteria['condition']})";
        }
        unset($criteria['condition']);
    }

    parent::mergeWith($criteria);

    if(isset($criteria['joinType']))
        $this->joinType=$criteria['joinType'];

    if(isset($criteria['on']) && $this->on!==$criteria['on'])
    {
        if($this->on==='')
            $this->on=$criteria['on'];
        elseif($criteria['on']!=='')
            $this->on="({$this->on}) AND ({$criteria['on']})";
    }

    if(isset($criteria['with']))
        $this->with=$criteria['with'];

    if(isset($criteria['alias']))
        $this->alias=$criteria['alias'];

    if(isset($criteria['together']))
        $this->together=$criteria['together'];
}

Объединяет это отношение с динамически заданными критериями.