mdref.json config
[mdref/mdref-http] / http / Message / addHeaders.md
1 # http\Message http\Message::addHeaders(array $headers[, bool $append = false])
2
3 Add headers, optionally appending values, if header keys already exist.
4 See http\Message::addHeader() and http\Message::setHeaders().
5
6 ## Params:
7
8 * array $headers
9 The HTTP headers to add.
10 * Optional bool $append = false
11 Whether to append values for existing headers.
12
13 ## Returns:
14
15 * http\Message, self.
16
17 ## Example:
18
19 <?php
20 $msg = new http\Message;
21
22 $msg->addHeaders(["Cache-Control" => "public"]);
23 var_dump($msg->getHeaders());
24
25 $msg->addHeaders(["Cache-Control" => "private"]);
26 var_dump($msg->getHeaders());
27
28 $msg->addHeaders(["Cache-Control" => "must-revalidate"], true);
29 var_dump($msg->getHeaders());
30
31 echo $msg;
32 ?>
33
34 Yields:
35
36 array(1) {
37 ["Cache-Control"]=>
38 string(6) "public"
39 }
40 array(1) {
41 ["Cache-Control"]=>
42 string(7) "private"
43 }
44 array(1) {
45 ["Cache-Control"]=>
46 string(24) "private, must-revalidate"
47 }
48 Cache-Control: private, must-revalidate
49