Health Check Error: Use of Outdated DBAL Functionality

Overview

The Health Check wizard must be run when upgrading to evaluate your instance's ability to move to the target version. During the health check, various types of issues may be detected, which can affect your ability to upgrade. This article will cover how to resolve a "Use of outdated DBAL functionality" error reported by the health check.

Symptoms

This error generates the warning, "Use of outdated DBAL functionality", in health check.

Resolution

In Sugar 12.3 (Q1 2023), Sugar upgraded from Doctrine DBAL 2.x to 3.x. Significant changes exist between Doctrine DBAL 2.x to 3.x that require attention and possible refactoring of your customizations. The Sugar upgrader was configured to identify known incompatibilities with Doctrine DBAL 3.x that will need to be fixed before proceeding with the upgrade.

The upgrader will generate a health check error if it encounters anything unusual such as an outdated DBAL functionality. Please refer to the Developer Blog in the SugarClub community for additional information and the steps needed to resolve this health check error.