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

QueryGetData

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

string
QueryGetData(
	string site,
	int port,
	string PATH,
	string QUERY_STR,
	int &errno,
	string &errstr,
	string Method = "GET",
	string Proto = "",
	string ContentType = 'N'
);

Функция запрашивает указанный в параметрах web-адрес по протоколу HTTP. Возвращает тело (без заголовка) ответа, полученного от сервера. В случае ошибки возвращается пустая строка и устанавливаются параметры error_number и error_text.

Параметры функции

ПараметрОписание С версии
site Адрес сайта, страница которого запрашивается.
port Номер порта. Как правило - 80.
PATH Путь к запрашиваемой странице.
QUERY_STR Строка параметров запроса в стандартном формате.
errno Данный параметр является ссылкой на исходную переменную. В нее будет возвращен номер ошибки в случае ее возникновения.
errstr Данный параметр является ссылкой на исходную переменную. В нее будет возвращен текст ошибки в случае ее возникновения.
Method Метод отправки запроса удаленному серверу. Допустимые значения:
  • "GET"
  • "POST"
Необязательный параметр, по умолчанию равен GET.
3.2.7
Proto Префикс адреса сайта для работы с SSL и TLS. Допустимые значения:
  • ""
  • "ssl://"
  • "tls://"
Необязательный параметр, по умолчанию равен "" (пустой строке) - стандартное соединение.

Ваш хостинг может не поддерживать соединения, отличные от стандартного.

4.0.4
ContentType Необязательный. По умолчанию "N".7.1.6

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

<?
// Запросим с сайта центрального банка РФ курсы валют за 18 января 2005 г
$strQueryText = QueryGetData(
	"www.cbr.ru", 
	80, 
	"/scripts/XML_daily.asp", 
	"date_req=18.01.2005", 
	$error_number, 
	$error_text
	);
if (strlen($strQueryText)<=0)
{
	echo "Ошибка запроса курсов валют";
	if (intval($error_number)>0 || strlen($error_text)>0)
		echo ": (".$error_number.") ".$error_text;
	echo ". ";
}
else
{
	echo htmlspecialchars($strQueryText);
}
?>


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
1
Нина Рудзинская
Если в последнем параметре ContentType указать строку "application/json; charset=utf-8" , то данные QUERY_STR  можно передавать в формате json.
Бывает полезно при различных обменах.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх