Summary:

This PR provides the following improvements & benefits around regions:

• Updated list of all iso regions known to Matomo
• Accurancy of region detection with DB IP Lite database is increased
• Updating the list of iso regions will no longer cause revised regions to no longer be displayed correctly in older datasets

Description:

The DB-IP lite database, which Matomo is currently using as default, does only provide region names in it's detection (no iso codes).
As Matomo only stores region codes in the database, we are trying to match the returned region name to the region names that Matomo knows about. This might fail if the region name returned by the geoip database doesn't match a known name, which actually seems to be the case quite often.

To improve the region detection, this PR adjusts the lists of known regions. Instead of only holding the latest set of iso region codes mapped to there current name, the array now looks like this:

 <CountryCode> => [
     <RegionCode> => [
         'name' => <CurrentISOName>
         'altNames' => [
             // list of previous names or names used by GeoIP providers like db-ip
         ],
         'current' => <bool> indicating if the iso code is currently used
     ]
]

By providing a list of alternate names it will in the future increase the accurancy when trying to match regions by its name.

To properly fill this new strutuce the command to update the region list has been adjusted. It now also includes an additional option to add names used in db ip database, that don't match known region names.

The region list included in this PR was built with this steps:

• Initial creation of the region list using an older version of the iso-codes project (so older names and regions are included)
• Update the list with the latest revision of iso-codes (so we have the latest set as current, but still older names as alternate names)
• Enrich regions and alternate names with the latest version of db ip databases

fixes #20527
refs #20368

Review

• Functional review done
• Potential edge cases thought about (behavior of the code with strange input, with strange internal state or possible interactions with other Matomo subsystems)
• Usability review done (is anything maybe unclear or think about anything that would cause people to reach out to support)
• Security review done
• Wording review done
• Code review done
• Tests were added if useful/possible
• Reviewed for breaking changes
• Developer changelog updated if needed
• Documentation added if needed
• Existing documentation updated if needed