{"id":3073,"date":"2025-11-18T14:29:22","date_gmt":"2025-11-18T12:29:22","guid":{"rendered":"https:\/\/nyamsprod.com\/blog\/?p=3073"},"modified":"2025-11-18T14:29:23","modified_gmt":"2025-11-18T12:29:23","slug":"league-uri-toolkit-7-6-is-out","status":"publish","type":"post","link":"https:\/\/nyamsprod.com\/blog\/league-uri-toolkit-7-6-is-out\/","title":{"rendered":"League URI Toolkit 7.6 is out"},"content":{"rendered":"\n

I am very happy to announce that the League URI toolkit for PHP developers 7.6 has been released!<\/p>\n\n\n\n

If you\u2019re new to the toolkit,\u00a0you may want to start with its\u00a0homepage<\/a>\u00a0to get an overview of what it can do for you.\u00a0The toolkit is made up, currently, of four packages,\u00a0each focused on making URI handling in PHP predictable,\u00a0consistent,\u00a0and developer-friendly.<\/p>\n\n\n\n

This release includes many new features and improvements. Rather than detailing each change here\u2014something the individual package CHANGELOG files already cover thoroughly\u2014I\u2019ll highlight a selection of the most notable additions and fixes:<\/p>\n\n\n\n

PHP8.5<\/h2>\n\n\n\n

A new package, uri-polyfill<\/code>, has been introduced to bring PHP\u2019s new URI extension capabilities to older PHP versions, starting from PHP 8.1<\/code>.<\/p>\n\n\n

\ncomposer install league\/uri-polyfill\n<\/pre><\/div>\n\n\n
On PHP 8.5+<\/code>, the polyfill is not used\u2014even if it is installed. The native PHP URI extension will be used automatically.<\/p>\n\n\n\n
Support for PHP 8.5<\/code> has now landed across all URI packages. They work out of the box on the latest PHP version without deprecations and include seamless support for the new URI extension. The packages do not require the extension to function, but when it\u2019s available, they will integrate with it automatically.<\/p>\n\n\n\n
URI package<\/h2>\n\n\n\n
The league\\uri<\/code> package has now:<\/p>\n\n\n\n
    \n
  • a dedicated League\\Uri\\Urn<\/code> object to improve support for URN;<\/li>\n\n\n\n
  • the League\\Uri\\UriTemplate<\/code> class can now generate PHP Native URI with URI resolution built-in;<\/li>\n\n\n\n
  • URI validation has been improved with:\n
      \n
    • full validation of mailto<\/code> and blob<\/code> URIs;<\/li>\n\n\n\n
    • improved component-based validation for a broader range of scheme URI;<\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • The League\\Uri\\Uri<\/code> class exposes more information around the URI and allows a range of new string representations.<\/li>\n<\/ul>\n\n\n\n
      While still present the BaseUri<\/code> class is deprecated and will be removed from the package in the next major version. It is recommended to use the Uri<\/code> class instead as most of its feature has been backported to it.<\/em><\/p>\n\n\n\n
      URI components package<\/h2>\n\n\n\n
      The league\/uri-components<\/code> package introduces a new TextDirective<\/code> class designed to enhance text-range highlighting within supported browsers.<\/p>\n\n\n\n
      The League\\Uri\\Modifier<\/code> has been enhanced to support modification of the most widely used URI objects in the PHP ecosystem. It now works seamlessly with any PSR-7<\/code> URI implementation, PHP\u2019s native Uri object, and League URI objects. With more than 60 modification methods available, it offers reliable, standard-compliant URI transformations with no loss of information.<\/p>\n\n\n\n
      Migration Guide<\/h2>\n\n\n\n
      The documentation now reflects all the latest enhancements and new features. And because this isn\u2019t a major release, you can enjoy the improvements without needing a migration guide.<\/p>\n\n\n\n
      Give Me Some Code<\/h2>\n\n\n\n
      If everything I\u2019ve explained so far feels too complex or hard to relate to, here\u2019s a concrete example to show what\u2019s now possible with the new versions:<\/p>\n\n\n\n
      First, require the new uri-polyfill<\/code> package and require or update the uri-components<\/code> package.<\/p>\n\n\n
      \ncomposer require league\/uri-polyfill league\/uri-components\n<\/pre><\/div>\n\n\n
      By installing or upgrading the uri-components<\/code> you are also installing\/upgrading the uri<\/code> package.<\/em><\/p>\n\n\n\n
      Then, copy\/paste the following script locally:<\/p>\n\n\n
      \nuse League\\Uri\\Components\\FragmentDirectives\\TextDirective;\nuse League\\Uri\\Modifier;\nuse League\\Uri\\UriTemplate;\n\nrequire 'vendor\/autoload.php';\n\n$uriTemplate = new UriTemplate('{package}\/{version}', ['version' => '7.0']);\n$url = $uriTemplate->expandToUrl(['package' => 'polyfill'], 'https:\/\/uri.thephpleague.com');\n\/\/ $url is a Uri\\WhatWg\\Url instance\n\n$modifier = Modifier::wrap($url)\n    ->addTrailingSlash()\n    ->withFragment(new TextDirective(\n        start: "This package backports",\n        end: "PHP documentation website."\n    ));\n\n$newUri = $modifier->unwrap();\n\/\/ $newUri is a Uri\\WhatWg\\Url instance\necho $newUri->toAsciiString(), PHP_EOL; \n\/\/we are calling a method on the Uri\\WhatWg\\Url\n\/\/if you are on PHP8.5 it will be the native object\n\/\/on PHP8.4- it will be the installed uri-polyfill\n<\/pre><\/div>\n\n\n
      Finally, click or paste the generated link in your favorite browser!<\/p>\n\n\n\n
      Last but not least<\/h2>\n\n\n\n
      Since this is a one-person project, if you notice anything that could be improved in the package or its documentation, please consider opening an issue or submitting a pull request. The URI packages are open-source under the MIT License, and contributions of all kinds are welcome and fully credited. Whether it\u2019s reporting a bug, requesting or implementing a missing feature, fixing a typo, improving the documentation, or sponsoring the project, your support makes a real difference.<\/p>\n\n\n\n
      Happy coding!<\/p>\n","protected":false},"excerpt":{"rendered":"
      The new URI Toolkit for PHP developers is out with full support for PHP8.5, improved URI validation and manipulation.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[5],"tags":[135,870,868,412,872,869,794,871,820,867],"class_list":["post-3073","post","type-post","status-publish","format-standard","hentry","category-web","tag-css","tag-fragment-text-directives","tag-mailto","tag-php","tag-php8-5","tag-text-directives","tag-uri","tag-uri-validation","tag-uri-template","tag-urn"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts\/3073","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/comments?post=3073"}],"version-history":[{"count":5,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts\/3073\/revisions"}],"predecessor-version":[{"id":3079,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts\/3073\/revisions\/3079"}],"wp:attachment":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/media?parent=3073"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/categories?post=3073"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/tags?post=3073"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}