Keeping Compatibility

Rafael Fernandes — Mon, 17 Mar 2025 13:08:01 GMT

Current Revision posted to Dev Tutorials by Rafael Fernandes on 3/17/2025 1:08:01 PM

Ensuring compatibility is crucial for delivering a top-notch product, and with Rector, this can be achieved by configuring Rector Rulesets.

To adhere to best practices, Sugar advises developers to write their customizations using the latest version of Sugar Supported PHP and making sure that backward compatibility is maintained using Rector.

It is important to note that some Sugar customers may still be operating on older versions of Sugar on their on-premise instances, which should be taken into consideration when determining the appropriate PHP version to use for customizations.

Recommended Approaches

You have two distinct approaches to ensure the compatibility of your customizations. The recommended method involves coding your customizations in PHP 8.3 and utilizing rector to ensure backward compatibility. Alternatively, you can adopt the second approach by adding configsets to your configuration to address only the breaking changes between versions.

Code in PHP8.3 and make it backward compatible by downgrading to PHP 7.4

Modify rector.php to make sure that the code is still compatible with PHP 7.4, and replace the “UP_TO_PHP_83“ and “PHP_83“ rule sets with 7.4 ones:

    $rectorConfig->sets([
        \Rector\Set\ValueObject\DowngradeLevelSetList::DOWN_TO_PHP_74,
        \Rector\Set\ValueObject\DowngradeSetList::PHP_74,
    ]);

At this point, you can now follow the Execute Rector making sure you keep git updated so you don't lose track of what has changed between PHP versions.

Make upward compatible by refactoring Incompatibilities Only

We have provided a configset to enable you to maintain your code compatible from PHP7.4 to PHP8.3 where Rector will only modify your code for breaking changes between those versions.

You do not need to downgrade and upgrade but just keep your code safely compatible by using either this or this configset.

Keeping Compatibility

Rafael Fernandes — Tue, 05 Dec 2023 19:20:14 GMT

Revision 3 posted to Dev Tutorials by Rafael Fernandes on 12/5/2023 7:20:14 PM

Ensuring compatibility is crucial for delivering a top-notch product, and with Rector, this can be achieved by configuring Rector Rulesets.

Recommended Approaches

You have two distinct approaches to ensure the compatibility of your customizations. The recommended method involves coding your customizations in PHP 8.2 and utilizing rector to ensure backward compatibility. Alternatively, you can adopt the second approach by adding configsets to your configuration to address only the breaking changes between versions.

Code in PHP8.2 and make it backward compatible by downgrading to PHP 7.4

Modify rector.php to make sure that the code is still compatible with PHP 7.4, and replace the “UP_TO_PHP_82“ and “PHP_82“ rule sets with 7.4 ones:

    $rectorConfig->sets([
        \Rector\Set\ValueObject\DowngradeLevelSetList::DOWN_TO_PHP_74,
        \Rector\Set\ValueObject\DowngradeSetList::PHP_74,
    ]);

At this point, you can now follow the Execute Rector making sure you keep git updated so you don't lose track of what has changed between PHP versions.

Make upward compatible by refactoring Incompatibilities Only

We have provided a configset to enable you to maintain your code compatible from PHP7.4 to PHP8.2 where Rector will only modify your code for breaking changes between those versions.

You do not need to downgrade and upgrade but just keep your code safely compatible by using either this or this configset.

Keeping Compatibility

Rafael Fernandes — Thu, 07 Sep 2023 15:33:56 GMT

Revision 2 posted to Dev Tutorials by Rafael Fernandes on 9/7/2023 3:33:56 PM

Ensuring compatibility is crucial for delivering a top-notch product, and with Rector, this can be achieved by configuring Rector Rulesets.

Downgrade to PHP 7.4

Modify rector.php to make sure that the code is still compatible with PHP 7.4, and replace the “UP_TO_PHP_82“ and “PHP_82“ rule sets with 7.4 ones:

    $rectorConfig->sets([
        \Rector\Set\ValueObject\DowngradeLevelSetList::DOWN_TO_PHP_74,
        \Rector\Set\ValueObject\DowngradeSetList::PHP_74,
    ]);

At this point, you can now follow the Execute Rector making sure you keep git updated so you don't loose track of what has changed between PHP versions.

Incompatibilities Only

We have provided a configset to enable you to maintain your code compatible from PHP7.4 to PHP8.2 where Rector will only modify your code for breaking changes between those versions.

You do not need to downgrade and upgrade but just keep your code safely compatible by using either this or this configset.

Keeping Compatibility

Rafael Fernandes — Thu, 20 Apr 2023 14:33:06 GMT

Revision 1 posted to Dev Tutorials by Rafael Fernandes on 4/20/2023 2:33:06 PM

Ensuring compatibility is crucial for delivering a top-notch product, and with Rector, this can be achieved by configuring Rector Rulesets.

Downgrade to PHP 7.4

Modify rector.php to make sure that the code is still compatible with PHP 7.4, and replace the “UP_TO_PHP_82“ and “PHP_82“ rule sets with 7.4 ones:

    $rectorConfig->sets([
        \Rector\Set\ValueObject\DowngradeLevelSetList::DOWN_TO_PHP_74,
        \Rector\Set\ValueObject\DowngradeSetList::PHP_74,
    ]);

At this point, you can now follow the Execute Rector making sure you keep git updated so you don't loose track of what has changed between PHP versions.