<?php /** * Copyright 2017 Facebook, Inc. * * You are hereby granted a non-exclusive, worldwide, royalty-free license to * use, copy, modify, and distribute this software in source code or binary * form for use in connection with the web services and APIs provided by * Facebook. * * As with any software that integrates with the Facebook platform, your use * of this software is subject to the Facebook Developer Principles and * Policies [http://developers.facebook.com/policy/]. This copyright notice * shall be included in all copies or substantial portions of the software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. * */ namespace Facebook\Http; use Facebook\FileUpload\FacebookFile; /** * Class RequestBodyMultipartt * * Some things copied from Guzzle * * @package Facebook * * @see https://github.com/guzzle/guzzle/blob/master/src/Post/MultipartBody.php */ class RequestBodyMultipart implements RequestBodyInterface { /** * @var string The boundary. */ private $boundary; /** * @var array The parameters to send with this request. */ private $params; /** * @var array The files to send with this request. */ private $files = []; /** * @param array $params The parameters to send with this request. * @param array $files The files to send with this request. * @param string $boundary Provide a specific boundary. */ public function __construct(array $params = [], array $files = [], $boundary = null) { $this->params = $params; $this->files = $files; $this->boundary = $boundary ?: uniqid(); } /** * @inheritdoc */ public function getBody() { $body = ''; // Compile normal params $params = $this->getNestedParams($this->params); foreach ($params as $k => $v) { $body .= $this->getParamString($k, $v); } // Compile files foreach ($this->files as $k => $v) { $body .= $this->getFileString($k, $v); } // Peace out $body .= "--{$this->boundary}--\r\n"; return $body; } /** * Get the boundary * * @return string */ public function getBoundary() { return $this->boundary; } /** * Get the string needed to transfer a file. * * @param string $name * @param FacebookFile $file * * @return string */ private function getFileString($name, FacebookFile $file) { return sprintf( "--%s\r\nContent-Disposition: form-data; name=\"%s\"; filename=\"%s\"%s\r\n\r\n%s\r\n", $this->boundary, $name, $file->getFileName(), $this->getFileHeaders($file), $file->getContents() ); } /** * Get the string needed to transfer a POST field. * * @param string $name * @param string $value * * @return string */ private function getParamString($name, $value) { return sprintf( "--%s\r\nContent-Disposition: form-data; name=\"%s\"\r\n\r\n%s\r\n", $this->boundary, $name, $value ); } /** * Returns the params as an array of nested params. * * @param array $params * * @return array */ private function getNestedParams(array $params) { $query = http_build_query($params, null, '&'); $params = explode('&', $query); $result = []; foreach ($params as $param) { list($key, $value) = explode('=', $param, 2); $result[urldecode($key)] = urldecode($value); } return $result; } /** * Get the headers needed before transferring the content of a POST file. * * @param FacebookFile $file * * @return string */ protected function getFileHeaders(FacebookFile $file) { return "\r\nContent-Type: {$file->getMimetype()}"; } }