Suggestion: add human readable toString method

[8ctopus]

When the url contains unicode, toString(), returns an url encoded string which is not human readable

$reference = Url::parse("https://test.com");
$url = $reference->resolve('/デジカ/');

echo $url->toString(); // https://test.com/%E3%83%87%E3%82%B8%E3%82%AB/

I suggest to add a new method toPrettyString() which simply returns the url decoded string.

    public function toPrettyString(): string
    {
        return urldecode($this->url);
    }

https://test.com/デジカ/

[otsch]

Hi @8ctopus,

I like the idea. One thing that came to my mind: the library also supports IDN and as encoding/decoding IDN works differently, we shouldn't pass the whole URL to urldecode(). Example:

$url = Url::parse("https://www.デジカ.com/デジカ");
var_dump(urldecode($url->toString()));

returns

string(37) "https://www.xn--lckza7b.com/デジカ"

So maybe we should do something like:

    public function toDisplayString(): string
    {
        if ($this->isRelativeReference()) {
            return urldecode($this->url);
        }

        return (
            $this->hasIdn() ?
                $this->scheme() . '://' . $this->displayAuthority() : 
                $this->root()
        ) . urldecode($this->relative());
    }

I also thought a bit about the naming and I think toDisplayString() would be a bit better. I hope that's okay.
So, we'll also need to implement the displayAuthority() method, probably using a new toDisplayString() method in the Host class (https://github.com/crwlrsoft/url/blob/master/src/Host.php) and maybe also the Domain class (https://github.com/crwlrsoft/url/blob/master/src/Domain.php).

If you like to implement it and create a PR, please also make sure to add tests.

[8ctopus]

@otsch Glad that you like the idea, I need it for a project I'm working on, so hacked it on my end.
Since you already have put a lot of thought about how to implement it correctly, I would suggest you do it, of course, if you want to, Just let me know what you decide.