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

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article