1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
namespace Maztech\Url; |
4
|
|
|
|
5
|
|
|
/** |
6
|
|
|
* Class InstagramUrlManipulator |
7
|
|
|
* |
8
|
|
|
* @package Instagram |
9
|
|
|
*/ |
10
|
|
|
class InstagramUrlManipulator |
11
|
|
|
{ |
12
|
|
|
/** |
13
|
|
|
* Remove params from a URL. |
14
|
|
|
* |
15
|
|
|
* @param string $url The URL to filter. |
16
|
|
|
* @param array $paramsToFilter The params to filter from the URL. |
17
|
|
|
* |
18
|
|
|
* @return string The URL with the params removed. |
19
|
|
|
*/ |
20
|
|
|
public static function removeParamsFromUrl($url, array $paramsToFilter) |
21
|
|
|
{ |
22
|
|
|
$parts = parse_url($url); |
23
|
|
|
|
24
|
|
|
$query = ''; |
25
|
|
|
if (isset($parts['query'])) { |
26
|
|
|
$params = []; |
27
|
|
|
parse_str($parts['query'], $params); |
28
|
|
|
|
29
|
|
|
// Remove query params |
30
|
|
|
foreach ($paramsToFilter as $paramName) { |
31
|
|
|
unset($params[$paramName]); |
32
|
|
|
} |
33
|
|
|
|
34
|
|
|
if (count($params) > 0) { |
35
|
|
|
$query = '?' . http_build_query($params, '', '&'); |
36
|
|
|
} |
37
|
|
|
} |
38
|
|
|
|
39
|
|
|
$scheme = isset($parts['scheme']) ? $parts['scheme'] . '://' : ''; |
40
|
|
|
$host = isset($parts['host']) ? $parts['host'] : ''; |
41
|
|
|
$port = isset($parts['port']) ? ':' . $parts['port'] : ''; |
42
|
|
|
$path = isset($parts['path']) ? $parts['path'] : ''; |
43
|
|
|
$fragment = isset($parts['fragment']) ? '#' . $parts['fragment'] : ''; |
44
|
|
|
|
45
|
|
|
return $scheme . $host . $port . $path . $query . $fragment; |
46
|
|
|
} |
47
|
|
|
|
48
|
|
|
/** |
49
|
|
|
* Gracefully appends params to the URL. |
50
|
|
|
* |
51
|
|
|
* @param string $url The URL that will receive the params. |
52
|
|
|
* @param array $newParams The params to append to the URL. |
53
|
|
|
* |
54
|
|
|
* @return string |
55
|
|
|
*/ |
56
|
|
|
public static function appendParamsToUrl($url, array $newParams = []) |
57
|
|
|
{ |
58
|
|
|
if (empty($newParams)) { |
59
|
|
|
return $url; |
60
|
|
|
} |
61
|
|
|
|
62
|
|
|
if (strpos($url, '?') === false) { |
63
|
|
|
return $url . '?' . http_build_query($newParams, '', '&'); |
64
|
|
|
} |
65
|
|
|
|
66
|
|
|
list($path, $query) = explode('?', $url, 2); |
67
|
|
|
$existingParams = []; |
68
|
|
|
parse_str($query, $existingParams); |
69
|
|
|
|
70
|
|
|
// Favor params from the original URL over $newParams |
71
|
|
|
$newParams = array_merge($newParams, $existingParams); |
72
|
|
|
|
73
|
|
|
// Sort for a predicable order |
74
|
|
|
ksort($newParams); |
75
|
|
|
|
76
|
|
|
return $path . '?' . http_build_query($newParams, '', '&'); |
77
|
|
|
} |
78
|
|
|
|
79
|
|
|
/** |
80
|
|
|
* Returns the params from a URL in the form of an array. |
81
|
|
|
* |
82
|
|
|
* @param string $url The URL to parse the params from. |
83
|
|
|
* |
84
|
|
|
* @return array |
85
|
|
|
*/ |
86
|
|
|
public static function getParamsAsArray($url) |
87
|
|
|
{ |
88
|
|
|
$query = parse_url($url, PHP_URL_QUERY); |
89
|
|
|
if (!$query) { |
90
|
|
|
return []; |
91
|
|
|
} |
92
|
|
|
$params = []; |
93
|
|
|
parse_str($query, $params); |
94
|
|
|
|
95
|
|
|
return $params; |
96
|
|
|
} |
97
|
|
|
|
98
|
|
|
/** |
99
|
|
|
* Adds the params of the first URL to the second URL. |
100
|
|
|
* |
101
|
|
|
* Any params that already exist in the second URL will go untouched. |
102
|
|
|
* |
103
|
|
|
* @param string $urlToStealFrom The URL harvest the params from. |
104
|
|
|
* @param string $urlToAddTo The URL that will receive the new params. |
105
|
|
|
* |
106
|
|
|
* @return string The $urlToAddTo with any new params from $urlToStealFrom. |
107
|
|
|
*/ |
108
|
|
|
public static function mergeUrlParams($urlToStealFrom, $urlToAddTo) |
109
|
|
|
{ |
110
|
|
|
$newParams = static::getParamsAsArray($urlToStealFrom); |
111
|
|
|
// Nothing new to add, return as-is |
112
|
|
|
if (!$newParams) { |
|
|
|
|
113
|
|
|
return $urlToAddTo; |
114
|
|
|
} |
115
|
|
|
|
116
|
|
|
return static::appendParamsToUrl($urlToAddTo, $newParams); |
117
|
|
|
} |
118
|
|
|
|
119
|
|
|
/** |
120
|
|
|
* Check for a "/" prefix and prepend it if not exists. |
121
|
|
|
* |
122
|
|
|
* @param string|null $string |
123
|
|
|
* |
124
|
|
|
* @return string|null |
125
|
|
|
*/ |
126
|
|
|
public static function forceSlashPrefix($string) |
127
|
|
|
{ |
128
|
|
|
if (!$string) { |
129
|
|
|
return $string; |
130
|
|
|
} |
131
|
|
|
|
132
|
|
|
return strpos($string, '/') === 0 ? $string : '/' . $string; |
133
|
|
|
} |
134
|
|
|
|
135
|
|
|
/** |
136
|
|
|
* Trims off the hostname and Graph version from a URL. |
137
|
|
|
* |
138
|
|
|
* @param string $urlToTrim The URL the needs the surgery. |
139
|
|
|
* |
140
|
|
|
* @return string The $urlToTrim with the hostname and Graph version removed. |
141
|
|
|
*/ |
142
|
|
|
public static function baseGraphUrlEndpoint($urlToTrim) |
143
|
|
|
{ |
144
|
|
|
return '/' . preg_replace('/^https:\/\/.+\.Instagram\.com(\/v.+?)?\//', '', $urlToTrim); |
145
|
|
|
} |
146
|
|
|
} |
147
|
|
|
|