1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
<?php
namespace Yoast\WP\SEO\Helpers;
use Yoast\WP\SEO\Models\SEO_Links;
/**
* A helper object for URLs.
*/
class Url_Helper {
/**
* Retrieve home URL with proper trailing slash.
*
* @param string $path Path relative to home URL.
* @param string|null $scheme Scheme to apply.
*
* @return string Home URL with optional path, appropriately slashed if not.
*/
public function home( $path = '', $scheme = null ) {
$home_url = \home_url( $path, $scheme );
if ( ! empty( $path ) ) {
return $home_url;
}
$home_path = \wp_parse_url( $home_url, \PHP_URL_PATH );
if ( $home_path === '/' ) { // Home at site root, already slashed.
return $home_url;
}
if ( \is_null( $home_path ) ) { // Home at site root, always slash.
return \trailingslashit( $home_url );
}
if ( \is_string( $home_path ) ) { // Home in subdirectory, slash if permalink structure has slash.
return \user_trailingslashit( $home_url );
}
return $home_url;
}
/**
* Check whether a url is relative.
*
* @param string $url URL string to check.
*
* @return bool True when url is relative.
*/
public function is_relative( $url ) {
return ( \strpos( $url, 'http' ) !== 0 && \strpos( $url, '//' ) !== 0 );
}
/**
* Gets the path from the passed URL.
*
* @param string $url The URL to get the path from.
*
* @codeCoverageIgnore It only wraps a WordPress function.
*
* @return string The path of the URL. Returns an empty string if URL parsing fails.
*/
public function get_url_path( $url ) {
return (string) \wp_parse_url( $url, \PHP_URL_PATH );
}
/**
* Determines the file extension of the given url.
*
* @param string $url The URL.
*
* @return string The extension.
*/
public function get_extension_from_url( $url ) {
$path = $this->get_url_path( $url );
if ( $path === '' ) {
return '';
}
$parts = \explode( '.', $path );
if ( empty( $parts ) || \count( $parts ) === 1 ) {
return '';
}
return \end( $parts );
}
/**
* Ensures that the given url is an absolute url.
*
* @param string $url The url that needs to be absolute.
*
* @return string The absolute url.
*/
public function ensure_absolute_url( $url ) {
if ( ! \is_string( $url ) || $url === '' ) {
return $url;
}
if ( $this->is_relative( $url ) === true ) {
return $this->build_absolute_url( $url );
}
return $url;
}
/**
* Parse the home URL setting to find the base URL for relative URLs.
*
* @param string $path Optional path string.
*
* @return string
*/
public function build_absolute_url( $path = null ) {
$path = \wp_parse_url( $path, \PHP_URL_PATH );
$url_parts = \wp_parse_url( \home_url() );
$base_url = \trailingslashit( $url_parts['scheme'] . '://' . $url_parts['host'] );
if ( ! \is_null( $path ) ) {
$base_url .= \ltrim( $path, '/' );
}
return $base_url;
}
/**
* Returns the link type.
*
* @param array $url The URL, as parsed by wp_parse_url.
* @param array $home_url Optional. The home URL, as parsed by wp_parse_url. Used to avoid reparsing the home_url.
* @param bool $is_image Whether or not the link is an image.
*
* @return string The link type.
*/
public function get_link_type( $url, $home_url = null, $is_image = false ) {
// If there is no scheme and no host the link is always internal.
// Beware, checking just the scheme isn't enough as a link can be //yoast.com for instance.
if ( empty( $url['scheme'] ) && empty( $url['host'] ) ) {
return ( $is_image ) ? SEO_Links::TYPE_INTERNAL_IMAGE : SEO_Links::TYPE_INTERNAL;
}
// If there is a scheme but it's not https? then the link is always external.
if ( ! \in_array( $url['scheme'], [ 'http', 'https' ], true ) ) {
return ( $is_image ) ? SEO_Links::TYPE_EXTERNAL_IMAGE : SEO_Links::TYPE_EXTERNAL;
}
if ( \is_null( $home_url ) ) {
$home_url = \wp_parse_url( \home_url() );
}
// When the base host is equal to the host.
if ( isset( $url['host'] ) && $url['host'] !== $home_url['host'] ) {
return ( $is_image ) ? SEO_Links::TYPE_EXTERNAL_IMAGE : SEO_Links::TYPE_EXTERNAL;
}
// There is no base path and thus all URLs of the same domain are internal.
if ( empty( $home_url['path'] ) ) {
return ( $is_image ) ? SEO_Links::TYPE_INTERNAL_IMAGE : SEO_Links::TYPE_INTERNAL;
}
// When there is a path and it matches the start of the url.
if ( isset( $url['path'] ) && \strpos( $url['path'], $home_url['path'] ) === 0 ) {
return ( $is_image ) ? SEO_Links::TYPE_INTERNAL_IMAGE : SEO_Links::TYPE_INTERNAL;
}
return ( $is_image ) ? SEO_Links::TYPE_EXTERNAL_IMAGE : SEO_Links::TYPE_EXTERNAL;
}
}
|