cancel
Showing results for 
Search instead for 
Did you mean: 

Is the Url class docstring up to date and accurate in Magento 2.4?

Is the Url class docstring up to date and accurate in Magento 2.4?

The Url class (vendor/magento/framework/Url.php) has the following text in its docstring:

 * URL structure:
 *
 * https://user:password@host:443/base_path/[base_script][scopeview_path]route_name/controller_name/action_name/param1/value1?query_param=query_value#fragment
 *       \__________A___________/\____________________________________B_____________________________________/
 * \__________________C___________________/              \__________________D_________________/ \_____E_____/
 * \_____________F______________/                        \___________________________G______________________/
 * \___________________________________________________H____________________________________________________/
 *
 * - A: authority
 * - B: path
 * - C: absolute_base_url
 * - D: action_path
 * - E: route_params
 * - F: host_url
 * - G: route_path
 * - H: route_url

This is informative, but some of it looks wrong. Can anyone confirm (or deny) that this docstring is up to date and accurate in Magento 2.4?

For one glaring example of a suspected issue, the Route Params section does not include the `param1/value1` portion of the URL. Another suspected issue is that the Action Path and the Route Path do not include the `base_script` portion. Therefore I suspect that the URL structure line had been edited, but the highlight strings were not moved.