The 5.7 branch of Magnolia reached End-of-Life on December 31, 2023, as specified in our End-of-life policy. This means the 5.7 branch is no longer maintained or supported. Please upgrade to the latest Magnolia release. By upgrading, you will get the latest release of Magnolia featuring significant improvements to the author and developer experience. For a successful upgrade, please consult our Magnolia 6.2 documentation. If you need help, please contact info@magnolia-cms.com.

The syntax for a version is:

from version / to version

where the version number consists of three parts: x.y.z. In this notation x.y denotes a major version and z a maintenance release. The last two parts are optional. For a strict version dependency, use just one version string.

The VersionRange class supports the following notation to indicate version dependency.

Only three parts are supported. The major, minor and security version positions. The build number is not supported. See Runtime.Version for more information.

  • * - Includes all versions - (warning) When using this option in a YAML file, please wrap * with quotes (version: "*")
  • 1.2 - Matches only 1.2 exactly.
  • 1.2/* - Matches all versions including and above 1.2.
  • 1.2/1.2.9 - Matches all versions including and between 1.2 and 1.2.9.
  • [1.2,1.2.9] - Inward square brackets mean inclusion. Same as above. Matches all versions including and between 1.2 and 1.2.9.
  • [1.2,1.2.9[ - Outward square brackets mean exclusion. Matches all versions between 1.2 and 1.2.9, including 1.2 but excluding 1.2.9.
  • [1.2,1.2.9) - Parentheses mean exclusion. Same as outward square brackets above. Matches all versions between 1.2 and 1.2.9, including 1.2 but excluding 1.2.9.

Examples:

Example

Description

3

Must have major version 3.

3.6

Must have major version 3.6.

3.6.3

Must have major version 3.6 and maintenance version 3.

3/*

Must have major version 3 or higher.

3.6/*

Must have major version 3.6 or higher.

3.6.3/*

Must have major version 3.6 and maintenance version 3 or higher.

*/3

Must have major version 3 or lower.

*/3.6

Must have major version 3.6 or lower.

*/3.6.3

Must have major version 3.6 and maintenance version 3 or lower.

3.5/3.6.2

Version not lower than 3.5 and not higher than 3.6.2.

[3.5/3.6.2]Versions between 3.5 and 3.6.2 including the boundaries.
[3.5/3.6.2[Versions between 3.5 and 3.6.2, excluding the upper boundary 3.6.2.
[3.5/3.6.2)Versions between 3.5 and 3.6.2, excluding the upper boundary 3.6.2. Same as above but alternative syntax.
  • No labels