Issue Task Closed

#78140Disable APCu on CLI, if it was added to LocalConfiguration.php automatically while installing TYPO3

Josef Glatz 10/04/16, 10:25 updated 04/12/25, 18:22

Description

Problem/Description

I needed a few hours until I understood/find that a cacheConfiguration is added to LocalConfiguration (see below) if APCu is detected.

       'caching' => [
            'cacheConfigurations' => [
                'extbase_object' => [
                    'backend' => 'TYPO3\\CMS\\Core\\Cache\\Backend\\ApcuBackend',
                    'frontend' => 'TYPO3\\CMS\\Core\\Cache\\Frontend\\VariableFrontend',
                    'groups' => [
                        'system',
                    ],
                    'options' => [
                        'defaultLifetime' => 0,
                    ],
                ],
            ],
        ],

The big problem

There is no information or additional code added, which automatically disables APCu on CLI. If you are not deep into what APCu is or what TYPO3 do while installing the instance, you can freak out ;-)

After finishing the install wizard, the install tool DB Compare shows you

 ALTER TABLE cf_extbase_object RENAME TO zzz_deleted_cf_extbase_object
 ALTER TABLE cf_extbase_object_tags RENAME TO zzz_deleted_cf_extbase_object_tags

which could also be very confusing.

—-

Acceptance Criteria

Possible scenario 1)

A TYPO3 integrator should get informed about what is added to LocalConfiguration automatically by the TYPO3 install process and what he has to do if he run CLI tasks/extbase command controllers.

Possible scenario 2)

An automatically added cacheConfiguration is automatically added to AdditionalConfiguration.php and wrapped into an if with a condition something like PHP_SAPI == 'cli' (or whatever is enough to fix CLI)

Possible scenario 3)

Such cache backends, which are known to not work in CLI mode must be disabled transparent.

Reviews 1

History 1114

  1. Gerrit Code Review pushed patch set 1 for master to change 50089 status New Under Review <span data-processor="relativetime" data-value="2016-10-04T19:16:51+00:00" > 10/04/16, 19:16 </span>

  2. Josef Glatz changed description target version Sprint Focus Stabilization Sprint <span data-processor="relativetime" data-value="2017-02-17T21:31:58+00:00" > 02/17/17, 21:31 </span>

  3. David Henninger commented <span data-processor="relativetime" data-value="2017-05-09T09:54:21+00:00" > 05/09/17, 09:54 </span>

    Once the APCu backend is enabled, the scheduler no longer works when called by PHP CLI, as Typo3 tries to use APCu, which is not available with CLI, causing the following error:

    The APCu backend cannot be used because apcu is disabled on CLI.

    apc.enabled does not enable APCu for CLI and there isn’t a documented option to enable it either: https://secure.php.net/manual/en/apcu.configuration.php
    However, the old option of its ancestor (apc.enable_cli) still works, however it is not recommend according to the old documentation: https://secure.php.net/manual/en/apc.configuration.php#ini.apc.enable-cli

    Typo3 should not rely on APCu with PHP CLI as the parser.

  4. Josef Glatz commented and changed target version TYPO3 Version 8 9 <span data-processor="relativetime" data-value="2018-02-27T21:19:41+00:00" > 02/27/18, 21:19 </span>

    Problem still exists in 9.2-dev

  5. Dirk Wenzel commented <span data-processor="relativetime" data-value="2019-01-16T13:18:32+00:00" > 01/16/19, 13:18 </span>

    IMHO this solution should be available as bugfix for TYPO3 8 too.

    see: https://forge.typo3.org/issues/82621

  6. Georg Ringer commented and changed status New Closed <span data-processor="relativetime" data-value="2025-04-12T18:22:53+00:00" > 04/12/25, 18:22 </span>

    closing issue as apcu can also be enabled on CLI and I haven’t seen any issues in the last years here about the problem.