From 677953067f2bb5502a70f0d004f1ac844b18a128 Mon Sep 17 00:00:00 2001
From: emkael <emkael@tlen.pl>
Date: Mon, 16 Jan 2017 22:04:43 +0100
Subject:  * Facebook support

---
 .../Facebook/Url/FacebookUrlDetectionHandler.php   | 163 ++++++++++++++++++++
 .../src/Facebook/Url/FacebookUrlManipulator.php    | 167 +++++++++++++++++++++
 .../src/Facebook/Url/UrlDetectionInterface.php     |  39 +++++
 3 files changed, 369 insertions(+)
 create mode 100644 lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlDetectionHandler.php
 create mode 100644 lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlManipulator.php
 create mode 100644 lib/facebook-graph-sdk/src/Facebook/Url/UrlDetectionInterface.php

(limited to 'lib/facebook-graph-sdk/src/Facebook/Url')

diff --git a/lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlDetectionHandler.php b/lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlDetectionHandler.php
new file mode 100644
index 0000000..5fbb9ce
--- /dev/null
+++ b/lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlDetectionHandler.php
@@ -0,0 +1,163 @@
+<?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\Url;
+
+/**
+ * Class FacebookUrlDetectionHandler
+ *
+ * @package Facebook
+ */
+class FacebookUrlDetectionHandler implements UrlDetectionInterface
+{
+    /**
+     * @inheritdoc
+     */
+    public function getCurrentUrl()
+    {
+        return $this->getHttpScheme() . '://' . $this->getHostName() . $this->getServerVar('REQUEST_URI');
+    }
+
+    /**
+     * Get the currently active URL scheme.
+     *
+     * @return string
+     */
+    protected function getHttpScheme()
+    {
+        return $this->isBehindSsl() ? 'https' : 'http';
+    }
+
+    /**
+     * Tries to detect if the server is running behind an SSL.
+     *
+     * @return boolean
+     */
+    protected function isBehindSsl()
+    {
+        // Check for proxy first
+        $protocol = $this->getHeader('X_FORWARDED_PROTO');
+        if ($protocol) {
+            return $this->protocolWithActiveSsl($protocol);
+        }
+
+        $protocol = $this->getServerVar('HTTPS');
+        if ($protocol) {
+            return $this->protocolWithActiveSsl($protocol);
+        }
+
+        return (string)$this->getServerVar('SERVER_PORT') === '443';
+    }
+
+    /**
+     * Detects an active SSL protocol value.
+     *
+     * @param string $protocol
+     *
+     * @return boolean
+     */
+    protected function protocolWithActiveSsl($protocol)
+    {
+        $protocol = strtolower((string)$protocol);
+
+        return in_array($protocol, ['on', '1', 'https', 'ssl'], true);
+    }
+
+    /**
+     * Tries to detect the host name of the server.
+     *
+     * Some elements adapted from
+     *
+     * @see https://github.com/symfony/HttpFoundation/blob/master/Request.php
+     *
+     * @return string
+     */
+    protected function getHostName()
+    {
+        // Check for proxy first
+        if ($host = $this->getHeader('X_FORWARDED_HOST')) {
+            $elements = explode(',', $host);
+            $host = $elements[count($elements) - 1];
+        } elseif (!$host = $this->getHeader('HOST')) {
+            if (!$host = $this->getServerVar('SERVER_NAME')) {
+                $host = $this->getServerVar('SERVER_ADDR');
+            }
+        }
+
+        // trim and remove port number from host
+        // host is lowercase as per RFC 952/2181
+        $host = strtolower(preg_replace('/:\d+$/', '', trim($host)));
+
+        // Port number
+        $scheme = $this->getHttpScheme();
+        $port = $this->getCurrentPort();
+        $appendPort = ':' . $port;
+
+        // Don't append port number if a normal port.
+        if (($scheme == 'http' && $port == '80') || ($scheme == 'https' && $port == '443')) {
+            $appendPort = '';
+        }
+
+        return $host . $appendPort;
+    }
+
+    protected function getCurrentPort()
+    {
+        // Check for proxy first
+        $port = $this->getHeader('X_FORWARDED_PORT');
+        if ($port) {
+            return (string)$port;
+        }
+
+        $protocol = (string)$this->getHeader('X_FORWARDED_PROTO');
+        if ($protocol === 'https') {
+            return '443';
+        }
+
+        return (string)$this->getServerVar('SERVER_PORT');
+    }
+
+    /**
+     * Returns the a value from the $_SERVER super global.
+     *
+     * @param string $key
+     *
+     * @return string
+     */
+    protected function getServerVar($key)
+    {
+        return isset($_SERVER[$key]) ? $_SERVER[$key] : '';
+    }
+
+    /**
+     * Gets a value from the HTTP request headers.
+     *
+     * @param string $key
+     *
+     * @return string
+     */
+    protected function getHeader($key)
+    {
+        return $this->getServerVar('HTTP_' . $key);
+    }
+}
diff --git a/lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlManipulator.php b/lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlManipulator.php
new file mode 100644
index 0000000..20a0299
--- /dev/null
+++ b/lib/facebook-graph-sdk/src/Facebook/Url/FacebookUrlManipulator.php
@@ -0,0 +1,167 @@
+<?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\Url;
+
+/**
+ * Class FacebookUrlManipulator
+ *
+ * @package Facebook
+ */
+class FacebookUrlManipulator
+{
+    /**
+     * Remove params from a URL.
+     *
+     * @param string $url            The URL to filter.
+     * @param array  $paramsToFilter The params to filter from the URL.
+     *
+     * @return string The URL with the params removed.
+     */
+    public static function removeParamsFromUrl($url, array $paramsToFilter)
+    {
+        $parts = parse_url($url);
+
+        $query = '';
+        if (isset($parts['query'])) {
+            $params = [];
+            parse_str($parts['query'], $params);
+
+            // Remove query params
+            foreach ($paramsToFilter as $paramName) {
+                unset($params[$paramName]);
+            }
+
+            if (count($params) > 0) {
+                $query = '?' . http_build_query($params, null, '&');
+            }
+        }
+
+        $scheme = isset($parts['scheme']) ? $parts['scheme'] . '://' : '';
+        $host = isset($parts['host']) ? $parts['host'] : '';
+        $port = isset($parts['port']) ? ':' . $parts['port'] : '';
+        $path = isset($parts['path']) ? $parts['path'] : '';
+        $fragment = isset($parts['fragment']) ? '#' . $parts['fragment'] : '';
+
+        return $scheme . $host . $port . $path . $query . $fragment;
+    }
+
+    /**
+     * Gracefully appends params to the URL.
+     *
+     * @param string $url       The URL that will receive the params.
+     * @param array  $newParams The params to append to the URL.
+     *
+     * @return string
+     */
+    public static function appendParamsToUrl($url, array $newParams = [])
+    {
+        if (!$newParams) {
+            return $url;
+        }
+
+        if (strpos($url, '?') === false) {
+            return $url . '?' . http_build_query($newParams, null, '&');
+        }
+
+        list($path, $query) = explode('?', $url, 2);
+        $existingParams = [];
+        parse_str($query, $existingParams);
+
+        // Favor params from the original URL over $newParams
+        $newParams = array_merge($newParams, $existingParams);
+
+        // Sort for a predicable order
+        ksort($newParams);
+
+        return $path . '?' . http_build_query($newParams, null, '&');
+    }
+
+    /**
+     * Returns the params from a URL in the form of an array.
+     *
+     * @param string $url The URL to parse the params from.
+     *
+     * @return array
+     */
+    public static function getParamsAsArray($url)
+    {
+        $query = parse_url($url, PHP_URL_QUERY);
+        if (!$query) {
+            return [];
+        }
+        $params = [];
+        parse_str($query, $params);
+
+        return $params;
+    }
+
+    /**
+     * Adds the params of the first URL to the second URL.
+     *
+     * Any params that already exist in the second URL will go untouched.
+     *
+     * @param string $urlToStealFrom The URL harvest the params from.
+     * @param string $urlToAddTo     The URL that will receive the new params.
+     *
+     * @return string The $urlToAddTo with any new params from $urlToStealFrom.
+     */
+    public static function mergeUrlParams($urlToStealFrom, $urlToAddTo)
+    {
+        $newParams = static::getParamsAsArray($urlToStealFrom);
+        // Nothing new to add, return as-is
+        if (!$newParams) {
+            return $urlToAddTo;
+        }
+
+        return static::appendParamsToUrl($urlToAddTo, $newParams);
+    }
+
+    /**
+     * Check for a "/" prefix and prepend it if not exists.
+     *
+     * @param string|null $string
+     *
+     * @return string|null
+     */
+    public static function forceSlashPrefix($string)
+    {
+        if (!$string) {
+            return $string;
+        }
+
+        return strpos($string, '/') === 0 ? $string : '/' . $string;
+    }
+
+    /**
+     * Trims off the hostname and Graph version from a URL.
+     *
+     * @param string $urlToTrim The URL the needs the surgery.
+     *
+     * @return string The $urlToTrim with the hostname and Graph version removed.
+     */
+    public static function baseGraphUrlEndpoint($urlToTrim)
+    {
+        return '/' . preg_replace('/^https:\/\/.+\.facebook\.com(\/v.+?)?\//', '', $urlToTrim);
+    }
+}
diff --git a/lib/facebook-graph-sdk/src/Facebook/Url/UrlDetectionInterface.php b/lib/facebook-graph-sdk/src/Facebook/Url/UrlDetectionInterface.php
new file mode 100644
index 0000000..764a606
--- /dev/null
+++ b/lib/facebook-graph-sdk/src/Facebook/Url/UrlDetectionInterface.php
@@ -0,0 +1,39 @@
+<?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\Url;
+
+/**
+ * Interface UrlDetectionInterface
+ *
+ * @package Facebook
+ */
+interface UrlDetectionInterface
+{
+    /**
+     * Get the currently active URL.
+     *
+     * @return string
+     */
+    public function getCurrentUrl();
+}
-- 
cgit v1.2.3