phpDocumentor http
request
[ class tree: http ] [ index: http ] [ all elements ]

Class: WindHttpRequest

Source Location: /http/request/WindHttpRequest.php

Class WindHttpRequest

Method Summary
WindHttpRequest   __construct()   初始化Request对象
string|''   getAcceptCharset()   返回客户端程序可以能够进行解码的数据编码方式
string   getAcceptLanguage()   返回客户端程序期望服务器返回哪个国家的语言文档
string   getAcceptTypes()   返回当前请求头中 Accept: 项的内容,
string|object|array   getAttribute()   根据名称获得服务器和执行环境信息
string   getBaseUrl()   获取基础URL
string   getClientIp()   返回访问IP
mixed   getCookie()   返回cookie的值
mixed   getEnv()   返回ENV的值
mixed   getGet()   获得$_GET值
string   getHeader()   获取Http头信息
string   getHostInfo()   获得主机信息,包含协议信息,主机名,访问端口信息
boolean   getIsAjaxRequest()   返回该请求是否为ajax请求
string   getPathInfo()   返回包含由客户端提供的、跟在真实脚本名称之后并且在查询语句(query string)之前的路径信息
mixed   getPost()   获取请求的表单数据
string   getProtocol()   返回请求页面时通信协议的名称和版本
mixed   getQuery()   获取请求数据
string   getRemoteHost()   返回浏览当前页面的用户的主机名
number   getRemotePort()   获得用户机器上连接到 Web 服务器所使用的端口号
mixed   getRequest()   获得用户请求的数据
string   getRequestMethod()   获得请求的方法
string   getRequestType()   获得请求类型
string   getRequestUri()   初始化请求的资源标识符
string   getScheme()   获取请求链接协议
string   getScript()   返回执行脚本名称
string   getScriptUrl()   返回当前执行脚本的绝对路径
mixed   getServer()   返回Server的值
string   getServerName()   返回当前运行脚本所在的服务器的主机名。
int   getServerPort()   返回服务端口号
mixed   getSession()   返回session的值
string   getUrlReferer()   返回浏览器发送Referer请求头
string   getUserAgent()   返回User-Agent头字段用于指定浏览器或者其他客户端程序的类型和名字
boolean   isDelete()   返回请求是否为DELETE请求类型
boolean   isGet()   返回请求是否为GET请求类型
boolean   isPost()   返回请求是否为POST请求类型
boolean   isPut()   返回请求是否为PUT请求类型
boolean   isSecure()   请求是否使用的是HTTPS安全链接
void   normalizeRequest()   初始化request对象
void   setAttribute()   设置属性数据
void   setServerPort()   设置服务端口号

[ Top ]
Methods
Constructor __construct  [line 89]

  WindHttpRequest __construct( )

初始化Request对象


API Tags:
Access:  public


[ Top ]
getAcceptCharset  [line 614]

  string|'' getAcceptCharset( )

返回客户端程序可以能够进行解码的数据编码方式

这里的编码方式通常指某种压缩方式


API Tags:
Access:  public


[ Top ]
getAcceptLanguage  [line 625]

  string getAcceptLanguage( )

返回客户端程序期望服务器返回哪个国家的语言文档

Accept-Language: en-us,zh-cn


API Tags:
Access:  public


[ Top ]
getAcceptTypes  [line 603]

  string getAcceptTypes( )

返回当前请求头中 Accept: 项的内容,

Accept头字段用于指出客户端程序能够处理的MIME类型,例如 text/html,image/*


API Tags:
Access:  public


[ Top ]
getAttribute  [line 142]

  string|object|array getAttribute( $key, [string $defaultValue = ''], string $name  )

根据名称获得服务器和执行环境信息

主要获取的依次顺序为:_attribute、$_GET、$_POST、$_COOKIE、$_REQUEST、$_ENV、$_SERVER

Parameters:
string   $name:  获取数据的key值
string   $defaultValue:  设置缺省值,当获取值失败的时候返回缺省值,默认该值为空字串
   $key: 

API Tags:
Return:  返回获得值
Access:  public


[ Top ]
getBaseUrl  [line 492]

  string getBaseUrl( [boolean $absolute = false]  )

获取基础URL

这里是去除了脚本文件以及访问参数信息的URL地址信息:

Example:
 请求: http://www.phpwind.net/example/index.php?a=test
 1]如果: $absolute = false:
 返回: example
 2]如果: $absolute = true:
 返回: http://www.phpwind.net/example

Parameters:
boolean   $absolute:  是否返回主机信息

API Tags:
Access:  public

Information Tags:
Throws:  WindException 当返回信息失败的时候抛出异常

[ Top ]
getClientIp  [line 299]

  string getClientIp( )

返回访问IP

如果获取请求IP失败,则返回0.0.0.0


API Tags:
Access:  public


[ Top ]
getCookie  [line 225]

  mixed getCookie( [string $name = null], [string $defaultValue = null]  )

返回cookie的值

如果$name=null则返回所有Cookie值

Parameters:
string   $name:  获取的变量名,如果该值为null则返回$_COOKIE数组,默认为null
string   $defaultValue:  当获取变量失败的时候返回该值,默认该值为null

API Tags:
Access:  public


[ Top ]
getEnv  [line 267]

  mixed getEnv( [string $name = null], [string $defaultValue = null]  )

返回ENV的值

如果$name为null则返回所有$_ENV的值

Parameters:
string   $name:  获取的变量名,如果该值为null则返回$_ENV数组,默认为null
string   $defaultValue:  当获取变量失败的时候返回该值,默认该值为null

API Tags:
Access:  public


[ Top ]
getGet  [line 211]

  mixed getGet( [string $name = ''], [string $defaultValue = null]  )

获得$_GET值

Parameters:
string   $name:  待获取的变量名,默认为空字串,当该值为null的时候将返回$_GET数组
string   $defaultValue:  当获取的变量不存在的时候返回该缺省值,默认值为null

API Tags:
Access:  public


[ Top ]
getHeader  [line 448]

  string getHeader( string $header, [string $default = null]  )

获取Http头信息

Parameters:
string   $header:  头部名称
string   $default:  获取失败将返回该值,默认为null

API Tags:
Access:  public


[ Top ]
getHostInfo  [line 508]

  string getHostInfo( )

获得主机信息,包含协议信息,主机名,访问端口信息

Example:
 请求: http://www.phpwind.net/example/index.php?a=test
 返回: http://www.phpwind.net/


API Tags:
Access:  public

Information Tags:
Throws:  WindException 获取主机信息失败的时候抛出异常

[ Top ]
getIsAjaxRequest  [line 333]

  boolean getIsAjaxRequest( )

返回该请求是否为ajax请求

如果是ajax请求将返回true,否则返回false


API Tags:
Access:  public


[ Top ]
getPathInfo  [line 470]

  string getPathInfo( )

返回包含由客户端提供的、跟在真实脚本名称之后并且在查询语句(query string)之前的路径信息

Example:
 请求: http://www.phpwind.net/example/index.php?a=test
 返回: a=test


API Tags:
Access:  public

Information Tags:
Throws:  WindException

[ Top ]
getPost  [line 199]

  mixed getPost( [string $name = null], [string $defaultValue = null]  )

获取请求的表单数据

从$_POST获得值

Parameters:
string   $name:  获取的变量名,默认为null,当为null的时候返回$_POST数组
string   $defaultValue:  当获取变量失败的时候返回该值,默认为null

API Tags:
Access:  public


[ Top ]
getProtocol  [line 288]

  string getProtocol( )

返回请求页面时通信协议的名称和版本


API Tags:
Access:  public


[ Top ]
getQuery  [line 186]

  mixed getQuery( [string $name = null], [ $defaultValue = null], string $default  )

获取请求数据

将从$_GET中获取数据

Parameters:
string   $name:  待获取的变量名,默认为null
string   $default:  如果获取变量失败则返回该值,默认为null
   $defaultValue: 

API Tags:
Access:  public


[ Top ]
getRemoteHost  [line 560]

  string getRemoteHost( )

返回浏览当前页面的用户的主机名

DNS 反向解析不依赖于用户的 REMOTE_ADDR


API Tags:
Access:  public


[ Top ]
getRemotePort  [line 580]

  number getRemotePort( )

获得用户机器上连接到 Web 服务器所使用的端口号


API Tags:
Access:  public


[ Top ]
getRequest  [line 170]

  mixed getRequest( [string $key = null], [mixed $defaultValue = null]  )

获得用户请求的数据

返回$_GET,$_POST的值,未设置则返回$defaultValue

Parameters:
string   $key:  获取的参数name,默认为null将获得$_GET和$_POST两个数组的所有值
mixed   $defaultValue:  当获取值失败的时候返回缺省值,默认值为null

API Tags:
Access:  public


[ Top ]
getRequestMethod  [line 311]

  string getRequestMethod( )

获得请求的方法

将返回POST\GET\DELETE等HTTP请求方式


API Tags:
Access:  public


[ Top ]
getRequestType  [line 322]

  string getRequestType( )

获得请求类型

如果是web请求将返回web


API Tags:
Access:  public


[ Top ]
getRequestUri  [line 404]

  string getRequestUri( )

初始化请求的资源标识符

这里的uri是去除协议名、主机名的

Example:
 请求: http://www.phpwind.net/example/index.php?a=test
 则返回: /example/index.php?a=test


API Tags:
Access:  public

Information Tags:
Throws:  WindException 当获取失败的时候抛出异常

[ Top ]
getScheme  [line 279]

  string getScheme( )

获取请求链接协议

如果是安全链接请求则返回https否则返回http


API Tags:
Access:  public


[ Top ]
getScript  [line 436]

  string getScript( )

返回执行脚本名称

Example:
 请求: http://www.phpwind.net/example/index.php?a=test
 返回: index.php


API Tags:
Access:  public

Information Tags:
Throws:  WindException 当获取失败的时候抛出异常

[ Top ]
getScriptUrl  [line 420]

  string getScriptUrl( )

返回当前执行脚本的绝对路径

Example:
 请求: http://www.phpwind.net/example/index.php?a=test
 返回: /example/index.php


API Tags:
Access:  public

Information Tags:
Throws:  WindException 当获取失败的时候抛出异常

[ Top ]
getServer  [line 253]

  mixed getServer( [string $name = null], [string $defaultValue = null]  )

返回Server的值

如果$name为空则返回所有Server的值

Parameters:
string   $name:  获取的变量名,如果该值为null则返回$_SERVER数组,默认为null
string   $defaultValue:  当获取变量失败的时候返回该值,默认该值为null

API Tags:
Access:  public


[ Top ]
getServerName  [line 521]

  string getServerName( )

返回当前运行脚本所在的服务器的主机名。

如果脚本运行于虚拟主机中 该名称是由那个虚拟主机所设置的值决定


API Tags:
Access:  public


[ Top ]
getServerPort  [line 533]

  int getServerPort( )

返回服务端口号

https链接的默认端口号为443 http链接的默认端口号为80


API Tags:
Access:  public


[ Top ]
getSession  [line 239]

  mixed getSession( [string $name = null], [string $defaultValue = null]  )

返回session的值

如果$name=null则返回所有SESSION值

Parameters:
string   $name:  获取的变量名,如果该值为null则返回$_SESSION数组,默认为null
string   $defaultValue:  当获取变量失败的时候返回该值,默认该值为null

API Tags:
Access:  public


[ Top ]
getUrlReferer  [line 571]

  string getUrlReferer( )

返回浏览器发送Referer请求头

可以让服务器了解和追踪发出本次请求的起源URL地址


API Tags:
Access:  public


[ Top ]
getUserAgent  [line 592]

  string getUserAgent( )

返回User-Agent头字段用于指定浏览器或者其他客户端程序的类型和名字

如果客户机是一种无线手持终端,就返回一个WML文件;如果发现客户端是一种普通浏览器, 则返回通常的HTML文件


API Tags:
Access:  public


[ Top ]
isDelete  [line 388]

  boolean isDelete( )

返回请求是否为DELETE请求类型

如果请求是DELETE方式请求则返回true,否则返回false


API Tags:
Access:  public


[ Top ]
isGet  [line 355]

  boolean isGet( )

返回请求是否为GET请求类型

如果请求是GET方式请求则返回true,否则返回false


API Tags:
Access:  public


[ Top ]
isPost  [line 366]

  boolean isPost( )

返回请求是否为POST请求类型

如果请求是POST方式请求则返回true,否则返回false


API Tags:
Access:  public


[ Top ]
isPut  [line 377]

  boolean isPut( )

返回请求是否为PUT请求类型

如果请求是PUT方式请求则返回true,否则返回false


API Tags:
Access:  public


[ Top ]
isSecure  [line 344]

  boolean isSecure( )

请求是否使用的是HTTPS安全链接

如果是安全请求则返回true否则返回false


API Tags:
Access:  public


[ Top ]
normalizeRequest  [line 98]

  void normalizeRequest( )

初始化request对象

对输入参数做转义处理


API Tags:
Access:  protected


[ Top ]
setAttribute  [line 124]

  void setAttribute( string|array|object $data, [string $key = '']  )

设置属性数据

Parameters:
string|array|object    $data:  需要设置的数据
string   $key:  设置的数据保存用的key,默认为空,当数组和object类型的时候将会执行array_merge操作

API Tags:
Access:  public


[ Top ]
setServerPort  [line 549]

  void setServerPort( int $port  )

设置服务端口号

https链接的默认端口号为443 http链接的默认端口号为80

Parameters:
int   $port:  设置的端口号

API Tags:
Access:  public


[ Top ]

Documentation generated on Fri, 30 Mar 2012 11:43:34 +0800 by phpDocumentor 1.4.4