Документация для разработчиков
Темная тема

GetList

Описание и параметры

CDBResult
CAutoDetect::GetList(
	string &by = "s_counter",
	string &order = "desc",
	array filter = array(),
	bool &is_filtered
)

Возвращает список незнакомых UserAgent'ов. Метод анализирует список сессий, и собирает все UserAgent'ы которые не принадлежат ни одной поисковой системе и ни одному браузеру (UserAgent'ы браузеров задаются в настройках модуля "Статистика").

Параметры метода

ПараметрОписание
byПоле для сортировки. Возможные значения:
  • s_user_agent - UserAgent;
  • s_counter - количество сессий.
оrderПорядок сортировки. Возможные значения:
  • asc - по возрастанию;
  • desc - по убыванию.
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • LAST - флаг определяющий какие сессии буду анализироваться, возможные значения:
    • Y - за текущий день;
    • N - за предыдущие дни (не включая текущий).
  • USER_AGENT* - искомый UserAgent (маска, либо его часть);
  • USER_AGENT_EXACT_MATCH - если значение равно "Y", то при фильтрации по USER_AGENT будет искаться точное совпадение;
  • COUNTER1 - начальное значение интервала для поля "количество сессий";
  • COUNTER2 - конечное значение интервала для поля "количество сессий".
* - допускается сложная логика
is_filteredФлаг отфильтрованности списка UserAgent'ов. Если значение равно "true", то список был отфильтрован.

Смотрите также

Структура возвращаемой записи

Array
(
	[USER_AGENT] => UserAgent
	[COUNTER] => кол-во сессий
)

Примеры использования

<?
// выберем данные только за последний день
$arFilter = array(
	"LAST" => "Y"
);

// получим список записей
$rs = CAutoDetect::GetList(
	($by = "s_counter"),
	($order = "desc"),
	$arFilter = array(),
	$is_filtered
);

// выведем все записи
while ($ar = $rs->Fetch())
{
	echo "<pre>"; print_r($ar); echo "</pre>";    
}
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024