initial commit

app/Vendor/Facebook/HttpClients/FacebookCurl.php

@@ -0,0 +1,129 @@
+<?php
+/**
+ * Copyright 2014 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\HttpClients;
+
+/**
+ * Class FacebookCurl
+ * Abstraction for the procedural curl elements so that curl can be mocked
+ * and the implementation can be tested.
+ * @package Facebook
+ */
+class FacebookCurl
+{
+
+  /**
+   * @var resource Curl resource instance
+   */
+  protected $curl;
+
+  /**
+   * Make a new curl reference instance
+   */
+  public function init()
+  {
+    $this->curl = curl_init();
+  }
+
+  /**
+   * Set a curl option
+   *
+   * @param $key
+   * @param $value
+   */
+  public function setopt($key, $value)
+  {
+    curl_setopt($this->curl, $key, $value);
+  }
+
+  /**
+   * Set an array of options to a curl resource
+   *
+   * @param array $options
+   */
+  public function setopt_array(array $options)
+  {
+    curl_setopt_array($this->curl, $options);
+  }
+
+  /**
+   * Send a curl request
+   *
+   * @return mixed
+   */
+  public function exec()
+  {
+    return curl_exec($this->curl);
+  }
+
+  /**
+   * Return the curl error number
+   *
+   * @return int
+   */
+  public function errno()
+  {
+    return curl_errno($this->curl);
+  }
+
+  /**
+   * Return the curl error message
+   *
+   * @return string
+   */
+  public function error()
+  {
+    return curl_error($this->curl);
+  }
+
+  /**
+   * Get info from a curl reference
+   *
+   * @param $type
+   *
+   * @return mixed
+   */
+  public function getinfo($type)
+  {
+    return curl_getinfo($this->curl, $type);
+  }
+
+  /**
+   * Get the currently installed curl version
+   *
+   * @return array
+   */
+  public function version()
+  {
+    return curl_version();
+  }
+
+  /**
+   * Close the resource connection to curl
+   */
+  public function close()
+  {
+    curl_close($this->curl);
+  }
+
+}

app/Vendor/Facebook/HttpClients/FacebookCurlHttpClient.php

@@ -0,0 +1,341 @@
+<?php
+/**
+ * Copyright 2014 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\HttpClients;
+
+use Facebook\FacebookSDKException;
+
+/**
+ * Class FacebookCurlHttpClient
+ * @package Facebook
+ */
+class FacebookCurlHttpClient implements FacebookHttpable
+{
+
+  /**
+   * @var array The headers to be sent with the request
+   */
+  protected $requestHeaders = array();
+
+  /**
+   * @var array The headers received from the response
+   */
+  protected $responseHeaders = array();
+
+  /**
+   * @var int The HTTP status code returned from the server
+   */
+  protected $responseHttpStatusCode = 0;
+
+  /**
+   * @var string The client error message
+   */
+  protected $curlErrorMessage = '';
+
+  /**
+   * @var int The curl client error code
+   */
+  protected $curlErrorCode = 0;
+
+  /**
+   * @var string|boolean The raw response from the server
+   */
+  protected $rawResponse;
+
+  /**
+   * @var FacebookCurl Procedural curl as object
+   */
+  protected static $facebookCurl;
+
+  /**
+   * @var boolean If IPv6 should be disabled
+   */
+  protected static $disableIPv6;
+
+  /**
+   * @const Curl Version which is unaffected by the proxy header length error.
+   */
+  const CURL_PROXY_QUIRK_VER = 0x071E00;
+
+  /**
+   * @const "Connection Established" header text
+   */
+  const CONNECTION_ESTABLISHED = "HTTP/1.0 200 Connection established\r\n\r\n";
+
+  /**
+   * @param FacebookCurl|null Procedural curl as object
+   */
+  public function __construct(FacebookCurl $facebookCurl = null)
+  {
+    self::$facebookCurl = $facebookCurl ?: new FacebookCurl();
+    self::$disableIPv6 = self::$disableIPv6 ?: false;
+  }
+
+  /**
+   * Disable IPv6 resolution
+   */
+  public function disableIPv6()
+  {
+    self::$disableIPv6 = true;
+  }
+
+  /**
+   * The headers we want to send with the request
+   *
+   * @param string $key
+   * @param string $value
+   */
+  public function addRequestHeader($key, $value)
+  {
+    $this->requestHeaders[$key] = $value;
+  }
+
+  /**
+   * The headers returned in the response
+   *
+   * @return array
+   */
+  public function getResponseHeaders()
+  {
+    return $this->responseHeaders;
+  }
+
+  /**
+   * The HTTP status response code
+   *
+   * @return int
+   */
+  public function getResponseHttpStatusCode()
+  {
+    return $this->responseHttpStatusCode;
+  }
+
+  /**
+   * Sends a request to the server
+   *
+   * @param string $url The endpoint to send the request to
+   * @param string $method The request method
+   * @param array  $parameters The key value pairs to be sent in the body
+   *
+   * @return string Raw response from the server
+   *
+   * @throws \Facebook\FacebookSDKException
+   */
+  public function send($url, $method = 'GET', $parameters = array())
+  {
+    $this->openConnection($url, $method, $parameters);
+    $this->tryToSendRequest();
+
+    // Need to verify the peer
+    if ($this->curlErrorCode == 60 || $this->curlErrorCode == 77) {
+      $this->addBundledCert();
+      $this->tryToSendRequest();
+    }
+
+    if ($this->curlErrorCode) {
+      throw new FacebookSDKException($this->curlErrorMessage, $this->curlErrorCode);
+    }
+
+    // Separate the raw headers from the raw body
+    list($rawHeaders, $rawBody) = $this->extractResponseHeadersAndBody();
+
+    $this->responseHeaders = self::headersToArray($rawHeaders);
+
+    $this->closeConnection();
+
+    return $rawBody;
+  }
+
+  /**
+   * Opens a new curl connection
+   *
+   * @param string $url The endpoint to send the request to
+   * @param string $method The request method
+   * @param array  $parameters The key value pairs to be sent in the body
+   */
+  public function openConnection($url, $method = 'GET', $parameters = array())
+  {
+    $options = array(
+      CURLOPT_URL            => $url,
+      CURLOPT_CONNECTTIMEOUT => 10,
+      CURLOPT_TIMEOUT        => 60,
+      CURLOPT_RETURNTRANSFER => true, // Follow 301 redirects
+      CURLOPT_HEADER         => true, // Enable header processing
+    );
+
+    if ($method !== "GET") {
+      $options[CURLOPT_POSTFIELDS] = $parameters;
+    }
+    if ($method === 'DELETE' || $method === 'PUT') {
+      $options[CURLOPT_CUSTOMREQUEST] = $method;
+    }
+
+    if (!empty($this->requestHeaders)) {
+      $options[CURLOPT_HTTPHEADER] = $this->compileRequestHeaders();
+    }
+
+    if (self::$disableIPv6) {
+      $options[CURLOPT_IPRESOLVE] = CURL_IPRESOLVE_V4;
+    }
+
+    self::$facebookCurl->init();
+    self::$facebookCurl->setopt_array($options);
+  }
+
+  /**
+   * Add a bundled cert to the connection
+   */
+  public function addBundledCert()
+  {
+    self::$facebookCurl->setopt(CURLOPT_CAINFO,
+      dirname(__FILE__) . DIRECTORY_SEPARATOR . 'fb_ca_chain_bundle.crt');
+  }
+
+  /**
+   * Closes an existing curl connection
+   */
+  public function closeConnection()
+  {
+    self::$facebookCurl->close();
+  }
+
+  /**
+   * Try to send the request
+   */
+  public function tryToSendRequest()
+  {
+    $this->sendRequest();
+    $this->curlErrorMessage = self::$facebookCurl->error();
+    $this->curlErrorCode = self::$facebookCurl->errno();
+    $this->responseHttpStatusCode = self::$facebookCurl->getinfo(CURLINFO_HTTP_CODE);
+  }
+
+  /**
+   * Send the request and get the raw response from curl
+   */
+  public function sendRequest()
+  {
+    $this->rawResponse = self::$facebookCurl->exec();
+  }
+
+  /**
+   * Compiles the request headers into a curl-friendly format
+   *
+   * @return array
+   */
+  public function compileRequestHeaders()
+  {
+    $return = array();
+
+    foreach ($this->requestHeaders as $key => $value) {
+      $return[] = $key . ': ' . $value;
+    }
+
+    return $return;
+  }
+
+  /**
+   * Extracts the headers and the body into a two-part array
+   *
+   * @return array
+   */
+  public function extractResponseHeadersAndBody()
+  {
+    $headerSize = self::getHeaderSize();
+
+    $rawHeaders = mb_substr($this->rawResponse, 0, $headerSize);
+    $rawBody = mb_substr($this->rawResponse, $headerSize);
+
+    return array(trim($rawHeaders), trim($rawBody));
+  }
+
+  /**
+   * Converts raw header responses into an array
+   *
+   * @param string $rawHeaders
+   *
+   * @return array
+   */
+  public static function headersToArray($rawHeaders)
+  {
+    $headers = array();
+
+    // Normalize line breaks
+    $rawHeaders = str_replace("\r\n", "\n", $rawHeaders);
+
+    // There will be multiple headers if a 301 was followed
+    // or a proxy was followed, etc
+    $headerCollection = explode("\n\n", trim($rawHeaders));
+    // We just want the last response (at the end)
+    $rawHeader = array_pop($headerCollection);
+
+    $headerComponents = explode("\n", $rawHeader);
+    foreach ($headerComponents as $line) {
+      if (strpos($line, ': ') === false) {
+        $headers['http_code'] = $line;
+      } else {
+        list ($key, $value) = explode(': ', $line);
+        $headers[$key] = $value;
+      }
+    }
+
+    return $headers;
+  }
+
+  /**
+   * Return proper header size
+   *
+   * @return integer
+   */
+  private function getHeaderSize()
+  {
+    $headerSize = self::$facebookCurl->getinfo(CURLINFO_HEADER_SIZE);
+    // This corrects a Curl bug where header size does not account
+    // for additional Proxy headers.
+    if ( self::needsCurlProxyFix() ) {
+      // Additional way to calculate the request body size.
+      if (preg_match('/Content-Length: (\d+)/', $this->rawResponse, $m)) {
+          $headerSize = mb_strlen($this->rawResponse) - $m[1];
+      } elseif (stripos($this->rawResponse, self::CONNECTION_ESTABLISHED) !== false) {
+          $headerSize += mb_strlen(self::CONNECTION_ESTABLISHED);
+      }
+    }
+
+    return $headerSize;
+  }
+
+  /**
+   * Detect versions of Curl which report incorrect header lengths when
+   * using Proxies.
+   *
+   * @return boolean
+   */
+  private static function needsCurlProxyFix()
+  {
+    $ver = self::$facebookCurl->version();
+    $version = $ver['version_number'];
+
+    return $version < self::CURL_PROXY_QUIRK_VER;
+  }
+
+}

app/Vendor/Facebook/HttpClients/FacebookGuzzleHttpClient.php

@@ -0,0 +1,132 @@
+<?php
+/**
+ * Copyright 2014 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\HttpClients;
+
+use Facebook\FacebookSDKException;
+
+use GuzzleHttp\Client;
+use GuzzleHttp\Exception\AdapterException;
+use GuzzleHttp\Exception\RequestException;
+
+class FacebookGuzzleHttpClient implements FacebookHttpable {
+
+  /**
+   * @var array The headers to be sent with the request
+   */
+  protected $requestHeaders = array();
+
+  /**
+   * @var array The headers received from the response
+   */
+  protected $responseHeaders = array();
+
+  /**
+   * @var int The HTTP status code returned from the server
+   */
+  protected $responseHttpStatusCode = 0;
+
+  /**
+   * @var \GuzzleHttp\Client The Guzzle client
+   */
+  protected static $guzzleClient;
+
+  /**
+   * @param \GuzzleHttp\Client|null The Guzzle client
+   */
+  public function __construct(Client $guzzleClient = null)
+  {
+    self::$guzzleClient = $guzzleClient ?: new Client();
+  }
+
+  /**
+   * The headers we want to send with the request
+   *
+   * @param string $key
+   * @param string $value
+   */
+  public function addRequestHeader($key, $value)
+  {
+    $this->requestHeaders[$key] = $value;
+  }
+
+  /**
+   * The headers returned in the response
+   *
+   * @return array
+   */
+  public function getResponseHeaders()
+  {
+    return $this->responseHeaders;
+  }
+
+  /**
+   * The HTTP status response code
+   *
+   * @return int
+   */
+  public function getResponseHttpStatusCode()
+  {
+    return $this->responseHttpStatusCode;
+  }
+
+  /**
+   * Sends a request to the server
+   *
+   * @param string $url The endpoint to send the request to
+   * @param string $method The request method
+   * @param array  $parameters The key value pairs to be sent in the body
+   *
+   * @return string Raw response from the server
+   *
+   * @throws \Facebook\FacebookSDKException
+   */
+  public function send($url, $method = 'GET', $parameters = array())
+  {
+    $options = array();
+    if ($parameters) {
+      $options = array('body' => $parameters);
+    }
+
+    $request = self::$guzzleClient->createRequest($method, $url, $options);
+
+    foreach($this->requestHeaders as $k => $v) {
+      $request->setHeader($k, $v);
+    }
+
+    try {
+      $rawResponse = self::$guzzleClient->send($request);
+    } catch (RequestException $e) {
+      if ($e->getPrevious() instanceof AdapterException) {
+        throw new FacebookSDKException($e->getMessage(), $e->getCode());
+      }
+      $rawResponse = $e->getResponse();
+    }
+
+    $this->responseHttpStatusCode = $rawResponse->getStatusCode();
+    $this->responseHeaders = $rawResponse->getHeaders();
+
+    return $rawResponse->getBody();
+  }
+
+}

app/Vendor/Facebook/HttpClients/FacebookHttpable.php

@@ -0,0 +1,68 @@
+<?php
+/**
+ * Copyright 2014 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\HttpClients;
+
+/**
+ * Interface FacebookHttpable
+ * @package Facebook
+ */
+interface FacebookHttpable
+{
+
+  /**
+   * The headers we want to send with the request
+   *
+   * @param string $key
+   * @param string $value
+   */
+  public function addRequestHeader($key, $value);
+
+  /**
+   * The headers returned in the response
+   *
+   * @return array
+   */
+  public function getResponseHeaders();
+
+  /**
+   * The HTTP status response code
+   *
+   * @return int
+   */
+  public function getResponseHttpStatusCode();
+
+  /**
+   * Sends a request to the server
+   *
+   * @param string $url The endpoint to send the request to
+   * @param string $method The request method
+   * @param array  $parameters The key value pairs to be sent in the body
+   *
+   * @return string Raw response from the server
+   *
+   * @throws \Facebook\FacebookSDKException
+   */
+  public function send($url, $method = 'GET', $parameters = array());
+
+}

app/Vendor/Facebook/HttpClients/FacebookStream.php

@@ -0,0 +1,79 @@
+<?php
+/**
+ * Copyright 2014 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\HttpClients;
+
+/**
+ * Class FacebookStream
+ * Abstraction for the procedural stream elements so that the functions can be
+ * mocked and the implementation can be tested.
+ * @package Facebook
+ */
+class FacebookStream
+{
+
+  /**
+   * @var resource Context stream resource instance
+   */
+  protected $stream;
+
+  /**
+   * @var array Response headers from the stream wrapper
+   */
+  protected $responseHeaders;
+
+  /**
+   * Make a new context stream reference instance
+   *
+   * @param array $options
+   */
+  public function streamContextCreate(array $options)
+  {
+    $this->stream = stream_context_create($options);
+  }
+
+  /**
+   * The response headers from the stream wrapper
+   *
+   * @return array|null
+   */
+  public function getResponseHeaders()
+  {
+    return $this->responseHeaders;
+  }
+
+  /**
+   * Send a stream wrapped request
+   *
+   * @param string $url
+   *
+   * @return mixed
+   */
+  public function fileGetContents($url)
+  {
+    $rawResponse = file_get_contents($url, false, $this->stream);
+    $this->responseHeaders = $http_response_header;
+    return $rawResponse;
+  }
+
+}

app/Vendor/Facebook/HttpClients/FacebookStreamHttpClient.php

@@ -0,0 +1,188 @@
+<?php
+/**
+ * Copyright 2014 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\HttpClients;
+
+use Facebook\FacebookSDKException;
+
+class FacebookStreamHttpClient implements FacebookHttpable {
+
+  /**
+   * @var array The headers to be sent with the request
+   */
+  protected $requestHeaders = array();
+
+  /**
+   * @var array The headers received from the response
+   */
+  protected $responseHeaders = array();
+
+  /**
+   * @var int The HTTP status code returned from the server
+   */
+  protected $responseHttpStatusCode = 0;
+
+  /**
+   * @var FacebookStream Procedural stream wrapper as object
+   */
+  protected static $facebookStream;
+
+  /**
+   * @param FacebookStream|null Procedural stream wrapper as object
+   */
+  public function __construct(FacebookStream $facebookStream = null)
+  {
+    self::$facebookStream = $facebookStream ?: new FacebookStream();
+  }
+
+  /**
+   * The headers we want to send with the request
+   *
+   * @param string $key
+   * @param string $value
+   */
+  public function addRequestHeader($key, $value)
+  {
+    $this->requestHeaders[$key] = $value;
+  }
+
+  /**
+   * The headers returned in the response
+   *
+   * @return array
+   */
+  public function getResponseHeaders()
+  {
+    return $this->responseHeaders;
+  }
+
+  /**
+   * The HTTP status response code
+   *
+   * @return int
+   */
+  public function getResponseHttpStatusCode()
+  {
+    return $this->responseHttpStatusCode;
+  }
+
+  /**
+   * Sends a request to the server
+   *
+   * @param string $url The endpoint to send the request to
+   * @param string $method The request method
+   * @param array  $parameters The key value pairs to be sent in the body
+   *
+   * @return string Raw response from the server
+   *
+   * @throws \Facebook\FacebookSDKException
+   */
+  public function send($url, $method = 'GET', $parameters = array())
+  {
+    $options = array(
+      'http' => array(
+        'method' => $method,
+        'timeout' => 60,
+        'ignore_errors' => true
+      ),
+      'ssl' => array(
+        'verify_peer' => true,
+        'cafile' => dirname(__FILE__) . DIRECTORY_SEPARATOR . 'fb_ca_chain_bundle.crt',
+      ),
+    );
+
+    if ($parameters) {
+      $options['http']['content'] = http_build_query($parameters, null, '&');
+
+      $this->addRequestHeader('Content-type', 'application/x-www-form-urlencoded');
+    }
+
+    $options['http']['header'] = $this->compileHeader();
+
+    self::$facebookStream->streamContextCreate($options);
+    $rawResponse = self::$facebookStream->fileGetContents($url);
+    $rawHeaders = self::$facebookStream->getResponseHeaders();
+
+    if ($rawResponse === false || !$rawHeaders) {
+      throw new FacebookSDKException('Stream returned an empty response', 660);
+    }
+
+    $this->responseHeaders = self::formatHeadersToArray($rawHeaders);
+    $this->responseHttpStatusCode = self::getStatusCodeFromHeader($this->responseHeaders['http_code']);
+
+    return $rawResponse;
+  }
+
+  /**
+   * Formats the headers for use in the stream wrapper
+   *
+   * @return string
+   */
+  public function compileHeader()
+  {
+    $header = [];
+    foreach($this->requestHeaders as $k => $v) {
+      $header[] = $k . ': ' . $v;
+    }
+
+    return implode("\r\n", $header);
+  }
+
+  /**
+   * Converts array of headers returned from the wrapper into
+   * something standard
+   *
+   * @param array $rawHeaders
+   *
+   * @return array
+   */
+  public static function formatHeadersToArray(array $rawHeaders)
+  {
+    $headers = array();
+
+    foreach ($rawHeaders as $line) {
+      if (strpos($line, ':') === false) {
+        $headers['http_code'] = $line;
+      } else {
+        list ($key, $value) = explode(': ', $line);
+        $headers[$key] = $value;
+      }
+    }
+
+    return $headers;
+  }
+
+  /**
+   * Pulls out the HTTP status code from a response header
+   *
+   * @param string $header
+   *
+   * @return int
+   */
+  public static function getStatusCodeFromHeader($header)
+  {
+    preg_match('|HTTP/\d\.\d\s+(\d+)\s+.*|', $header, $match);
+    return (int) $match[1];
+  }
+
+}