Laravel News Laravel News
News

JSON:API Resource in Laravel 12.45

Published
JSON:API Resource in Laravel 12.45 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released version 12.45, featuring a JsonApiResource, an AsBinary castable class, a cloud storage email attachment helper, and more.

JSON:API Resource

Mior Muhammad Zaki contributed a JsonApiResource that allows you to output API resources using the JSON:API specification instead of the normal JsonResource:

use Illuminate\Http\Resources\JsonApi\JsonApiResource;
 
class UserResource extends JsonApiResource {}

You can create JSON API resources using the make:resource command with the --json-api flag:

php artisan make:resource PostResource --json-api

See Pull Request #57571 for implementation details.

AsBinary Castable Class

Kacper Pruszyński contributed a AsBinary cast which stores values as binary bytes and exposes them as a string in PHP:

protected function casts(): array
{
    return [
        'id' => AsBinary::uuid(isRequired: true),
        'public_id' => AsBinary::ulid(), // optional by default
        'custom' => AsBinary::of('xor1', false),
    ];
}

See Pull Request #58254 for implementation details.

Attachment Helper from Cloud Storage

Philo Hermans contributed a fromCloudStorage() attachment method, which makes it easier to add attachments to emails that are stored on the cloud:

// Before:
Attachment::fromStorageDisk(Storage::getDefaultCloudDriver(), $attachment->path);
 
// After:
Attachment::fromCloudStorage($attachment->path);

See Pull Request #58201 for implementation details.

BackedEnum Support for Session Keys

Andy Hinkle contributed enum support for session keys, allowing you to pass the enum instead of the string value. This is in line with many other areas of the framework:

enum CheckoutSession: string
{
    case Cart = 'checkout.cart';
    case ShippingAddress = 'checkout.shipping_address';
    case PaymentMethod = 'checkout.payment_method';
}
 
// Before
session()->put(CheckoutSession::Cart->value, $items);
session()->get(CheckoutSession::Cart->value);
 
// After (>=12.45)
session()->put(CheckoutSession::Cart, $items);
session()->get(CheckoutSession::Cart);

See Pull Request #58241 for implementation details.

Allow BackedEnum for Cache Keys

Similar to Enum support for Session keys, Jack Bayliss contributed BackedEnum support for cache keys:

// Before
Cache::put(AnalyticalGraph::PROFILE->value, $result);
 
// After
Cache::put(AnalyticalGraph::PROFILE, $result);

See Pull Request #58246 for implementation details.

Mark Email as Unverified

Ali Khosrojerdi contributed a markEmailAsUnverified() method to compliment the markEmailAsVerified() method to reset email verification for a model record:

$user->markEmailAsUnverified();

See Pull Request #58255 for implementation details.

Add --readable flag to env:encrypt for Visible Key Names

Mathias Grimm contributed a --readable flag to the env:encrypt command:

This adds a new --readable flag to the env:encrypt command that produces a line-by-line encrypted format where variable names remain visible but values are encrypted. This allows developers to see what environment variables exist without exposing sensitive data, and makes pull requests easier to review since reviewers can see which variables were added, removed, or renamed without needing to decrypt the file.

See Pull Request #58262 for implementation details.

v12.45.0 Release notes

You can see the complete list of new features and updates below and the diff between 12.44.0 and 12.45.0 on GitHub. The following release notes are directly from the changelog:

v12.45.0 Changelog

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

X X Github Github
Filed in
News Laravel Releases

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
The Laracon Archive image

The Laracon Archive

Read article
Group Adjacent Collection Items in Laravel with chunkBy() image

Group Adjacent Collection Items in Laravel with chunkBy()

Read article
Laravel queue:work Now Prints Why the Worker Stopped image

Laravel queue:work Now Prints Why the Worker Stopped

Read article
Sidecar Brings Statamic's Control Panel to Your Existing Markdown Sites image

Sidecar Brings Statamic's Control Panel to Your Existing Markdown Sites

Read article
Collections chunkBy() and Storage Path Hardening in Laravel 13.30 image

Collections chunkBy() and Storage Path Hardening in Laravel 13.30

Read article
Forte: Parse and Rewrite Laravel Blade Templates image

Forte: Parse and Rewrite Laravel Blade Templates

Read article