Acorn v6 Released

Acorn v6 is now available, bringing Laravel v13 components to WordPress. This is a straightforward upgrade from Acorn v5. Laravel v13 is an incremental release, so the changes are minimal.

See the full upgrade guide.

What’s new in Acorn v6

Laravel v13 under the hood

Acorn v6 incorporates Laravel v13 components, keeping your WordPress projects on the latest version of the framework.

PHP 8.3+ required

The minimum PHP version has been bumped from 8.2 to 8.3, in line with Laravel 13’s requirements.

Breaking changes

Cache, session, and Redis prefix separators

The default prefix and cookie separators have changed from underscores to hyphens to match Laravel 13 defaults. This will invalidate existing caches and log out all sessions unless you have explicitly set these values via environment variables.

To preserve existing behavior, add these to your .env:

CACHE_PREFIX=your_app_name_cache_
SESSION_COOKIE=your_app_name_session
REDIS_PREFIX=your_app_name_database_

Mail configuration

The SMTP encryption config key has been replaced with scheme. If you are using the MAIL_ENCRYPTION environment variable, rename it to MAIL_SCHEME.

Logging configuration

The stderr channel’s with key has been renamed to handler_with.

Upgrading

Update the roots/acorn dependency in your composer.json:

$ composer require roots/acorn ^6.0 -W

The -W flag is required to upgrade the included Laravel dependencies.

If you have published Acorn’s config files, review and update them based on the latest versions in the Acorn repo. See the Acorn upgrade guide for full details.

Bug fixes from Acorn v5.1.0

Acorn v6 also includes all of the bug fixes shipped in Acorn v5.1.0, which was released last week. Highlights include:

• Fixed database port missing from the WordPress connection config
• Fixed wp_magic_quotes() interfering with HTTP request capture
• Fixed route URL generation by forcing the root URL to home_url()
• Fixed flash session data being lost on WordPress page template requests
• Fixed package manifest discovery for non-Bedrock project structures
• Isolated cache, session, and queue data on multisite installations
• Registered missing queue, schedule, and make:model console commands
• Fixed the acorn binary not working when WP-CLI is installed via Composer