upgrade-guide.md

Upgrade Guide

Upgrading from v5 to v6

• The default Content-Type header has been removed. You must set this manually or use a format helper, such as asJson.
• Dropped support for Adobe 2016.

Upgrading from v4 to v5

HyperHttpClientInterface now requires a debug method.

/**
 * Return a struct of information showing how the client will execute the HyperRequest.
 * This will be used by a developer to debug any differences between the generated
 * request values and the expected request values.
 *
 * @req     The HyperRequest to debug.
 *
 * @returns A struct of information detailing how the client would execute the HyperRequest.
 */
public struct function debug( required HyperRequest req );

Upgrading from v3 to v4

Previously, query params were stored as a struct. Some APIs expect multiple values for the same query param name to be passed as separate arguments. Hyper now stores the query params as an array and provides new methods for interacting with query params:

• getQueryParamByName
• getAllQueryParamsByName
• withQueryParams
• appendQueryParam
• appendQueryParams
• hasQueryParam

The following methods still exist, but now interact with arrays of query param structs instead of a simple struct.

• getQueryParams
• setQueryParams

The following methods have been deprecated:

Deprecated Method	Replacement Method
getQueryParam	getQueryParamByName

Upgrading from v2 to v3

Dropped support for ColdBox 5.

Upgrading from v1 to v2

Dropped support for Lucee 4.5.