Adapters
8 years ago
Providers
8 years ago
Autoload.php
8 years ago
Embera.php
8 years ago
FakeResponse.php
8 years ago
Formatter.php
8 years ago
HtmlProcessor.php
8 years ago
HttpRequest.php
8 years ago
Oembed.php
8 years ago
Providers.php
8 years ago
Url.php
8 years ago
Oembed.php
93 lines
| 1 | <?php |
| 2 | /** |
| 3 | * Oembed.php |
| 4 | * |
| 5 | * @package Embera |
| 6 | * @author Michael Pratt <pratt@hablarmierda.net> |
| 7 | * @link http://www.michael-pratt.com/ |
| 8 | * |
| 9 | * For the full copyright and license information, please view the LICENSE |
| 10 | * file that was distributed with this source code. |
| 11 | */ |
| 12 | |
| 13 | namespace Embera; |
| 14 | |
| 15 | /** |
| 16 | * This class manages requests and responses |
| 17 | * from an Oembed Endpoint. |
| 18 | * |
| 19 | * TODO: Support xml responses |
| 20 | */ |
| 21 | class Oembed |
| 22 | { |
| 23 | /** @var object Instance of \Embera\HttpRequest */ |
| 24 | protected $http; |
| 25 | |
| 26 | /** |
| 27 | * Construct |
| 28 | * |
| 29 | * @param object $http Instance of \Embera\HttpRequest |
| 30 | */ |
| 31 | public function __construct(\Embera\HttpRequest $http) |
| 32 | { |
| 33 | $this->http = $http; |
| 34 | } |
| 35 | |
| 36 | /** |
| 37 | * Gets information about a resource |
| 38 | * |
| 39 | * @param bool $behaviour Wether or not to use fake responses only |
| 40 | * @param string $apiUrl The Url to the Oembed provider |
| 41 | * @param string $url The original url, we want information from |
| 42 | * @param array $params An associative array with parameters to be sent to the |
| 43 | * Oembed provider. |
| 44 | * @return array |
| 45 | */ |
| 46 | public function getResourceInfo($behaviour, $apiUrl, $url, array $params = array()) |
| 47 | { |
| 48 | if ($behaviour === false) { |
| 49 | return array(); |
| 50 | } |
| 51 | |
| 52 | return $this->lookup($this->constructUrl($apiUrl, array_merge($params, array('url' => $url)))); |
| 53 | } |
| 54 | |
| 55 | /** |
| 56 | * Executes a http request to the given url and |
| 57 | * returns an associative array with the fetched data. |
| 58 | * |
| 59 | * @param string $url |
| 60 | * @return array |
| 61 | * |
| 62 | * @throws Exception From the Http object only if there is no way |
| 63 | * to perform the request or if the response from |
| 64 | * the server is empty/invalid. |
| 65 | */ |
| 66 | protected function lookup($url) |
| 67 | { |
| 68 | $response = $this->http->fetch($url); |
| 69 | $json = json_decode($response, true); |
| 70 | |
| 71 | if ($json) { |
| 72 | return array_merge(array('embera_using_fake' => 0), $json); |
| 73 | } |
| 74 | |
| 75 | return array(); |
| 76 | } |
| 77 | |
| 78 | /** |
| 79 | * Builds a valid Oembed query string based on the given parameters, |
| 80 | * Since this method uses the http_build_query function, there is no |
| 81 | * need to pass urlencoded parameters, http_build_query already does |
| 82 | * this for us. |
| 83 | * |
| 84 | * @param string $apiUrl The Url to the Oembed Api |
| 85 | * @param array $params Parameters for the query string |
| 86 | * @return string |
| 87 | */ |
| 88 | protected function constructUrl($apiUrl, array $params = array()) |
| 89 | { |
| 90 | return $apiUrl . ((strpos($apiUrl, '?') === false) ? '?' : '&') . http_build_query(array_filter($params)); |
| 91 | } |
| 92 | } |
| 93 |