访问请求数据

Request对象保存有关客户端请求的信息。这些信息可以通过几个公共属性访问:

• 请求:等于$ _POST；
• 查询:等于$ _GET（请求- >查询- >获取美元(“名字”)）;
• 饼干:等于_COOKIE美元；
• 属性:没有等价物-被你的应用程序用来存储其他数据(见下面）;
• 文件:等于带有_file美元；
• 服务器:等于$ _SERVER；
• 头的一个子集$ _SERVER（请求- >标题- >获取美元(“用户代理”))．

每个属性都是ParameterBag实例(或的子类)，它是一个数据持有者类:

• 请求：ParameterBag或InputBag如果数据来自$ _POST参数;
• 查询：InputBag；
• 饼干：InputBag；
• 属性：ParameterBag；
• 文件：FileBag；
• 服务器：ServerBag；
• 头：HeaderBag．

所有ParameterBag实例有方法来检索和更新它们的数据:

所有()

返回参数。

键()

返回参数键。

替换()

用一组新参数替换当前参数。

add ()

添加参数。

get ()

按名称返回参数。

设置()

按名称设置参数。

有()

返回真正的如果定义了参数。

remove ()

删除一个参数。

的ParameterBagInstance也有一些过滤输入值的方法:

getAlpha ()

返回参数值的字母字符;

getAlnum ()

返回参数值的字母和数字;

getBoolean ()

返回转换为布尔值的参数值;

getDigits ()

返回参数值的数字;

getInt ()

返回转换为整数的参数值;

filter ()

使用PHP筛选参数使用filter_var函数。

所有的getter都有两个参数:第一个是参数名，第二个是参数不存在时返回的默认值:

1 2 3 4 5 6 7 8 9 10

//查询字符串为'?foo =酒吧'＄请求->查询->get (“foo”）;//返回'bar'＄请求->查询->get (“酒吧”）;//返回null＄请求->查询->get (“酒吧”，“记者”）;//返回'baz'

当PHP导入请求查询时，它处理如下请求参数foo(酒吧)=巴兹以一种特殊的方式创建数组。的get ()方法不支持返回数组，因此您需要使用以下代码:

12 3 4 5 6 7 8 9 10 11 12 13 14 15

//查询字符串为'?foo(酒吧)=巴兹'//不使用$request->query->get('foo');请使用以下语句:＄请求->查询->(“foo”）;//返回['bar' => 'baz']//如果所请求的参数不存在，返回一个空数组:＄请求->查询->(“qux”）;//返回[]＄请求->查询->get (“foo(酒吧)”）;//返回null＄请求->查询->所有()(“foo”] [“酒吧”];//返回'baz'

感谢公众属性属性的实例，则可以在请求中存储其他数据，该请求也是ParameterBag．这主要用于附加属于请求的信息，并且需要从应用程序中的许多不同点访问这些信息。

最后，与请求体一起发送的原始数据可以使用getContent ()：

1

＄内容＝＄请求->getContent ();

例如，这对于处理远程服务使用HTTP POST方法发送给应用程序的XML字符串可能很有用。

如果请求体是JSON字符串，则可以使用toArray ()：

1

＄数据＝＄请求->toArray ();

识别请求

在您的应用程序中，您需要一种方法来识别请求;大多数情况下，这是通过请求的“路径信息”来完成的，可以通过getPathInfo ()方法:

1 2 3

//请求到http://example.com/blog/index.php/post/hello-world//路径信息是"/post/hello-world"＄请求->getPathInfo ();

模拟请求

除了基于PHP全局变量创建请求，你还可以模拟一个请求:

1 2 3 4 5

＄请求=请求：：创建(' / hello world '，“得到”, (“名字”= >“法”]);

的create ()method根据URI、方法和一些参数(查询参数或请求参数取决于HTTP方法)创建一个请求;当然，您也可以覆盖所有其他变量(默认情况下，Symfony为所有PHP全局变量创建合理的默认值)。ob娱乐下载

基于这样的请求，您可以通过重写PHP全局变量overrideGlobals ()：

1

＄请求->overrideGlobals ();

访问会话

方法将会话附加到请求，则可以通过getSession ()方法请求或RequestStack类;的hasPreviousSession ()方法告诉您请求是否包含在以前的一个请求中启动的会话。

处理HTTP报头

处理HTTP标头不是一项简单的任务，因为它们的内容有转义和空白处理。ob娱乐下载Symfony提供了一个HeaderUtils类，它抽象了这种复杂性，并为最常见的任务定义了一些方法:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25

使用ob娱乐下载＼组件＼HttpFoundation＼HeaderUtils；//使用一个或多个分隔符分隔HTTP报头HeaderUtils：：分(“哒、en; q = 0.8”，”,,“）;// => [['da']， ['en-gb'，'q=0.8']]//将一个数组的数组组合成一个关联数组HeaderUtils：：结合([[“foo”，“abc”]、[“酒吧”]]);// => ['foo' => 'abc'， 'bar' => true]//将一个关联数组加入到一个字符串中用于HTTP报头HeaderUtils：：toString ([“foo”= >“abc”，“酒吧”= >真正的，“记者”= >'a b c'),”、“）;// => 'foo=abc, bar, baz="a bc "'//如果需要将字符串编码为带引号的字符串HeaderUtils：：报价(“foo”栏“”）;// => ' ' foo \"bar\""' '//解码带引号的字符串HeaderUtils：：结束(“foo \”栏\”“”）;// => 'foo "bar"'//解析一个查询字符串，但保留点(PHP parse_str()替换`。' by '_')HeaderUtils：：parseQuery (“foo [bar.baz] = qux”）;// => ['foo' => ['bar. 'Baz ' => 'qux']]

访问接受- *头数据

您可以访问提取的基本数据接受- *头文件，使用以下方法:

getAcceptableContentTypes ()

返回按质量降序排序的可接受内容类型列表。

getLanguages ()

返回按质量降序排序的可接受语言列表。

getCharsets ()

返回按质量降序排序的可接受字符集列表。

getEncodings ()

返回按质量降序排列的可接受编码列表。

如果您需要获得解析数据的完全访问权接受，接收语言，Accept-Charset或接受编码，你可以使用AcceptHeader工具类:

12 3 4 5 6 7 8 9 10 11 12

使用ob娱乐下载＼组件＼HttpFoundation＼AcceptHeader；＄acceptHeader= AcceptHeader：：fromString (＄请求->头->get (“接受”));如果（＄acceptHeader->有(“text / html”)) {＄项＝＄acceptHeader->get (“text / html”）;＄字符集＝＄项->getAttribute (“字符集”，“utf - 8”）;＄质量＝＄项->getQuality ();｝//接收头项按降序排序＄acceptHeaders= AcceptHeader：：fromString (＄请求->头->get (“接受”）)->所有();

属性中可选择包含的默认值接受- *头文件也支持:

1 2 3 4 5

＄acceptHeader＝文本/平原;q = 0.5, text / html、文本/ *;q = 0.8 * / *; q = 0.3 '；＄接受= AcceptHeader：：fromString (＄acceptHeader）;＄质量＝＄接受->get (“text / xml”）->getQuality ();// $quality = 0.8＄质量＝＄接受->get (“application / xml”）->getQuality ();// $quality = 0.3

匿名IP地址

应用程序遵守用户保护法规的一个日益普遍的需求是，在记录和存储IP地址以供分析之前匿名化它们。使用匿名化()方法。IpUtils做那件事:

1 2 3 4 5 6 7 8 9

使用ob娱乐下载＼组件＼HttpFoundation＼IpUtils；＄ipv4＝“123.234.235.236”；＄anonymousIpv4= IpUtils：：匿名化(＄ipv4）;// $ anonymmousipv4 = '123.234.235.0'＄ipv6＝“2 a01:198:603:10:396e: 4789:8e99:890f”；＄anonymousIpv6= IpUtils：：匿名化(＄ipv6）;// $ anonymoussipv6 = '2a01:198:603:10::'

访问其他数据

的请求类有许多其他方法，您可以使用它们来访问请求信息。看一看请求API获取更多信息。

重写请求

的请求类不应该被重写，因为它是表示HTTP消息的数据对象。但是当从遗留系统迁移时，添加方法或更改一些默认行为可能会有所帮助。在这种情况下，注册一个PHP可调用对象，它能够创建您的实例请求类:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

使用应用程序＼Http＼SpecialRequest；使用ob娱乐下载＼组件＼HttpFoundation＼请求；请求：：setFactory (函数(数组＄查询=[]，数组＄请求=[]，数组＄属性=[]，数组＄饼干=[]，数组＄文件=[]，数组＄服务器= [],＄内容= null)｛返回新SpecialRequest (＄查询，＄请求，＄属性，＄饼干，＄文件，＄服务器，＄内容）;})；＄请求=请求：：createFromGlobals ();

发送响应

在发送响应之前，您可以选择调用准备()方法来修复与HTTP规范的任何不兼容(例如错误的内容类型头):

1

＄响应->准备(＄请求）;

将响应发送到客户机是通过调用该方法完成的send ()：

1

＄响应->send ();

设置cookie

控件可以对响应cookie进行操作头公共属性:

1 2 3

使用ob娱乐下载＼组件＼HttpFoundation＼饼干；＄响应->头->setCookie(饼干：：创建(“foo”，“酒吧”));

的setCookie ()方法的实例饼干作为一个论证。

您可以通过clearCookie ()方法。

除了饼干:create ()方法时，可以创建饼干对象从原始头值使用fromString ()方法。你也可以使用* ()方法来更改某些Cookie属性(或使用连贯接口构建整个Cookie)。每一个* ()方法返回一个具有modified属性的新对象:

1 2 3 4 5

＄饼干=饼干：：创建(“foo”）->withValue (“酒吧”）->withExpires (strtotime (“2011年5月20日星期五15:25:52”）)->withDomain (“.example.com”）->withSecure (真正的）;

管理HTTP缓存

的响应类有一组丰富的方法来操作与缓存相关的HTTP头:

• setPublic ()
• setPrivate ()
• (到期)
• setExpires ()
• setMaxAge ()
• setSharedMaxAge ()
• setStaleIfError ()
• setStaleWhileRevalidate ()
• setTtl ()
• setClientTtl ()
• setLastModified ()
• setEtag ()
• setVary ()

的setCache ()方法可用于在一个方法调用中设置最常用的缓存信息:

12 3 4 5 6 7 8 9 10 11 12 13 14 15 16

＄响应->setCache ([“must_revalidate”= >假，“no_cache”= >假，“no_store”= >假，“no_transform”= >假，“公共”= >真正的，“私人”= >假，“proxy_revalidate”= >假，“max_age”= >600，“s_maxage”= >600，“stale_if_error”= >86400，“stale_while_revalidate”= >60，“不变”= >真正的，“last_modified”= >新\ DateTime (),“etag”= >“六边形abcdef”]);

要检查响应验证器(ETag，last - modified)匹配客户端请求中指定的条件值，使用isNotModified ()方法:

1 2 3

如果（＄响应->isNotModified (＄请求)) {＄响应->send ();｝

如果没有修改Response，它将状态代码设置为304并删除实际的响应内容。

重定向用户

要将客户端重定向到另一个URL，可以使用RedirectResponse类:

1 2 3

使用ob娱乐下载＼组件＼HttpFoundation＼RedirectResponse；＄响应＝新RedirectResponse (“http://example.com/”）;

流媒体响应

的StreamedResponse类允许您将响应流回客户端。响应内容由PHP可调用对象而不是字符串表示:

1 2 3 4 5 6 7 8 9 10 11

使用ob娱乐下载＼组件＼HttpFoundation＼StreamedResponse；＄响应＝新StreamedResponse ();＄响应->setCallback (函数（）{var_dump (“Hello World”）;冲洗();睡眠(2）;var_dump (“Hello World”）;冲洗();})；＄响应->send ();

1 2

//在nginx中只对这个响应禁用FastCGI缓冲＄响应->头->集(“X-Accel-Buffering”，“不”）;

服务文件

发送文件时，必须添加附加项标题到您的响应。虽然为基本文件下载创建这个头文件很简单，但使用非ascii文件名就比较复杂了。的makeDisposition ()抽象了一个简单API背后的艰苦工作:

12 3 4 5 6 7 8 9 10 11 12 13

使用ob娱乐下载＼组件＼HttpFoundation＼HeaderUtils；使用ob娱乐下载＼组件＼HttpFoundation＼响应；使用ob娱乐下载＼组件＼HttpFoundation＼ResponseHeaderBag；＄fileContent=……;//生成的文件内容＄响应＝新响应(＄fileContent）;＄性格= HeaderUtils：：makeDisposition (HeaderUtils：：DISPOSITION_ATTACHMENT,“foo.pdf”）;＄响应->头->集(“附加”，＄性格）;

或者，如果您正在提供静态文件，则可以使用BinaryFileResponse：

1 2 3 4

使用ob娱乐下载＼组件＼HttpFoundation＼BinaryFileResponse；＄文件＝“路径/ / file.txt”；＄响应＝新BinaryFileResponse (＄文件）;

的BinaryFileResponse会自动处理范围而且If-Range来自请求的头文件。它还支持X-Sendfile(见nginx而且Apache)．要使用它，您需要确定是否X-Sendfile-Type头应受信任并调用trustXSendfileTypeHeader ()如果应该:

1

BinaryFileResponse：：trustXSendfileTypeHeader ();

1 2 3 4 5 6 7 8 9 10

< IfModule mod_xsendfile.c >#这已经在某个地方出现了……XSendFile在XSendFilePath.．.一些道路…#需要添加:< IfModule mod_headers.c >RequestHeader设置X-Sendfile-类型X-Sendfile< / IfModule >< / IfModule >

与BinaryFileResponse，您仍然可以设置内容类型，或更改其附加项：

1 2 3 4 5 6

/ /……＄响应->头->集(“内容类型”，“文本/普通”）;＄响应->setContentDisposition (ResponseHeaderBag：：DISPOSITION_ATTACHMENT,“filename.txt”）;

方法发送响应后，可以删除该文件deleteFileAfterSend ()方法。请注意，当X-Sendfile设置报头。

如果服务文件的大小是未知的(例如，因为它是动态生成的，或者因为PHP流过滤器在它上面注册了，等等)，您可以传递一个流实例BinaryFileResponse．这将禁用范围而且内容长度处理，改为分块编码:

1 2 3 4 5

使用ob娱乐下载＼组件＼HttpFoundation＼BinaryFileResponse；使用ob娱乐下载＼组件＼HttpFoundation＼文件＼流；＄流＝新流(的路径/ /流）;＄响应＝新BinaryFileResponse (＄流）;

创建JSON响应

方法可以创建任何类型的响应响应通过设置正确的内容和标头来初始化。JSON响应可能是这样的:

1 2 3 4 5 6 7

使用ob娱乐下载＼组件＼HttpFoundation＼响应；＄响应＝新反应();＄响应->setContent (json_encode ([“数据”= >123)));＄响应->头->集(“内容类型”，“application / json”）;

还有一个有用的JsonResponse类，这可以使这更容易:

12 3 4 5 6 7 8 9 10 11 12 13 14

使用ob娱乐下载＼组件＼HttpFoundation＼JsonResponse；//如果你知道在创建响应时要发送的数据＄响应＝新JsonResponse ([“数据”= >123]);//如果你不知道要发送的数据或如果你想自定义编码选项＄响应＝新JsonResponse ();/ /……//配置任何自定义编码选项(如果需要，必须在"setData()"之前调用)//$response->setEncodingOptions(JsonResponse::DEFAULT_ENCODING_OPTIONS | \JSON_PRESERVE_ZERO_FRACTION);＄响应->setData ([“数据”= >123]);//如果要发送的数据已经用JSON编码＄响应= JsonResponse：：fromJsonString (“{"data": 123}”）;

的JsonResponse类设置内容类型头来application / json并在需要时将数据编码为JSON。

JSONP回调

如果你正在使用JSONP，你可以设置数据应该传递给的回调函数:

1

＄响应->setCallback (“handleResponse”）;

在这种情况下，内容类型Header将为text / javascript响应内容看起来像这样:

1

handleResponse ({“数据”：123})；