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

acquaintsoft logo
Acquaint Softtech

Hire Laravel developers with AI expertise at $20/hr. Get started in 48 hours.

Visit Acquaint Softtech

The latest

View all →
Laravel Image Responses: Serve Resized Images From Routes image

Laravel Image Responses: Serve Resized Images From Routes

Read article
Pause All Laravel Queues During a Deploy image

Pause All Laravel Queues During a Deploy

Read article
Laravel Terminal UI for the artisan dev Command image

Laravel Terminal UI for the artisan dev Command

Read article
Pause All Queues and a New artisan dev UI in Laravel 13.25 image

Pause All Queues and a New artisan dev UI in Laravel 13.25

Read article
Laravel monitoring that doesn't bill you by your traffic image

Laravel monitoring that doesn't bill you by your traffic

Read article
Mock PHP Classes in Tests With the Double Library image

Mock PHP Classes in Tests With the Double Library

Read article