Blame view

sources/3rdparty/guzzle/http/Guzzle/Http/Message/Header/Link.php 1.97 KB
6d9380f96   Cédric Dupont   Update sources OC...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
  <?php
  
  namespace Guzzle\Http\Message\Header;
  
  use Guzzle\Http\Message\Header;
  
  /**
   * Provides helpful functionality for link headers
   */
  class Link extends Header
  {
      /**
       * Add a link to the header
       *
       * @param string $url    Link URL
       * @param string $rel    Link rel
       * @param array  $params Other link parameters
       *
       * @return self
       */
      public function addLink($url, $rel, array $params = array())
      {
          $values = array("<{$url}>", "rel=\"{$rel}\"");
  
          foreach ($params as $k => $v) {
              $values[] = "{$k}=\"{$v}\"";
          }
  
          return $this->add(implode('; ', $values));
      }
  
      /**
       * Check if a specific link exists for a given rel attribute
       *
       * @param string $rel rel value
       *
       * @return bool
       */
      public function hasLink($rel)
      {
          return $this->getLink($rel) !== null;
      }
  
      /**
       * Get a specific link for a given rel attribute
       *
       * @param string $rel Rel value
       *
       * @return array|null
       */
      public function getLink($rel)
      {
          foreach ($this->getLinks() as $link) {
              if (isset($link['rel']) && $link['rel'] == $rel) {
                  return $link;
              }
          }
  
          return null;
      }
  
      /**
       * Get an associative array of links
       *
       * For example:
       * Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg", <http://.../back.jpeg>; rel=back; type="image/jpeg"
       *
       * <code>
       * var_export($response->getLinks());
       * array(
       *     array(
       *         'url' => 'http:/.../front.jpeg',
       *         'rel' => 'back',
       *         'type' => 'image/jpeg',
       *     )
       * )
       * </code>
       *
       * @return array
       */
      public function getLinks()
      {
          $links = $this->parseParams();
  
          foreach ($links as &$link) {
              $key = key($link);
              unset($link[$key]);
              $link['url'] = trim($key, '<> ');
          }
  
          return $links;
      }
  }