README

This package is deprecated and no longer maintained. Please move off it.

I wrote this in 2014 to provide http_build_url() without the pecl_http extension. PHP 8.5 now ships a built-in URI API that does the same job, so there's no reason to keep depending on this. Known bugs in this package, like joining a path onto a URL with a trailing slash stripping every "a" from it (#25), won't be fixed.

Replacing it on PHP 8.5+

use Uri\Rfc3986\Uri;

// Replace parts of a URL
echo Uri::parse('https://example.com/search?q=php#top')
    ->withPath('/docs')
    ->withQuery('page=2')
    ->withFragment(null)
    ->toString();
// https://example.com/docs?page=2

// Join a relative path and merge query strings
// (was HTTP_URL_JOIN_PATH | HTTP_URL_JOIN_QUERY)
$base = Uri::parse('https://example.com/v1/users?page=2');
parse_str($base->getQuery() ?? '', $query);
echo $base->resolve('me')
    ->withQuery(http_build_query($query + ['fields' => 'name']))
    ->toString();
// https://example.com/v1/me?page=2&fields=name

On older PHP, combine parse_url() and http_build_query(), or use a URI library such as league/uri.

Released versions stay on Packagist, so existing installs keep working.

License

MIT. See LICENSE.