Question 245383 in PHP Versions Question posted in
You can find a list of all versions here.

Php versions – Error with Doctrine and Laminas: driverClass has to implement the DoctrineDBALDriver interface

I recently upgraded a Laminas project from doctrine-migrations 1.4 to 3.6 and doctrine-orm-module from 1 to 5.3. On my deployment server, when running ./vendor/bin/doctrine-module sync-metadata-storage, I receive the following error:

Fatal error: Uncaught DoctrineDBALException: The given 'driverClass' DoctrineDBALDriverPDOMySqlDriver has to implement the DoctrineDBALDriver interface. in /var/www/vendor/doctrine/dbal/src/Exception.php:98
Stack trace:
#0 /var/www/vendor/doctrine/dbal/src/DriverManager.php(229): DoctrineDBALException::invalidDriverClass('Doctrine\DBAL\D...')
#1 /var/www/vendor/doctrine/dbal/src/DriverManager.php(185): DoctrineDBALDriverManager::createDriver(NULL, 'Doctrine\DBAL\D...')
#2 /var/www/vendor/doctrine/doctrine-orm-module/src/Service/DBALConnectionFactory.php(62): DoctrineDBALDriverManager::getConnection(Array, Object(DoctrineORMConfiguration), Object(DoctrineCommonEventManager))
#3 /var/www/vendor/doctrine/doctrine-module/src/ServiceFactory/AbstractDoctrineServiceFactory.php(41): DoctrineORMModuleServiceDBALConnectionFactory->__invoke(Object(LaminasServiceManagerServiceManager), 'doctrine.connec...')
#4 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineModuleServiceFactoryAbstractDoctrineServiceFactory->__invoke(Object(LaminasServiceManagerServiceManager), 'doctrine.connec...', NULL)
#5 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): LaminasServiceManagerServiceManager->doCreate('doctrine.connec...')
#6 /var/www/vendor/doctrine/doctrine-orm-module/src/Service/RunSqlCommandFactory.php(20): LaminasServiceManagerServiceManager->get('doctrine.connec...')
#7 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineORMModuleServiceRunSqlCommandFactory->__invoke(Object(LaminasServiceManagerServiceManager), 'doctrine.dbal_c...', NULL)
#8 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): LaminasServiceManagerServiceManager->doCreate('doctrine.dbal_c...')
#9 /var/www/vendor/doctrine/doctrine-orm-module/src/CliConfigurator.php(81): LaminasServiceManagerServiceManager->get('doctrine.dbal_c...')
#10 /var/www/vendor/doctrine/doctrine-orm-module/src/Module.php(39): DoctrineORMModuleCliConfigurator->configure(Object(SymfonyComponentConsoleApplication))
#11 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(320): DoctrineORMModuleModule::DoctrineORMModule{closure}(Object(LaminasEventManagerEvent))
#12 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(143): LaminasEventManagerEventManager->triggerListeners(Object(LaminasEventManagerEvent))
#13 /var/www/vendor/doctrine/doctrine-module/src/Service/CliFactory.php(52): LaminasEventManagerEventManager->trigger('loadCli.post', Object(SymfonyComponentConsoleApplication), Array)
#14 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineModuleServiceCliFactory->__invoke(Object(LaminasServiceManagerServiceManager), 'doctrine.cli', NULL)
#15 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): LaminasServiceManagerServiceManager->doCreate('doctrine.cli')
#16 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module.php(44): LaminasServiceManagerServiceManager->get('doctrine.cli')
#17 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module(4): include('/var/www/vendor...')
#18 /var/www/vendor/bin/doctrine-module(120): include('/var/www/vendor...')
#19 {main}
Next LaminasServiceManagerExceptionServiceNotCreatedException: Service with name "doctrine.connection.orm_default" could not be created. Reason: The given 'driverClass' DoctrineDBALDriverPDOMySqlDriver has to implement the DoctrineDBALDriver interface. in /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php:627
Stack trace:
#0 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): LaminasServiceManagerServiceManager->doCreate('doctrine.connec...')
#1 /var/www/vendor/doctrine/doctrine-orm-module/src/Service/RunSqlCommandFactory.php(20): LaminasServiceManagerServiceManager->get('doctrine.connec...')
#2 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineORMModuleServiceRunSqlCommandFactory->__invoke(Object(LaminasServiceManagerServiceManager), 'doctrine.dbal_c...', NULL)
#3 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): LaminasServiceManagerServiceManager->doCreate('doctrine.dbal_c...')
#4 /var/www/vendor/doctrine/doctrine-orm-module/src/CliConfigurator.php(81): LaminasServiceManagerServiceManager->get('doctrine.dbal_c...')
#5 /var/www/vendor/doctrine/doctrine-orm-module/src/Module.php(39): DoctrineORMModuleCliConfigurator->configure(Object(SymfonyComponentConsoleApplication))
#6 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(320): DoctrineORMModuleModule::DoctrineORMModule{closure}(Object(LaminasEventManagerEvent))
#7 /var/www/vendor/laminas/laminas-eventmanager/src/EventManager.php(143): LaminasEventManagerEventManager->triggerListeners(Object(LaminasEventManagerEvent))
#8 /var/www/vendor/doctrine/doctrine-module/src/Service/CliFactory.php(52): LaminasEventManagerEventManager->trigger('loadCli.post', Object(SymfonyComponentConsoleApplication), Array)
#9 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(620): DoctrineModuleServiceCliFactory->__invoke(Object(LaminasServiceManagerServiceManager), 'doctrine.cli', NULL)
#10 /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php(242): LaminasServiceManagerServiceManager->doCreate('doctrine.cli')
#11 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module.php(44): LaminasServiceManagerServiceManager->get('doctrine.cli')
#12 /var/www/vendor/doctrine/doctrine-module/bin/doctrine-module(4): include('/var/www/vendor...')
#13 /var/www/vendor/bin/doctrine-module(120): include('/var/www/vendor...')
#14 {main}
  thrown in /var/www/vendor/laminas/laminas-servicemanager/src/ServiceManager.php on line 627

The odd thing is that this issue doesn’t occur on my local machine, with the same composer.json setup. Both systems are using the same PHP version and extensions.

I’ve tried the typical debugging steps, including clearing various caches, deleting the vendor directories and composer.lock files, and even the entire docker containers on both machines ensuring matching versions between environments, and checking configurations. However, I’m still unable to resolve the issue.

Any hints would be greatly appreciated.

Tags:

2

Answers


  1. 0

    PDOMySqlDriver? Check first, in your Doctrine configuration file (often located in a config directory) that the ‘driverClass‘ parameter is correctly set. Possibly to DoctrineDBALDriverPDOMySqlDriver instead, a class that implements the DoctrineDBALDriver interface.

    'doctrine' => [
    'connection' => [
        'orm_default' => [
            'driverClass' => DoctrineDBALDriverPDOMySqlDriver::class,
        ],
    ],
],

    Then clear the Doctrine cache to ensure that the old configurations are not being used, and regenerate the Composer autoload files to make sure that all the classes are properly autoloaded:

    ./vendor/bin/doctrine-module orm:clear-cache:metadata
composer dump-autoload

    As in "artisan migration error "Class 'Doctrine\DBAL\Driver\PDOMySql\Driver' not found", check your doctrine/dbal version.

    The Driver class exists (in accordance with the error message).
    The doctrine namespace structure apparently has changed at some point, so that now, it really is DoctrineDBALDriverPDOMySQLDriver (instead of ...PDOMySQL...).
    PDOMySqlDriver -> extends DBALDriverAbstractMySQLDriver -> implements DBALDriverVersionAwarePlatformDriver -> extends DBALDriver.

    Clearing the metadata cache unfortunately didn’t help, either.

    Then you would need to debug code directly in the Doctrine and Laminas vendor classes where the exception is being thrown to trace what exactly is going wrong. That is a bit more advanced and requires understanding of the Doctrine internals but might be necessary to diagnose the issue.
    And/or modify the error and exception handlers temporarily to get a more detailed stack trace and to find out what the exact issue is.

    In some scenarios, it might be worth trying to create a namespace alias in your bootstrap file to ensure that Doctrine is correctly recognizing the driver class. That is generally not recommended but might help in diagnosing the issue. Example:

    class_alias('DoctrineDBALDriverPDOMySQLDriver', 'DoctrineDBALDriver');
    Login or Signup to reply.
  2. 0

    You have to Write MySQL with big Q and L:

    So your driver-class must be this line:

    ‘driverClass’ => ‘DoctrineDBALDriverPDOMySQLDriver’,

    Login or Signup to reply.
Please signup or login to give your own answer.

Back To Top
Search