guzzlehttp/uri-template

A polyfill class for uri_template of PHP

v2.0.0 2026-07-20 13:40 UTC

Requires

• php: ^7.4 || ^8.0
• symfony/polyfill-php80: ^1.25

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.8.2
• phpunit/phpunit: ^9.6.34
• uri-template/tests: 1.0.2

MIT

• Graham Campbell
• Michael Dowling
• George Mponos
• Tobias Nyholm

• uri-template
• guzzlehttp

Published on Packagist.org on 2026-07-20 13:41 UTC

README

guzzlehttp/uri-template expands RFC 6570 URI templates in PHP. It turns templates such as /users/{id}{?tab} into concrete URI strings using values from an array.

Use this package when an API describes paths or links with URI templates. If you only need to send HTTP requests, start with guzzlehttp/guzzle; install this package directly when your application needs URI template expansion.

Installation

composer require guzzlehttp/uri-template

Version Guidance

Version	Status	PHP Version
2.0	Latest	>=7.4,<8.6
1.0	Maintenance	>=7.2.5,<8.6

Quick Start

use GuzzleHttp\UriTemplate\UriTemplate;

$uri = UriTemplate::expand('/users/{id}{?tab}', [
    'id' => 123,
    'tab' => 'settings',
]);

echo $uri;
// /users/123?tab=settings

The first argument is an RFC 6570 URI template. The second argument is an array of variables. Variable names in the array must match the names used by the template.

Documentation

• URI Template Usage
• Input Contract
• Upgrade Guide
• Changelog

Testing

make test

Security

If you discover a security vulnerability within this package, please send an email to [e-mail]. All security vulnerabilities will be promptly addressed. Please do not disclose security-related issues publicly until a fix has been announced. Please see Security Policy for more information.

License

Guzzle URI Template is made available under the MIT License (MIT). Please see License File for more information.

For Enterprise

Available as part of the Tidelift Subscription

The maintainers of Guzzle and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.