Laravel News Laravel News
News

JSON Unicode Cast Type Added in Laravel 12.3

Published
JSON Unicode Cast Type Added in Laravel 12.3 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v12.3.0, which includes a new JSON Unicode cast type, check linked storage status in the about command, native JSON and JSONB support in SQLite schemas, and more.

JSON Unicode Cast Type

@fuwasegu contributed a new json:unicode cast type for Eloquent attributes that allows JSON encoding with JSON_UNESCAPED_UNICODE:

protected $casts = [
    'data' => 'json:unicode',
];

The Pull Request #54992 description explains when you might prefer this cast over the json cast:

This [cast] makes it easier to store and retrieve JSON data without Unicode escaping (\uXXXX), which is particularly useful for applications that handle non-ASCII characters like Japanese, Chinese, or emojis.

Currently, Eloquent's json cast escapes Unicode characters by default, making JSON-encoded attributes harder to read for humans and increasing the need for manual decoding. Developers often work around this by overriding accessors/mutators or manually using json_encode()...

Add "Storage Linked" Check to the about Command

Adam Patterson contributed a section to the artisan about command that shows the status of filesystems links. Given the following links in the filesystem.php configuration file:

// config/filesystem.php
return [
    'links' => [
        public_path('storage') => storage_path('app/public'),
        public_path('images') => storage_path('app/images'),
    ],
];

The artisan about command will show the status of these links:

$ php artisan about
 
Storage
public/images ................................................... NOT LINKED
public/storage .................................................. LINKED

Native JSON and JSONB Column Types in SQLite Schema

@fuwasegu contributed support for JSON and JSONB column types in SQLite schemas:

SQLite has supported JSON data type as a built-in feature since version 3.38.0, but prior to that, users needed to opt-in by installing an extension. Additionally, native support for JSONB type began with version 3.45.

Since Laravel 12 supports SQLite 3.26.0 and above, it should not be designed with the assumption that JSON/JSONB support is always available. While Query\Grammars\SQLiteGrammar includes support for JSON functions, Schema\Grammars\SQLiteGrammar does not offer this option. This Pull request allows injecting configuration from the database connection config to enable the use of native JSON columns when defining Schema.

Here are the configuration options:

'sqlite' => [
    'driver' => 'sqlite',
    'url' => env('DATABASE_URL'),
    ...,
    'use_native_json' => true,
    'use_native_jsonb' => true,
],

This pull request does not change the default, however, if you want to use native JSON or JSONB columns, you can enable these options in your connection. See Pull Request #54991 for implementation details and discussion.

Support for PostgreSQL "unique nulls not distinct"

Thierry Parent contributed support for PostgreSQL (>= 15) unique nulls not distinct when building unique indexes:

By adding support for a new nullsNotDistinct() fluent index definition method (see the unit tests for some examples) when using the postgres database driver (or more precisely when using the Postgres schema grammar).

Release notes

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

v12.3.0

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 →
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