ManagedEntities - Allow "match" param to convert existing records to …

[colemanw]

Overview

This can help ease the pain of declaring managed entities which may or may not already exist - now they can be matched by name or other unique identifier.

Before

An increasingly common scenario is to want to use the CiviCRM_Managed subsystem to declare entities which were previously created in some other way. For example, an extension may have inserted a record into the database during the install process. Later on, it seems like a good idea to move it into a .mgd.php file instead, but what to do about existing sites which have already run the installer?

After

Setting the match param will cause CiviCRM_Managed to look for an existing record before inserting a new one.

[civibot]

(Standard links)

• If this is your first pull-request for CiviCRM, please browse CONTRIBUTING.md for information about the development and testing processes.
• If you are reviewing this pull-request, you may wish to consult the test sites and the Review Standards (long template, short template).

[jmcclelland]

+1 Yes, this is really useful. I just tried backporting it our 5.45 install and my extension that was failing this morning. And, IT WORKS! Thanks @Coleman.

[totten]

Thanks for testing, @jmcclelland!

I like the concept, too, and the phpunit coverage looks pretty sensible.

Merging.

We'll need an update for https://docs.civicrm.org/dev/en/stable/hooks/hook_civicrm_managed/ -- but that can be post-merge.

[colemanw]

Docs update is here: https://lab.civicrm.org/documentation/docs/dev/-/merge_requests/988