Negotiate.php

Constructor

Stores the request instance to grab the headers from.

Determines the best content-type to use based on the $supported types the application says it supports, and the types requested by the client. If no match is found, the first, highest-ranking client requested type is returned. If FALSE, will return the first supported element.

Determines the best charset to use based on the $supported types the application says it supports, and the types requested by the client. If no match is found, the first, highest-ranking client requested type is returned.

Determines the best encoding type to use based on the $supported types the application says it supports, and the types requested by the client. If no match is found, the first, highest-ranking client requested type is returned.

Determines the best language to use based on the $supported types the application says it supports, and the types requested by the client. If strict locale negotiation is disabled and no match is found, the first, highest-ranking client requested type is returned.

Does the grunt work of comparing any of the app-supported values against a given Accept* header string. Portions of this code base on Aura.Accept library. If FALSE, will return the first supported element.

Try to find the best matching locale. It supports strict locale comparison. If Config\App::$supportedLocales have "en-US" and "en-GB" locales, they can be recognized as two different locales. This method checks first for the strict match, then fallback to the most general locale (in this case "en") ISO 639-1 and finally to the locale variant "en-*" (ISO 639-1 plus "wildcard" for ISO 3166-1 alpha-2). If nothing from above is matched, then it returns the first option from the $supportedLocales array.

Parses an Accept* header into it's multiple values. This is based on code from Aura.Accept library.

Match-maker

Checks two Accept values with matching 'values' to see if their 'params' are the same.

Compares the types/subtypes of an acceptable Media type and the supported string.

Will match locales against their broader pairs, so that fr-FR would match a supported localed of fr