Download the PHP package ptlis/semantic-version without Composer
On this page you can find all versions of the php package ptlis/semantic-version. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ptlis/semantic-version
More information about ptlis/semantic-version
Files in ptlis/semantic-version
Package semantic-version
Short Description Tools for working with semantic version numbers.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package semantic-version
SemanticVersion
A modular, extensible library for PHP >= 5.6 providing APIs to support parsing & manipulation of semantic version numbers, comparators, ranges & collections.
The Semantic Versioning Specification describes the semantics and precedence rules used when parsing & manipulating version numbers etc.
Usage
Parse Version
First create an instance of the VersionEngine:
Then call the parseVersion method passing a version number:
On failure to parse a \RuntimeException will be thrown.
Parse Version Range
Again, create an instance of the VersionEngine:
Then call the parseVersionRange method passing a version range:
As before, on failure to parse a \RuntimeException will be thrown.
Versions
The Version class provides a simple value type representing a semantic version number.
It provides simple accessors for the components of a semantic version number:
A __toString implementation:
Version also implement SatisfiedByVersionInterface so offer the isSatisfiedBy method which returns true if the versions match.
Version Ranges
Version ranges are bundles of objects representing a version range constraint, represented by classes implementing VersionRangeInterface.
The simplest version range is a version and a comparator (e.g. >=2.5.3, '<1.0.0'), which is expressed by the ComparatorVersion class.
A more complex range would be one with an upper and lower bound (e.g. ~1.0.0, '^1.0.0', '>=1.0.0,<2.0.0' which are all equivalent). This is expressed via the LogicalAnd class wrapping two ComparatorVersion instances.
The most complex constraint would be one containing two ranges (e.g. 1.2.5-2.3.2|^4.0.0). This is expressed via Wrapping the two classes implementing VersionRangeInterface.
As VersionRangeInterface extends SatisfiedByVersionInterface these implement the isSatisfiedBy method which returns true if the passed version satisfies the constraint.
Known limitations
There currently are a few areas where this library deviates from the specification when dealing with labels & build metadata; this is to due to how the parsing of version-ranges is handled. However, having tested the parsing code against the complete list of packages scraped from packagist I found no packages affected by this.
Example semantic versions which are valid but the library is unable to parse:
- 1.0.0-0.3.7
- 1.0.0-beta-17
