PureBasic

CGIVariable()

Синтаксис

Result$ = CGIVariable(Name$)

Описание


Получает указанное содержимое переменной среды CGI. Когда CGI загружен, многие данные отправляются с веб-сервера в переменные среды приложения CGI.

Параметры

Name$ Имя переменной для получения содержимого. Это может быть пользовательское значение или одна из следующих констант: 
  #PB_CGI_AuthType          : Метод аутентификации, используемый веб-браузером, если использовался какой-либо  
                              метод аутентификации. Он не задан, если сценарий не защищен.
        
  #PB_CGI_ContentLength     : Используется для сценариев, получающих данные формы с помощью метода POST. 
                              Эта переменная указывает длину байт входного потока данных CGI. Это 
                              требуется для чтения данных со стандартного ввода методом POST.
        
  #PB_CGI_HeaderContentType : Сообщает тип данных, получаемых от пользователя. 
                              Это используется для сценариев, вызываемых с помощью метода POST.
                                
  #PB_CGI_DocumentRoot      : Корневой путь к домашней странице HTML для сервера.
    
  #PB_CGI_GatewayInterface  : Версия Общего Шлюзового Интерфейса (CGI). Спецификация  
                              используется для обмена данными между клиентом и сервером. 
                              Обычно это CGI / 1.1 для текущего уровня версии 1.1.
                                
  #PB_CGI_PathInfo          : Дополнительная информация о пути добавленная в конец URL-адреса, 
                              который даёт доступ к программе сценария на стороне сервера.
                                
  #PB_CGI_PathTranslated    : Переведенная версия переменной PATH_INFO, переведенная  
                              веб-сервером из виртуальной в физическую информацию о пути.
                                
  #PB_CGI_QueryString       : Эта строка содержит любую информацию, которая находится в конце пути к сценарию  
                              на стороне сервера, после вопросительного знака. Используется для возврата данных,
                              если формой использовался метод GET. Ограничения по длине QUERY_STRING. 
  
  #PB_CGI_RemoteAddr        : IP-адрес клиентского компьютера.
  
  #PB_CGI_RemoteHost        : Полное доменное имя клиентского компьютера, делающего HTTP-запрос. 
                              Это имя может быть невозможно определить, поскольку многие 
                              имена клиентских компьютеров не записываются в DNS-системе.
                              
  #PB_CGI_RemoteIdent       : Эту переменную можно использовать только на серверах поддерживающих RFC 931. 
                              Эта переменная может содержать имя пользователя клиентской машины, но она
                              предназначена для использования только в целях ведения журнала, если она доступна.
                              
  #PB_CGI_RemotePort        : Клиенты, запрашивающие порт.
  
  #PB_CGI_RemoteUser        : Если CGI-скрипт был защищен, и пользователь должен был войти в систему, чтобы получить
                              доступ к скрипту, это значение будет содержать имя пользователя для входа в систему.
                              
  #PB_CGI_RequestURI        : Путь к запрашиваемому клиентом файлу.
  
  #PB_CGI_REquestMethod     : Описывает метод запроса, используемый браузером, 
                              который обычно является GET, POST или HEAD.
                                      
  #PB_CGI_ScriptName        : Виртуальный путь исполняемого скрипта CGI.
  
  #PB_CGI_ScriptFilename    : Локальное имя файла исполняемого скрипта.
  
  #PB_CGI_ServerAdmin       : Адрес электронной почты администратора сервера. 
  
  #PB_CGI_ServerName        : Имя хоста сервера, IP-адрес или псевдоним DNS-имени, показанный как URL-адрес
                              для самостоятельной ссылки. Это не включает идентификатор протокола, 
                              такой как "HTTP:", имя компьютера или Номер порта.
                               
  #PB_CGI_ServerPort        : Номер порта, на который отправляются HTTP-запросы и ответы.
  
  #PB_CGI_ServerProtocol    : Это значение обычно представляет собой HTTP, который описывает 
                              используемый протокол между клиентским и серверным компьютерами. 
                              
  #PB_CGI_ServerSignature   : Информация о сервере, определяющая имя и версию  
                              веб-сервера и обслуживаемого порта.
                              
  #PB_CGI_ServerSoftware    : Имя и версия веб-сервера.
        
  #PB_CGI_HttpAccept        : Типы мультимедийных данных, которые может принимать браузер клиента. 
                              Эти типы данных разделяются запятыми.
                              
  #PB_CGI_HttpAcceptEncoding: Тип кодировки, который принимает браузер клиента.
  
  #PB_CGI_HttpAcceptLanguage: Язык, который принимает браузер клиента.
  
  #PB_CGI_HttpCookie        : Используется как переменная среды, которая содержит файлы cookie, 
                              связанные с доменом сервера из браузера.
                              
  #PB_CGI_HttpForwarded     : URL переадресованной страницы.
  
  #PB_CGI_HttpHost          : Имя хоста, откуда поступают запросы HTPP.
  
  #PB_CGI_HttpPragma        : Директивы Pragma HTTP.
  
  #PB_CGI_HttpReferer       : Адрес страницы, на которой возник HTTP-запрос.
  
  #PB_CGI_HttpUserAgent     : Имя клиентского веб-браузера, используемое для выполнения запроса.

Возвращаемое значение

Возвращает значение указанной переменной среды CGI.

Пример

  If Not InitCGI() Or Not ReadCGI()
    End
  EndIf
  
  WriteCGIHeader(#PB_CGI_HeaderContentType, "text/html", #PB_CGI_LastHeader) ; Запишем заголовки, чтобы сообщить браузеру о формате содержимого
  
  WriteCGIString("<html><title>PureBasic - variables</title><body>")  
  
  Procedure WriteCGIConstant(Constant$)
    WriteCGIString(Constant$ + ": " + CGIVariable(Constant$)+"<br>")
  EndProcedure
  
  WriteCGIConstant(#PB_CGI_AuthType)
  WriteCGIConstant(#PB_CGI_ContentLength)
  WriteCGIConstant(#PB_CGI_HeaderContentType)
  WriteCGIConstant(#PB_CGI_DocumentRoot)
  WriteCGIConstant(#PB_CGI_GatewayInterface)
  WriteCGIConstant(#PB_CGI_PathInfo)
  WriteCGIConstant(#PB_CGI_PathTranslated)
  WriteCGIConstant(#PB_CGI_QueryString)
  WriteCGIConstant(#PB_CGI_RemoteAddr)
  WriteCGIConstant(#PB_CGI_RemoteHost)
  WriteCGIConstant(#PB_CGI_RemoteIdent)
  WriteCGIConstant(#PB_CGI_RemotePort)
  WriteCGIConstant(#PB_CGI_RemoteUser)
  WriteCGIConstant(#PB_CGI_RequestURI)
  WriteCGIConstant(#PB_CGI_RequestMethod)
  WriteCGIConstant(#PB_CGI_ScriptName)
  WriteCGIConstant(#PB_CGI_ScriptFilename)
  WriteCGIConstant(#PB_CGI_ServerAdmin)
  WriteCGIConstant(#PB_CGI_ServerName)
  WriteCGIConstant(#PB_CGI_ServerPort)
  WriteCGIConstant(#PB_CGI_ServerProtocol)
  WriteCGIConstant(#PB_CGI_ServerSignature)
  WriteCGIConstant(#PB_CGI_ServerSoftware)
  WriteCGIConstant(#PB_CGI_HttpAccept)
  WriteCGIConstant(#PB_CGI_HttpAcceptEncoding)
  WriteCGIConstant(#PB_CGI_HttpAcceptLanguage)
  WriteCGIConstant(#PB_CGI_HttpCookie)
  WriteCGIConstant(#PB_CGI_HttpForwarded)
  WriteCGIConstant(#PB_CGI_HttpHost)
  WriteCGIConstant(#PB_CGI_HttpPragma)
  WriteCGIConstant(#PB_CGI_HttpReferer)
  WriteCGIConstant(#PB_CGI_HttpUserAgent)
  
  WriteCGIString("</body></html>")

См. также

ReadCGI()

Поддерживаемые OS

Все

<- CGIParameterValue() - Оглавление CGI - CountCGICookies()->