✨ Laravel v13

[retlehs]

Before merge:

• Branch off main and push to 5.x

Ref #521

Upgrading to v6.x from v5.x

Acorn v6 includes Laravel v13 components, whereas Acorn v5 includes Laravel v12 components.

Upgrading dependencies

Acorn v6 requires PHP >= 8.3.

Update the roots/acorn dependency in your composer.json file to ^6.0:

$ composer require roots/acorn ^6.0 -W

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

Breaking changes

Cache, session, and Redis prefix separators

The default prefix/cookie separators have changed from underscores to hyphens to match Laravel 13 defaults. This means:

• Cache prefix: laravel_cache_ → laravel-cache-
• Session cookie: laravel_session → laravel-session
• Redis prefix: laravel_database_ → laravel-database-

This will invalidate existing caches and log out all sessions unless you have explicitly set these values via environment variables (CACHE_PREFIX, SESSION_COOKIE, REDIS_PREFIX).

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 key has been replaced with scheme:

  'smtp' => [
      'transport' => 'smtp',
-     'encryption' => env('MAIL_ENCRYPTION', 'tls'),
+     'scheme' => env('MAIL_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:

  'stderr' => [
      'driver' => 'monolog',
      'handler' => StreamHandler::class,
-     'with' => [
+     'handler_with' => [
          'stream' => 'php://stderr',
      ],
  ],

Config changes

If you have published Acorn's configs, you should review and update them based on the latest versions in the Acorn repo. Notable changes include:

• cache.php: New serializable_classes option
• session.php: New serialization option
• database.php: New Redis retry/backoff keys, SQLite transaction_mode, SSL CA guard updated for PHP 8.5
• mail.php: New resend and roundrobin mailers, retry_after on failover, markdown section removed
• services.php: Postmark and Resend env variable names updated
• All configs: (string) casts added to env() calls per Laravel 13 conventions