Issue Bug Closed

#107466[redis] Session handler is not configured properly: Unknown named parameter $sessionPath

Benjamin Franzke 09/17/25, 07:04 updated 12/02/25, 13:04

Description

When using the redis configuration as described in

https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/14.0/Feature-101059-AddRedisSessionHandlerInstallTool.html#example

// config/system/settings.php
return [
    'BE' => [
        'installToolSessionHandler' => [
            'className' => \TYPO3\CMS\Install\Service\Session\RedisSessionHandler::class,
            'options' => [
                'host' => '127.0.0.1',
                'port' => 6379,
                'database' => 0,
                'authentication' => [
                    'user' => 'redis',
                    'pass' => 'redis'
                ]
            ]
        ]
    ]
];

via system/settings.php (important on this file is affected, additional.php works),

the default configuration and this redis configuration are merged which means that redis and file session handler options are defined:

installToolSessionHandler
  className = TYPO3\CMS\Install\Service\Session\RedisSessionHandler
  options
    authentication
      pass = redis
      user = redis
      database = 0
      host = 127.0.0.1
      port = 6379
      sessionPath = /var/www/…/session

You see that $sessionPath is added because it is configured in DefaultConfiguration.php which ultimately resolves in a constructor error which is (thankfully!) logged as:

Wed, 17 Sep 2025 08:51:33 +0200 [ERROR] request="bb869bc0ecc7a" component="TYPO3.CMS.Install.Service.SessionService":
Session handler is not configured properly: Unknown named parameter $sessionPath

Also see https://review.typo3.org/c/Packages/TYPO3.CMS/+/89992/comment/8b2e9e6b_9de75fd0/

Reviews 1