Blame view

sources/3rdparty/guzzle/http/Guzzle/Http/Message/PostFile.php 2.92 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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
  <?php
  
  namespace Guzzle\Http\Message;
  
  use Guzzle\Common\Version;
  use Guzzle\Common\Exception\InvalidArgumentException;
  use Guzzle\Http\Mimetypes;
  
  /**
   * POST file upload
   */
  class PostFile implements PostFileInterface
  {
      protected $fieldName;
      protected $contentType;
      protected $filename;
      protected $postname;
  
      /**
       * @param string $fieldName   Name of the field
       * @param string $filename    Local path to the file
       * @param string $postname    Remote post file name
       * @param string $contentType Content-Type of the upload
       */
      public function __construct($fieldName, $filename, $contentType = null, $postname = null)
      {
          $this->fieldName = $fieldName;
          $this->setFilename($filename);
          $this->postname = $postname ? $postname : basename($filename);
          $this->contentType = $contentType ?: $this->guessContentType();
      }
  
      public function setFieldName($name)
      {
          $this->fieldName = $name;
  
          return $this;
      }
  
      public function getFieldName()
      {
          return $this->fieldName;
      }
  
      public function setFilename($filename)
      {
          // Remove leading @ symbol
          if (strpos($filename, '@') === 0) {
              $filename = substr($filename, 1);
          }
  
          if (!is_readable($filename)) {
              throw new InvalidArgumentException("Unable to open {$filename} for reading");
          }
  
          $this->filename = $filename;
  
          return $this;
      }
  
      public function setPostname($postname)
      {
          $this->postname = $postname;
  
          return $this;
      }
  
      public function getFilename()
      {
          return $this->filename;
      }
  
      public function getPostname()
      {
          return $this->postname;
      }
  
      public function setContentType($type)
      {
          $this->contentType = $type;
  
          return $this;
      }
  
      public function getContentType()
      {
          return $this->contentType;
      }
  
      public function getCurlValue()
      {
          // PHP 5.5 introduced a CurlFile object that deprecates the old @filename syntax
          // See: https://wiki.php.net/rfc/curl-file-upload
          if (function_exists('curl_file_create')) {
              return curl_file_create($this->filename, $this->contentType, $this->postname);
          }
  
          // Use the old style if using an older version of PHP
          $value = "@{$this->filename};filename=" . $this->postname;
          if ($this->contentType) {
              $value .= ';type=' . $this->contentType;
          }
  
          return $value;
      }
  
      /**
       * @deprecated
       * @codeCoverageIgnore
       */
      public function getCurlString()
      {
          Version::warn(__METHOD__ . ' is deprecated. Use getCurlValue()');
          return $this->getCurlValue();
      }
  
      /**
       * Determine the Content-Type of the file
       */
      protected function guessContentType()
      {
          return Mimetypes::getInstance()->fromFilename($this->filename) ?: 'application/octet-stream';
      }
  }