Laravel 11.34: Refining Your Testing Workflow and String Helpers

Overview

Laravel
continues the framework's tradition of polishing the developer experience. This release focuses on reducing boilerplate in tests and expanding the utility of the built-in number helpers. By introducing shorthands for HTTP fakes and more descriptive storage assertions, the framework allows you to write cleaner, more readable code that focuses on intent rather than implementation details.

Prerequisites

To follow this guide, you should have a baseline understanding of the

Laravel
framework, specifically how to use
PHPUnit
 or
Pest
 for testing. Familiarity with
Laravel Facades
 like Storage, Http, and Number is essential.

Key Libraries & Tools

  • Laravel 11.34: The core framework providing these new helpers.
  • Storage Facade: Handles filesystem abstractions and mocking.
  • HTTP Facade: Manages outgoing API requests with powerful testing fakes.
  • Number Helper: A utility class for formatting and manipulating numeric data.

Code Walkthrough

1. Simplified Storage Assertions

Testing file uploads or generated reports becomes faster with the assertCount method. Instead of manually retrieving all files and counting them, you can now verify the state of a disk directly.

Storage::fake('photos');

// ... perform logic that saves 3 files ...

Storage::disk('photos')->assertCount(3);

2. HTTP Fake Shorthands

Previously, faking an

HTTP
response required wrapping your data in Http::response(). Laravel now infers the response type based on the value you provide in the fake array.

Http::fake([
    'api.example.com/*' => ['title' => 'My Fake Podcast'], // Auto-resolves to 200 JSON
    'api.example.com/error' => 500,                         // Auto-resolves to status code
    'api.example.com/text' => 'Plain text response',      // Auto-resolves to string
]);

3. Ordinal Spelling

The Number helper now includes a spellOrdinal method. This combines the logic of converting a number to its ordinal form (1st, 2nd, 3rd) and spelling it out as text.

use Illuminate\Support\Number;

// Returns "forty-seventh"
$result = Number::spellOrdinal(47);

Syntax Notes

Laravel uses Type Inference within the Http::fake() method. If the value is an array, it assumes a JSON response with a 200 status. If it's an int, it treats it as the status code. This removes the need for repetitive

Laravel Facades
calls.

Practical Examples

  • Leaderboards: Use Number::spellOrdinal to display "You finished in twenty-first place" in a user-friendly UI.
  • Data Pipelines: Use Storage::assertCount to ensure a batch process generated exactly the expected number of CSV segments.
  • API Integration: Quickly mock external services by returning raw arrays in your test setup, keeping the "Arrange" section of your tests concise.

Tips & Gotchas

When using the HTTP shorthands, remember that returning an int will result in an empty response body with that status code. If you need a specific body and a non-200 status code, you must still use the full Http::response($body, $status) syntax to avoid ambiguity.

3 min read