Skip to content

Fix Patch aliases usage (issue #31396) #38239

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 20 commits into
base: 2.4-develop
Choose a base branch
from

Conversation

thomas-kl1
Copy link
Member

@thomas-kl1 thomas-kl1 commented Dec 1, 2023

Description (*)

Currently the aliases are useless and have no meaningful usage in codebase.

See documentation: https://developer.adobe.com/commerce/php/development/components/declarative-schema/patches/

public function getAliases()
{
/**
* This internal method, that means that some patches with time can change their names,
* but changing name should not affect installation process, that's why if we will change name of the patch
* we will add alias here
*/
return [];

Fixed Issues (if relevant)

  1. Fixes [Magento 2.3.x] Data/Schema Patches getAliases() causes errors during setup:upgrade #31396
  2. Fixes [Magento 2.3.x] Declarative Schema :: Data/Schema Patches getAliases() not working as expected #23031

Manual testing scenarios (*)

  1. Add a patch with aliases

  2. None of the aliases must exists in db

  3. Run setup:upgrade

  4. The patch and its aliases are added to patch_list table

  5. Add a patch with aliases

  6. Any of its aliases must exists in db

  7. Run setup:upgrade

  8. The patch is not ran because it's already applied previously by one of its aliases

Questions or comments

I did not edit the \Magento\Framework\Setup\Patch\PatchHistory::isApplied for BC purpose.
However it would have been better to have this method updated to get a PatchInterface as an argument and check for its aliases there.

A similarity attempt was tried here:#37682 but can be ignored

Contribution checklist (*)

  • Pull request has a meaningful description of its purpose
  • All commits are accompanied by meaningful commit messages
  • All new or changed code is covered with unit/integration tests (if applicable)
  • README.md files for modified modules are updated and included in the pull request if any README.md predefined sections require an update
  • All automated tests passed successfully (all builds are green)

Copy link

m2-assistant bot commented Dec 1, 2023

Hi @thomas-kl1. Thank you for your contribution!
Here are some useful tips on how you can test your changes using Magento test environment.

Add the comment under your pull request to deploy test or vanilla Magento instance:
  • @magento give me test instance - deploy test instance based on PR changes
  • @magento give me 2.4-develop instance - deploy vanilla Magento instance

❗ Automated tests can be triggered manually with an appropriate comment:

  • @magento run all tests - run or re-run all required tests against the PR changes
  • @magento run <test-build(s)> - run or re-run specific test build(s)
    For example: @magento run Unit Tests

<test-build(s)> is a comma-separated list of build names.

Allowed build names are:
  1. Database Compare
  2. Functional Tests CE
  3. Functional Tests EE
  4. Functional Tests B2B
  5. Integration Tests
  6. Magento Health Index
  7. Sample Data Tests CE
  8. Sample Data Tests EE
  9. Sample Data Tests B2B
  10. Static Tests
  11. Unit Tests
  12. WebAPI Tests
  13. Semantic Version Checker

You can find more information about the builds here
ℹ️ Run only required test builds during development. Run all test builds before sending your pull request for review.


For more details, review the Code Contributions documentation.
Join Magento Community Engineering Slack and ask your questions in #github channel.

@m2-github-services m2-github-services added Partner: Dn’D partners-contribution Pull Request is created by Magento Partner labels Dec 1, 2023
@m2-community-project m2-community-project bot added Priority: P3 May be fixed according to the position in the backlog. Severity: S3 Affects non-critical data or functionality and does not force users to employ a workaround. Progress: pending review labels Dec 1, 2023
@thomas-kl1
Copy link
Member Author

@magento run all tests

Copy link

The requested builds are added to the queue. You should be able to see them here within a few minutes. Please message the #magento-devops slack channel if they don't show in a reasonable amount of time and a representative will look into any issues.

@thomas-kl1 thomas-kl1 changed the title WP: Fix issue #31396 Fix Patch aliases usage (issue #31396) Dec 1, 2023
@thomas-kl1
Copy link
Member Author

@magento run all tests

Copy link

The requested builds are added to the queue. You should be able to see them here within a few minutes. Please message the #magento-devops slack channel if they don't show in a reasonable amount of time and a representative will look into any issues.

@thomas-kl1
Copy link
Member Author

@magento run all tests

Copy link

The requested builds are added to the queue. You should be able to see them here within a few minutes. Please message the #magento-devops slack channel if they don't show in a reasonable amount of time and a representative will look into any issues.

@thomas-kl1
Copy link
Member Author

@magento run all tests

Copy link

The requested builds are added to the queue. You should be able to see them here within a few minutes. Please message the #magento-devops slack channel if they don't show in a reasonable amount of time and a representative will look into any issues.

@thomas-kl1
Copy link
Member Author

Functional tests failures are not related to the PR.
Unit test must be updated accordingly.

@thomas-kl1
Copy link
Member Author

@magento run all tests

Copy link

The requested builds are added to the queue. You should be able to see them here within a few minutes. Please message the #magento-devops slack channel if they don't show in a reasonable amount of time and a representative will look into any issues.

@thomas-kl1
Copy link
Member Author

@magento run all tests

Copy link

The requested builds are added to the queue. You should be able to see them here within a few minutes. Please message the #magento-devops slack channel if they don't show in a reasonable amount of time and a representative will look into any issues.

@thomas-kl1
Copy link
Member Author

@engcom-Hotel

Regarding static test failures, it's related to the copyright header change, I'll check, could you give the new copyright to apply please?
https://public-results-storage-prod.magento-testing-service.engineering/reports/magento/magento2/pull/38239/079f4563d120ab5795fb65006c654d26/Statics/console-error-logs.html

Units tests failure are not related to this PR and seems related to RMA changes (not in scope of this PR):
https://public-results-storage-prod.magento-testing-service.engineering/reports/magento/magento2/pull/38239/5da9f12d3970de433b743d636689530d/Unit/console-error-logs.html

Webapi tests, I dont see how it's related to this PR change 🤔

Functional tests, I dont see how it's related to this PR change 🤔

@thomas-kl1
Copy link
Member Author

@magento run all tests

@ct-prd-projects-boards-automation ct-prd-projects-boards-automation bot moved this from Changes Requested to Ready for Testing in Community Dashboard Jul 2, 2025
@ct-prd-projects-boards-automation ct-prd-projects-boards-automation bot moved this from Ready for Testing to Review in Progress in Community Dashboard Jul 2, 2025
@engcom-Hotel engcom-Hotel moved this from Review in Progress to Ready for Testing in Community Dashboard Jul 2, 2025
@engcom-Bravo engcom-Bravo added the Triage: Dev.Experience Issue related to Developer Experience and needs help with Triage to Confirm or Reject it label Jul 3, 2025
@engcom-Charlie engcom-Charlie self-assigned this Jul 3, 2025
@ct-prd-projects-boards-automation ct-prd-projects-boards-automation bot moved this from Ready for Testing to Testing in Progress in Community Dashboard Jul 3, 2025
@engcom-Charlie
Copy link
Contributor

Hi @thomas-kl1,

Thank you for your contribution!

I have followed below steps in order to reproduce the test the PR.

✔️ QA Passed

Before PR ✖️ 

  1. Create a patch called 'ExampleDataPatch' with no aliases
class ExampleDataPatch implements DataPatchInterface
{
    /**
     * @var ModuleDataSetupInterface
     */
    private $moduleDataSetup;


    /**
     * @var LoggerInterface
     */
    private $logger;

    public function __construct(
        ModuleDataSetupInterface $moduleDataSetup,
        LoggerInterface $logger
    ) {
        $this->moduleDataSetup = $moduleDataSetup;
        $this->logger = $logger;
    }
    
    public function apply()
    {
        $this->moduleDataSetup->startSetup();
        $this->logger->info('ExampleSchemaPatch: Apply method executed.');
        $this->moduleDataSetup->endSetup();
    }
    
    public static function getDependencies()
    {
        return [];
    }
    
    public function getAliases()
    {
        return [];
    }
}
  1. Run bin/magento setup:upgrade, patch ExampleDataPatch gets applied and 'ExampleDataPatch' is added to the patch_list table
  2. Rename patch ExampleDataPatch file and class name to 'ChangedExampleDataPatch'
  3. Add 'ExampleDataPatch' to the aliases
public function getAliases()
    {
        return [
            ExampleDataPatch::Class
        ];
    }
  1. Run bin/magento setup:upgrade again, patch ExampleDataPatch gets applied again verified it from log file and 'ChangedExampleDataPatch' is added to the patch_list table
image image

After PR Changes ✔️

  1. Followed step 1-6 as above
  2. Run bin/magento setup:upgrade again, patch ExampleDataPatch didn't get applied again verified from log file and ChangedExampleDataPatch is getting added to the patch_list table.
image image

As the build is failing, moving this PR to Extended Testing.

@engcom-Charlie engcom-Charlie moved this from Testing in Progress to Extended testing (optional) in Community Dashboard Jul 7, 2025
@engcom-Charlie
Copy link
Contributor

@magento run all tests

@engcom-Charlie
Copy link
Contributor

@magento run Functional Tests B2B, Functional Tests EE

@thomas-kl1
Copy link
Member Author

@engcom-Charlie the integration tests failures are not related to these changes.

@engcom-Charlie
Copy link
Contributor

@magento run all tests

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Priority: P3 May be fixed according to the position in the backlog. Progress: testing in progress Project: Community Picked PRs upvoted by the community Severity: S3 Affects non-critical data or functionality and does not force users to employ a workaround. Triage: Dev.Experience Issue related to Developer Experience and needs help with Triage to Confirm or Reject it
Projects
Status: Extended testing (optional)
7 participants