samson\activerecord\dbQuery

Complexity

Total Complexity

42

Size/Duplication

Total Lines	527
Duplicated Lines	1.52 %

Coupling/Cohesion

Components	2
Dependencies	4

Importance

Changes	23
Bugs	4	Features	13

24 Methods

Rating	Name	Duplication	Size	Complexity
A	own_limit()	0	5	1
A	own_group_by()	0	5	1
A	own_order_by()	0	5	1
A	flush()	0	17	1
A	random()	0	8	2
A	or_()	0	14	1
A	debug()	0	6	1
A	isnull()	0	4	1
A	notnull()	0	4	1
A	notempty()	0	4	1
A	like()	0	4	1
A	fieldsNew()	0	4	1
A	join()	0	8	1
A	group_by()	0	13	1
A	limit()	0	12	2
A	order_by()	0	7	1
A	add_field()	0	19	3
A	count()	0	4	1
A	innerCount()	0	4	1
C	parse()	8	59	9
A	className()	0	10	3
A	__construct()	0	5	1
A	__clone()	0	10	1
B	__call()	0	25	5

<?php 
namespace samson\activerecord;

//TODO: Написать метод ALL()
//TODO: Поддержка нескольких подключений
/**
 * Запрос для БД
 * Класс собирает в себя все необходимые параметры для 
 * формирования "правильного" запроса на самом низком уровне
 * работы с БД
 * @author Vitaly Iegorov <vitalyiegorov@gmail.com> 
 *
 */
class dbQuery extends \samsonframework\orm\Query

This class is not in CamelCase format.

{
    /**
     * Указатель на текущую группу условий с которой работает запрос
     *
     * @var Condition
     */
    public $cConditionGroup;

    /**
     * Указатель на соединение с БД
     * @var resource
     */
    public $link;

    /**
     * Указатель на группу условий для текущего объекта с которой работает запрос
     *
     * @var Condition
     */
    public $own_condition;

    /** Limiting filter for base table */
    public $own_limit;

    /** Grouping filter for base table */
    public $own_group;

    /** Sorting filter for base table */
    public $own_order;

    /** Virtual field for base table */
    public $own_virtual_fields = array();

    /** Virtual fields */
    public $virtual_fields = array();

    public $empty = false;

    /** @var bool True to show requests */
    protected $debug = false;

    /**
     * Коллекция условных групп для запроса
     * @var dbConditionGroup
     */
    public $condition;

    /**
     * Параметры ограничения результатов запроса к БД
     * @var array
     */
    public $limit  = array();

    /**
     * Параметры сортировки результатов запроса к БД
     * @var array
     */
    public $order  = array();

    /**
     * Параметры группировки результатов запроса к БД
     * @var array
     */
    public $group  = array();

    /**
     * Коллекция параметров для запроса к связанным объектам
     * @var array
     */
    public $join = array();



    /** Query handlers stack */
    protected $stack = array();

    /** Query parameters stack */
    protected $params = array();

// 	/**
// 	 * Universal handler to pass to CMSMaterial::get()	 *
// 	 * @param samson\activerecord\dbQuery $db_query Original db query object for modifiyng
// 	 *
// 	 */
// 	protected function __handler()
// 	{
// 		// Iterate handlers and run them
// 		foreach ( $this->stack as $i => $handler )
// 		{
// 			// Create handler params array with first parameter pointing to this query object			
// 			$params = array( &$this );		

// 			// Combine params with existing ones in one array
// 			$params = array_merge( $params, $this->params[ $i ] ); 			

// 			// Append this query object as first handler parameter
// 			//array_unshift( $this->params[ $i ] , & $this );			

// 			//trace($this->params[ $i ]);
// 			call_user_func_array( $handler, $params );
// 		}
// 	}

// 	/**
// 	 * Add query handler
// 	 * @param callable $callable External handler
// 	 * @return samson\activerecord\dbQuery
// 	 */
// 	public function handler( $callable )
// 	{
// 		// If normal handler is passed
// 		if( is_callable( $callable ) )
// 		{
// 			// Add handler
// 			$this->stack[] = $callable;

// 			// Get passed arguments
// 			$args = func_get_args();

// 			// Remove first argument
// 			array_shift( $args );

// 			// Add handler parameters stack
// 			$this->params[] = & $args;
// 		}
// 		else e('Cannot set CMS Query handler - function(##) does not exists', E_SAMSON_CMS_ERROR, $callable );

// 		return $this;
// 	}

    // 	/** @see idbQuery::fields() */
    // 	public function fields( $field_name, & $return_value = null )
    // 	{
    // 		// Call handlers stack
    // 		$this->_callHandlers();

    // 		// Iterate records and gather specified field
    // 		$return_value = array();
    // 		foreach ( db()->find( $this->class_name, $this ) as $record ) $return_value[] =  $record->$field_name;

    // 		// Clear this query
    // 		$this->flush();

    // 		// Method return value
    // 		$return = null;

    // 		// If return value is passed - return boolean about request results
    // 		if( func_num_args() > 1 ) $return = (is_array( $return_value ) && sizeof( $return_value ));
    // 		// Set request results as return value
    // 		else $return = & $return_value;

    // 		// Otherwise just return request results
    // 		return $return;
    // 	}

    // 	/** @see idbQuery::get() */
    // 	public function & exec( & $return_value = null)
    // 	{
    // 		// Call handlers stack
    // 		$this->_callHandlers();

    // 		// Perform DB request
    // 		$return_value = db()->find( $this->class_name, $this );

    // 		// Clear this query
    // 		$this->flush();

    // 		// Method return value
    // 		$return = null;

    // 		// If return value is passed - return boolean about request results
    // 		if( func_num_args() ) $return = (is_array( $return_value ) && sizeof( $return_value ));
    // 		// Set request results as return value
    // 		else $return = & $return_value;

    // 		// Otherwise just return request results
    // 		return $return;
    // 	}

    // 	/** @see idbQuery::first() */
    // 	public function & first( & $return_value = null)
    // 	{
    // 		// Call handlers stack
    // 		$this->_callHandlers();

    // 		// Выполним запрос к БД
    // 		$return_value = db()->find( $this->class_name, $this );

    // 		// Получим первую запись из полученного массива, если она есть
    // 		$return_value = isset( $return_value[0] ) ? $return_value[0] : null;

    // 		// Очистим запрос
    // 		$this->flush();

    // 		// Локальная переменная для возврата правильного результата
    // 		$return = null;

    // 		// Если хоть что-то передано в функцию - запишем в локальную переменную boolean значение
    // 		// которое покажет результат выполнения запроса к БД
    // 		if( func_num_args() ) $return = isset( $return_value );
    // 		// Сделаем копию полученных данных в локальную переменную
    // 		else $return = & $return_value;

    // 		// Вернем значение из локальной переменной
    // 		return $return;
    // 	}

    /** */
    public function own_limit($st, $en = NULL)

Method name "dbQuery::own_limit" is not in camel caps format

TRUE, FALSE and NULL must be lowercase; expected null, but found NULL.

    {
        $this->own_limit = array($st, $en);
        return $this;
    }

    /** */
    public function own_group_by($params)

Method name "dbQuery::own_group_by" is not in camel caps format

    {
        $this->own_group[] = $params;
        return $this;
    }

    /** */
    public function own_order_by($field, $direction = 'ASC')

Method name "dbQuery::own_order_by" is not in camel caps format

    {
        $this->own_order = array($field,$direction);
        return $this;
    }

    /** @see idbQuery::flush() */
    public function flush()
    {
        // Очистим параметры запроса
        $this->condition = new Condition();

It seems like new \samson\activerecord\Condition() of type object<samson\activerecord\Condition> is incompatible with the declared type object<samson\activerecord\dbConditionGroup> of property $condition.

The class samson\activerecord\Condition has been deprecated with message: use \samsonframework\orm\Condition

        $this->limit = array();
        $this->order = array();
        $this->group = array();
        $this->join = array();

        $this->own_condition = new Condition();

The class samson\activerecord\Condition has been deprecated with message: use \samsonframework\orm\Condition

        $this->own_group = array();
        $this->own_virtual_fields = array();
        $this->own_limit = array();
        $this->own_order = array();

        $this->cConditionGroup = &$this->condition;
    }

    /** @see idbQuery::random() */
    public function random(& $return_value = null)
    {
        // Add random ordering
        $this->order_by('', 'RAND()');

        // Correctly perform db request for multiple data
        return func_num_args() ? $this->exec($return_value) : $this->exec();
    }


    /**
     * @see idbQuery::or_()
     * @deprecated
     */
    public function or_($relation = 'OR')

Method name "dbQuery::or_" is not in camel caps format

    {
        // Получим либо переданную группу условий, либо создадим новую, потом добавим её в массив групп условий запроса
        $cond_group = new Condition($relation);

The class samson\activerecord\Condition has been deprecated with message: use \samsonframework\orm\Condition

        // Установим текущую группу условий с которой работает запрос
        $this->cConditionGroup = &$cond_group;

        // Добавим нову группу условий в коллекцию групп
        $this->condition->arguments[] = $cond_group;

        // Вернем себя для цепирования
        return $this;
    }

    /**
     * Set debug query mode
     * @param bool $value Debug status, true - active
     *
     * @return $this Chaining
     */
    public function debug($value = true)
    {
        db()->debug($this->debug = $value);

        return $this;
    }

    public function isnull($attribute)
    {
        return $this->cond($attribute, '', dbRelation::ISNULL);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

    }
    public function notnull($attribute)
    {
        return $this->cond($attribute, '', dbRelation::NOTNULL);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

    }
    public function notempty($attribute)
    {
        return $this->cond($attribute, '', dbRelation::NOT_EQUAL);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

    }
    public function like($attribute, $value = '')
    {
        return $this->cond($attribute, $value, dbRelation::LIKE);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

    }



    /** @deprecated Use self::fields() */
    public function fieldsNew($fieldName, & $return = null)

The parameter $fieldName is not used and could be removed.

The parameter $return is not used and could be removed.

    {
        return call_user_func_array(array($this, 'fields'), func_get_args());
    }

    /** @see idbQuery::join() */
    public function join($tableName, $className = null, $ignore = false)
    {
        // Добавим имя класса в коллекцию присоединения
        $this->join[] = new RelationData($this->class_name, $tableName, $className, $ignore);

        // Вернем себя для цепирования
        return $this;
    }

    /** @see idbQuery::group_by() */
    public function group_by($field)

Method name "dbQuery::group_by" is not in camel caps format

    {
        // Default grouping array
        $destination = &$this->group;

        // If this field belongs to query main class
        //if (property_exists( $this->class_name, $field )) $destination = & $this->own_group;

        $destination[] = $field;

        // Вернем себя для цепирования
        return $this;
    }

    /** @see idbQuery::limit() */
    public function limit($st, $en = NULL, $own = false)

TRUE, FALSE and NULL must be lowercase; expected null, but found NULL.

    {
        // Select base table or whole query destination
        if ($own) {
            $this->own_limit = array($st, $en);
        } else {
            $this->limit = array($st, $en);
        }

        // Вернем себя для цепирования
        return $this;
    }

    /** @see idbQuery::order_by() */
    public function order_by($field, $direction = 'ASC')

Method name "dbQuery::order_by" is not in camel caps format

    {
        $this->order[] = array($field, $direction);

        // Вернем себя для цепирования
        return $this;
    }

    /** @see idbQuery::add_field() */
    public function add_field($field, $alias = null, $own = true)

Method name "dbQuery::add_field" is not in camel caps format

    {
        // Если передан псевдоним для поля, то подставим его
        if (isset($alias)) {
            $field = $field . ' as ' . $alias;
        } else {
            $alias = $field;
        }

        // Добавим виртуальное поле
        if ($own) {
            $this->own_virtual_fields[$alias] = $field;
        } else {
            $this->virtual_fields[$alias] = $field;
        }

        // Вернем себя для цепирования
        return $this;
    }

    /** @see idbQuery::count() */
    public function count($field = '*')

The parameter $field is not used and could be removed.

    {
        return db()->count($this->class_name, $this);
    }

    /** @see idbQuery::innerCount() */
    public function innerCount($field = '*')

The parameter $field is not used and could be removed.

    {
        return db()->innerCount($this->class_name, $this);
    }

    /**	@see idbQuery::parse() */

Spaces must be used for alignment; tabs are not allowed

    public function parse($queryText, array $args = null)
    {
        // Преобразуем текст в нижний регистр
        //$query_text = mb_strtolower( $query_text, 'UTF-8' );

        // Паттерн для определения метода динамического запроса
        $sortingPattern = '
		/(?:^(?<method>find_by|find_all_by|all|first|last)_)
			|_order_by_  (?P<order>[a-zа-я0-9]+) _ (?P<order_dir>(?:asc|desc))
			|_limit_ (?P<limit_start>\d+) (?:_(?P<limit_end>\d+))?
			|_group_by_(?P<group>.+)
			|_join_ (?<join>.+)
		/iux';

        // Это внутренний счетчик для аргументов запроса для того чтобы не сбиться при их подставлении
        // в условие запроса к БД
        $argsCnt = 0;

        // Выполним первоначальный парсинг проверяющий правильность указанного метода
        // выборки данных и поиск возможных модификаторов запроса
        if (preg_match_all($sortingPattern, $queryText, $globalMatches)) {
            // Удалим все пустые группы полученные послке разпознования
            $globalMatches = array_filter_recursive($globalMatches);

            // Получим текст условий самого запроса, убрав из него все возможные модификаторы и параметры
            // и переберем только полученные группы условий запроса
            foreach (explode('_or_', str_ireplace($globalMatches[0], '', $queryText)) as $groupText) {
                // Добавим группу условий к запросу
                $this->or_('AND');

The method samson\activerecord\dbQuery::or_() has been deprecated.

                // Переберем поля которые формируют условия запроса - создание объекты-условия запроса
                foreach (explode('_and_', $groupText) as $conditionText) {
                    $this->cond($conditionText, $args[$argsCnt++]);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

                }
            }

            // Получим сортировку запроса
            if (isset($globalMatches['order'])) {
                $this->order = array($globalMatches['order'][0], $globalMatches['order_dir'][0]);
            }
            // Получим ограничения запроса
            if (isset($globalMatches['limit_start'])) {
                $this->limit = array($globalMatches['limit_start'][0], $globalMatches['limit_end'][0]);
            }
            // Получим групировку запроса
            if (isset($globalMatches['group'])) {

This code seems to be duplicated across your project.

                $this->group = explode('_and_', $globalMatches['group'][0]);
            }
            // Получим имена таблиц для "объединения" в запросе
            if (isset($globalMatches['join'])) {

This code seems to be duplicated across your project.

                foreach (explode('_and_', $globalMatches['join'][0]) as $join) {
                    $this->join($join);
                }
            }
        }

        // Вернем полученный объект-запрос
        return $this;
    }

    /**
     * Function to reconfigure dbQuery to work with multiple Entities
     *
     * @param string $className Entity name
     * @deprecated @see \samsonframework\orm\QueryInterface::entity(), full class name with namespace
     *                 should be passed.
     * @return self|string Chaining or current class name if nothing is passed
     */
    public function className($className = null)
    {
        // Old support for not full class names
        if (strpos($className, '\\') === false) {
            // Add generic namespace
            $className = '\samson\activerecord\\'.$className;
        }

        return func_num_args() > 0 ? $this->entity($className) : $this->entity();

The method entity does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

    }

    /**
     * Query constructor.
     * @param string|null $entity Entity identifier
     * @throws EntityNotFound
     */
    public function __construct($entity = null)
    {
        $this->className($entity);

The method samson\activerecord\dbQuery::className() has been deprecated with message: @see \samsonframework\orm\QueryInterface::entity(), full class name with namespace should be passed.

        $this->flush();
    }

    // Magic method after-clonning
    public function __clone()
    {
        // Remove old references
        $condition = $this->condition;
        unset($this->condition);

        // Set new one on copied values
        $this->condition = $condition;
        $this->cConditionGroup = &$this->condition;
    }

    // Магический метод для выполнения не описанных динамических методов класса
    public function __call($methodName, array $arguments)
    {
        /** @var array $matches Prepared statement matches */
        $matches = array();
        // Если этот метод поддерживается - выполним запрос к БД
        if (preg_match('/^(find_by|find_all_by|all)/iu', $methodName, $matches)) {
            return db()->find($this->class_name, $this->parse($methodName, $arguments));
        } elseif (property_exists($this->class_name, $methodName)) { // Проверим существует ли у класса заданное поле

            // Если передан аргумент - расцениваем его как аргумент запроса
            if (sizeof($arguments) > 1) {
                return $this->cond($methodName, $arguments[0], $arguments[1]);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

            } elseif (isset($arguments[0])) {
                return $this->cond($methodName, $arguments[0]);

The method cond does not exist on object<samson\activerecord\dbQuery>? Since you implemented __call, maybe consider adding a @method annotation.

            } else { // Просто игнорируем условие
                return $this;
            }
        } else { // Сообщим об ошибке разпознования метода
            return e(
                'Не возможно определить метод(##) для создания запроса к БД',
                E_SAMSON_ACTIVERECORD_ERROR,
                $methodName
            );
        }
    }
}