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

GetList

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

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

Возвращает список хитов поисковых систем.

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

ПараметрОписание
byПоле для сортировки. Возможные значения:
оrderПорядок сортировки. Возможные значения:
  • asc - по возрастанию;
  • desc - по убыванию.
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • ID* - ID хита;
  • ID_EXACT_MATCH - если значение равно "N", то при фильтрации по ID будет искаться вхождение;
  • SEARCHER_ID* - ID поисковой системы;
  • SEARCHER_ID_EXACT_MATCH - если значение равно "N", то при фильтрации по SEARCHER_ID будет искаться вхождение;
  • URL* - адрес проиндексированной страницы;
  • URL_404 - была ли 404 ошибка на проиндексированной странице:
    • Y - была;
    • N - не была.
  • SEARCHER* - название поисковой системы;
  • SEARCHER_EXACT_MATCH - если значение равно "Y", то при фильтрации по SEARCHER будет искаться точное совпадение;
  • DATE1 - начальное значение интервала для поля "дата хита";
  • DATE2 - конечное значение интервала для поля "дата хита";
  • IP* - IP адрес поисковой системы;
  • IP_EXACT_MATCH - если значение равно "Y", то при фильтрации по IP будет искаться точное совпадение;
  • USER_AGENT* - UserAgent поисковой системы;
  • USER_AGENT_EXACT_MATCH - если значение равно "Y", то при фильтрации по USER_AGENT будет искаться точное совпадение;
  • SITE_ID* - ID сайта;
  • SITE_ID_EXACT_MATCH - если значение равно "N", то при фильтрации по SITE_ID будет искаться вхождение.
* - допускается сложная логика
is_filteredФлаг отфильтрованности результирующего списка. Если значение равно "true", то список был отфильтрован.

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

Array
(
	[ID] => ID хита
	[DATE_HIT] => дата хита
	[SEARCHER_ID] => ID поисковой системы
	[SEARCHER_NAME] => название поисковой системы
	[URL] => адрес проиндексированной страницы
	[URL_404] => [Y|N] флаг 404 ошибки на проиндексированной странице
	[IP] => IP адрес поисковой системы
	[USER_AGENT] => UserAgent поисковой системы
	[HIT_KEEP_DAYS] => индивидуально количество дней, отводимое для хранения хитов поисковой системы
	[SITE_ID] => ID сайта
)

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

<?
// отфильтруем страницы проиндексированные 
// поисковой системой #20 и #21
$arFilter = array(
	"SEARCHER_ID" => "20 | 21"
);

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

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


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