Laravel Tutorials

Laravel Uri toStringable Method

Published
Laravel Uri toStringable Method image

The toStringable() method converts URI objects into Stringable instances, providing direct access to Laravel's string manipulation methods.

Previously, applying string transformations to URI objects required wrapping them with Str::of():

Str::of(Uri::of('http://localhost')->withScheme('https'));

The toStringable() method removes this extra step:

use Illuminate\Support\Uri;
 
Uri::of('http://localhost')->withScheme('https')->toStringable();

This maintains method chaining from URI construction through string operations:

$endpoint = Uri::of('http://api-service.com')
->withPath('/users')
->withQuery(['active' => 1, 'limit' => 25])
->toStringable()
->replace('/users', '/v2/users')
->lower()
->toString();

URL formatting for logging shows string method integration:

$logUrl = Uri::of('http://example.com/endpoint')
->withPath('/api/long/path/resource')
->toStringable()
->limit(40, '...')
->toString();
 
$masked = Uri::of('https://api.service.com/users/12345')
->toStringable()
->mask('*', -5, 5)
->toString();

The method provides access to all Stringable operations including case conversion, truncation, replacement, and masking without breaking the method chain or requiring helper function wrapping.

Harris Raftopoulos photo

Senior Software Engineer • Staff & Educator @ Laravel News • Co-organizer @ Laravel Greece Meetup

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
Screenshot: Capture Images and PDFs with PHP and Laravel image

Screenshot: Capture Images and PDFs with PHP and Laravel

Read article
Reset Sticky Database Connections Between Laravel Queue Jobs image

Reset Sticky Database Connections Between Laravel Queue Jobs

Read article
PHP Security Releases Fix Two Critical RCE Vulnerabilities image

PHP Security Releases Fix Two Critical RCE Vulnerabilities

Read article
Prevent Stale Database Reads in Laravel 13.38 image

Prevent Stale Database Reads in Laravel 13.38

Read article
Critical PHP Security Release Coming Tomorrow (October 21) image

Critical PHP Security Release Coming Tomorrow (October 21)

Read article
Critical Token Guard Auth Bypass Fixed in Laravel 13.29 and 12.68 image

Critical Token Guard Auth Bypass Fixed in Laravel 13.29 and 12.68

Read article