13

I need to implement functions to check whether paths and urls are relative, absolute, or invalid (invalid syntactically- not whether resource exists). What are the range of cases I should be looking for?

function check_path($dirOrFile) {
    // If it's an absolute path: (Anything that starts with a '/'?)
        return 'absolute';
    // If it's a relative path: 
        return 'relative';
    // If it's an invalid path:
        return 'invalid';
}

function check_url($url) {
    // If it's an absolute url: (Anything that starts with a 'http://' or 'https://'?)
        return 'absolute';
    // If it's a relative url:
        return 'relative';
    // If it's an invalid url:
        return 'invalid';
}
Yarin
  • 173,523
  • 149
  • 402
  • 512
  • http://nashruddin.com/PHP_Script_for_Converting_Relative_to_Absolute_URL take the results of the function detailed in that link and compare the before/after results. If it's changed, then you probably had a relative url – Marc B Sep 12 '11 at 18:39
  • 1
    ``You forgot closing single-quote in the `return` values.`` – Zirak Sep 12 '11 at 18:41
  • @Marc B- While that link has some useful parts, it won't work for me as is, esp if I don't know what the base of the url being passed to me will be- I won't be able to match it... – Yarin Sep 12 '11 at 19:02

7 Answers7

7

Use:

function isAbsolute($url) {
  return isset(parse_url($url)['host']);
}

Explanation:

If the host is set, the path is absolute.

For example:

$test = [
'/link?param=1'=>parse_url('/assa?ass'),
'//aaa.com/link?param=1'=>parse_url('//assa?ass'),
'http://aaa.com/link?param=1'=>parse_url('http://as.plassa?ass')
];
var_export($test);

/* Output:
[
  "/link?param=1" => array:2 [▼ // Not absolute
    "path" => "/assa"
    "query" => "ass"
  ]
  "//aaa.com/link?param=1" => array:2 [▼ // Absolute because of host
    "host" => "assa"
    "query" => "ass"
  ]
  "http://aaa.com/link?param=1" => array:3 [▼ // Absolute because of host
    "scheme" => "http"
    "host" => "as.plassa"
    "query" => "ass"
  ]
]
*/
Chris Happy
  • 7,088
  • 2
  • 22
  • 49
Developer
  • 2,731
  • 2
  • 41
  • 71
5

Absolute Paths and URLs

You are correct, absolute URLs in Linux must start with /, so checking for a slash in the start of the path will be enough.

For URLs you need to check for http:// and https://, as you wrote, however, there are more URLs starting with ftp://, sftp:// or smb://. So it is very depending on what range of uses you want to cover.

Invalid Paths and URLs

Assuming you are referring to Linux, the only chars that are forbidden in a path are / and \0. This is actually very filesystem dependent, however, you can assume the above to be correct for most uses.

In Windows it is more complicated. You can read about it in the Path.GetInvalidPathChars Method documentation under Remarks.

URLs are more complicated than Linux paths as the only allowed chars are A-Z, a-z, 0-9, -, ., _, ~, :, /, ?, #, [, ], @, !, $, &, ', (, ), *, +, ,, ; and = (as described in another answer here).

Relative Paths and URLs

In general, paths and URLs which are neither absolute nor invalid are relative.

Community
  • 1
  • 1
Ofir
  • 415
  • 2
  • 7
  • 6
    checking for a leading slash is *not* enough if you expect your PHP scripts to be portable to other platforms - absolute paths on Windows may start with a backslash or `"C:\"` ... I came up with the following (Preg) regular expression: `/^(?:\/|\\|\w\:\\).*$/` - this will match `"/file"`, `"\file"`, `"c:\file"`, but not `"file"` or `"path/file"` etc. – mindplay.dk Jul 27 '12 at 14:17
  • 1
    Actually, I remember writing a filename that had a `\0` in it on Linux once, on Ext3 IIRC (just for fun). Also `\n` in a filename works, these two things can break 99% of scripts (not to mention a half of them already break if paths have spaces lol). – Camilo Martin Apr 16 '13 at 06:09
  • Hey @mindplay.dk, your regex doesn't work for C:/. But it does work for C:\. Now in Windows, C:/ paths are legitimate as well! Any ideas how to fix? – CMCDragonkai Nov 29 '13 at 11:57
  • I added an extra optional to fix: `^(?:\/|\\|\w\:\\|\w\:\/).*$`. It now recognises C:/. – CMCDragonkai Nov 29 '13 at 11:59
  • Since trying to make it work on PHP, due to the way PHP weirdly escapes backslashes, the regex has to be converted to `^(?:\/|\\\\|\w:\\\\|\w:\/).*$`/ – CMCDragonkai Nov 29 '13 at 14:58
4

From Symfony FileSystem component to check if a path is absolute:

public function isAbsolutePath($file)
{
    return strspn($file, '/\\', 0, 1)
        || (strlen($file) > 3 && ctype_alpha($file[0])
            && substr($file, 1, 1) === ':'
            && strspn($file, '/\\', 2, 1)
        )
        || null !== parse_url($file, PHP_URL_SCHEME)
    ;
}
CIRCLE
  • 4,501
  • 5
  • 37
  • 56
4

Since I cannot comment on answers because of my poor reputation I have to respond to ymakux answer with the function that he copied from Drupal library.

I am using this function and I have found out that urls with query part (text after ? symbol) which contains | symbol will be evaluated to false

for example:

https://example.com/image.jpeg?fl=res,749,562,3|shr,,20|jpg,90

Will be evaluated to false.

All you have to do is add

\|

To query part of the regex so the function looks like:

public static function isAbsoluteUrl($url)
    {
        $pattern = "/^(?:ftp|https?|feed)?:?\/\/(?:(?:(?:[\w\.\-\+!$&'\(\)*\+,;=]|%[0-9a-f]{2})+:)*
        (?:[\w\.\-\+%!$&'\(\)*\+,;=]|%[0-9a-f]{2})+@)?(?:
        (?:[a-z0-9\-\.]|%[0-9a-f]{2})+|(?:\[(?:[0-9a-f]{0,4}:)*(?:[0-9a-f]{0,4})\]))(?::[0-9]+)?(?:[\/|\?]
        (?:[\w#!:\.\?\+\|=&@$'~*,;\/\(\)\[\]\-]|%[0-9a-f]{2})*)?$/xi";

        return (bool) preg_match($pattern, $url);
    }

Hope it helps someone :)

3

This function is taken from Drupal

public function is_absolute($url)
{
    $pattern = "/^(?:ftp|https?|feed):\/\/(?:(?:(?:[\w\.\-\+!$&'\(\)*\+,;=]|%[0-9a-f]{2})+:)*
    (?:[\w\.\-\+%!$&'\(\)*\+,;=]|%[0-9a-f]{2})+@)?(?:
    (?:[a-z0-9\-\.]|%[0-9a-f]{2})+|(?:\[(?:[0-9a-f]{0,4}:)*(?:[0-9a-f]{0,4})\]))(?::[0-9]+)?(?:[\/|\?]
    (?:[\w#!:\.\?\+=&@$'~*,;\/\(\)\[\]\-]|%[0-9a-f]{2})*)?$/xi";

    return (bool) preg_match($pattern, $url);
}
ymakux
  • 3,415
  • 1
  • 34
  • 43
3

If you already know that the URL is well formed:

if(strpos($uri,'://')!==false){
    //protocol: absolute url
}elseif(substr($uri,0,1)=='/'){
    //leading '/': absolute to domain name (half relative)
}else{
    //no protocol and no leading slash: relative to this page
}
Luca C.
  • 11,714
  • 1
  • 86
  • 77
2

I've recently started a composer package that might be useful for checking wether URL's are relative / absolute (and more, ofcourse).

Check out the repository here: https://github.com/Enrise/UriHelper Or the composer Packagists package here: https://packagist.org/packages/enrise/urihelper

Some examples:

$uri = new \Enrise\Uri('http://usr:pss@example.com:81/mypath/myfile.html?a=b&b[]=2&b[]=3#myfragment');
echo $uri->getScheme(); // http
echo $uri->getUser(); // usr
echo $uri->getPass(); // pss
echo $uri->getHost(); // example.com
echo $uri->getPort(); // 81
echo $uri->getPath(); // /mypath/myfile.html
echo $uri->getQuery(); // a=b&b[]=2&b[]=3
echo $uri->getFragment(); // myfragment
echo $uri->isSchemeless(); // false
echo $uri->isRelative(); // false

$uri->setScheme('scheme:child:scheme.VALIDscheme123:');
$uri->setPort(null);

echo $uri->getUri(); //scheme:child:scheme.VALIDscheme123:usr:pss@example.com/mypath/myfile.html?a=b&b[]=2&b[]=3#myfragment
Rob
  • 4,927
  • 4
  • 26
  • 41