perchten/truepath

Replace PHP's extremely buggy realpath()

1.0.0 2014-05-13 22:27 UTC

This package is not auto-updated.

Last update: 2024-07-20 15:26:57 UTC


README

Replace PHP's extremely buggy realpath()

Usage

Installation

Via Composer

Truepath is available on Packagist (perchten/truepath) and as such is installable via Composer.

Add the following to your composer.json

{
	"require": {s
    	"perchten/truepath": "1.*"
    }
}
Direct include

Clone or download from GitHub and include directly in your code:

require_once "path/to/truepath/truepath.php"

Code

It's just one simple function, and as such it is not namespaced, but loaded as a globally available function. So just use:

$truepath = truepath("some/possible/path")

Unlike PHP's realpath, this function does not return false on error; it returns a path which is as far as it could to resolving these quirks.

This does not work on network resources including UNC and URLs. It works for the local file system only.

Acknowledgements

All credit goes to Christian from this StackOverflow question. I'm just putting this up on some repos for easier access.