GetList

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

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

Возвращает список записей стоп-листа.

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

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

• Термин "Стоп-лист"

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

Array
(
	[DATE_START] => время с которого запись начинает действовать
	[DATE_END] => время после которого действие записи заканчивается
	[ACTIVE] => "Y" - запись активна; "N" - запись не активна
	[SAVE_STATISTIC] => "Y" - сохранять статистику по посетителю, попавшему в стоп-лист; "N" - не сохранять подобную статистику
	[IP_1] => октет 1 IP адреса
	[IP_2] => октет 2 IP адреса
	[IP_3] => октет 3 IP адреса
	[IP_4] => октет 4 IP адреса
	[MASK_1] => маска для октета 1 IP адреса
	[MASK_2] => маска для октета 2 IP адреса
	[MASK_3] => маска для октета 3 IP адреса
	[MASK_4] => маска для октета 4 IP адреса
	[USER_AGENT] => UserAgent посетителя
	[USER_AGENT_IS_NULL] => "Y" - UserAgent посетителя не задан (пустой);  "N" - UserAgent посетителя задан (значение по умолчанию)
	[URL_TO] => страница (или ее часть) на которую приходит посетитель
	[URL_FROM] => ссылающаяся страница (или ее часть), с которой приходит посетитель
	[MESSAGE] => текст сообщения которое будет выдано посетителю сайта, в случае его попадания под данную запись стоп-листа
	[MESSAGE_LID] => язык сообщения задаваемого в поле [MESSAGE]
	[URL_REDIRECT] => страница на которую необходимо перенаправить посетителя после его попадания под данную запись стоп-листа
	[COMMENTS] => административный комментарий; используется, как правило, для указания причин создания данной записи
	[TEST] => "Y" - данная запись является тестовой; "N" - данная запись не тестовая (см. метод CStopList::Check)
	[SITE_ID] => ID сайта для которого запись будет действительна; если значение не задано, то это означает что запись действительная для всех сайтов
	[LAMP] => "green" - запись активна и работает; "red" - запись не активная по каким либо причинам (возможно истек срок действия, либо снят флаг активности)
)

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

<?
// выберем записи стоп-листа с IP адресами 192.168.0.xxx
$arFilter = array(
	"IP_1" => 192,
	"IP_2" => 168,
	"IP_3" => 0
);

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

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