Working With URIs in Laravel

Laravel 11.35 introduces the Uri class based on the PHP League URI library. Uri Simplifies the process of manipulating and processing URIs in Laravel applications and provides some convenient features about named routing.

Basic Operations

The core function of the

Uri class is to create and manipulate URI strings, including queries, fragments, and paths:

use Illuminate\Support\Uri;

$uri = Uri::of('https://laravel-news.com')
    ->withPath('links')
    ->withQuery(['page' => 2])
    ->withFragment('new');

(string) $url; // https://laravel-news.com/links?page=2#new

$uri->path(); // links
$uri->scheme(); // https
$uri->port(); // null
$uri->host(); // laravel-news.com

Please note the difference between getting URI value and decoding URI:

Basic URI operations, values, and decoding examples.

Query assertions and operations

In Laravel, using the underlying UriQueryString to assert and manipulate URI query parameters has never been easier. UriQueryString Class uses support features InteractsWithData, which provides you with a bunch of useful methods for asserting query strings:

use Illuminate\Support\Uri;

$uri = Uri::of("https://laravel-news.com")
    ->withPath("links")
    ->withQuery(["page" => 2, 'name' => ''])
    ->withFragment("new");

$uri->query()->all(); // ["page" => "2"]

$uri->query()->hasAny("page", "limit"); // true
$uri->query()->has("name"); // true
$uri->query()->has('limit'); // false
$uri->query()->missing('limit'); // true

$uri->query()->filled('page'); // true
$uri->query()->filled("name"); // false
$uri->query()->isNotFilled("name"); // true
$uri->query()->isNotFilled("page"); // false

$uri->query()->string("page", "1"); // Stringable{ value: 2 }
$uri->query()->integer("limit", 10); // 10

Learn all the useful methods provided for InteractsWithData for UriQueryString instances for asserting and manipulating query data.

Get Uri instance from named routes, paths, and current request

The

Uri class can also create URIs from named routes, relative URLs, and even the current Request instance in the application:

// 使用命名路由
(string) Uri::route("dashboard"); // http://laravel.test/dashboard

// 使用根相对 URL
(string) Uri::to("/dashboard"); // http://laravel.test/dashboard

// 从当前请求
function (Request $request) {
    (string) $request->uri(); // http://laravel.test/dashboard
}

Starting in Laravel 11.36, the Uri class is aliased by default in Laravel applications, meaning you can use it without importing the IlluminateSupportUri namespace.

Learn more

We hope you enjoy using Uri in the Laravel app! The Uri class is published in #53731 of Laravel 11.35. Also, read about InteractsWithData, which provides many useful methods for handling Uri classes, Fluent classes, and Laravel's HTTP request classes (via InteractsWithInput).

The above is the detailed content of Working With URIs in Laravel. For more information, please follow other related articles on the PHP Chinese website!