Semver
인증된 제출자composer/semver
유틸리티, 버전 제약 조건 파싱 및 검증 기능을 제공하는 버전 비교 라이브러리입니다.
composer/semver
유틸리티, 버전 제약 조건 파싱 및 검증 기능을 제공하는 버전 비교 라이브러리입니다.
가능한 한 semver(유의적 버전)를 따르지만, version_compare 및 하위 호환성의 제약을 받기 때문에 semver를 엄격하게 구현하지는 못합니다.
원래 composer/composer의 일부로 작성되었으며, 현재는 독립 실행형 라이브러리로 분리되어 제공됩니다.
설치
다음 명령으로 최신 버전을 설치합니다.
composer require composer/semver요구 사항
- PHP 5.3.2 이상이 필요하지만, 가능하면 최신 버전의 PHP를 사용하는 것을 강력히 권장합니다.
버전 비교
버전이 어떻게 비교되는지에 대한 자세한 내용은 getcomposer.org 웹사이트 문서의 Versions 문서를 참고하세요.
기본 사용법
검증 / 정규화
Composer\Semver\VersionParser 클래스는 버전과 제약 조건을 파싱, 정규화, 검증하는 다음 메서드들을 제공합니다.
숫자형 버전은 내부 일관성과 version_compare와의 호환성을 위해 4개 구성 요소를 가진 버전으로 정규화됩니다(예: 1.2.3은 1.2.3.0으로 정규화). 정규화된 버전은 내부적으로 제약 조건에 사용되지만, 최종 사용자에게 보여 주어서는 안 됩니다.
버전용:
- isValid($version)
- normalize($version, $fullVersion = null)
- normalizeBranch($name)
- normalizeDefaultBranch($name)
제약 조건용:
- parseConstraints($constraints)
안정성(stability)용:
- parseStability($version)
- normalizeStability($stability)
비교
Composer\Semver\Comparator 클래스는 버전을 비교하는 다음 메서드들을 제공합니다.
- greaterThan($v1, $v2)
- greaterThanOrEqualTo($v1, $v2)
- lessThan($v1, $v2)
- lessThanOrEqualTo($v1, $v2)
- equalTo($v1, $v2)
- notEqualTo($v1, $v2)
각 메서드는 버전 문자열 두 개를 인자로 받아 불리언 값을 반환합니다. 예를 들면 다음과 같습니다.
use Composer\Semver\Comparator;
Comparator::greaterThan('1.25.0', '1.24.0'); // 1.25.0 > 1.24.0Semver
Composer\Semver\Semver 클래스는 다음 메서드들을 제공합니다.
- satisfies($version, $constraints)
- satisfiedBy(array $versions, $constraint)
- sort($versions)
- rsort($versions)
인터벌(Intervals)
Composer\Semver\Intervals 정적 클래스는 복잡한 제약 조건을 다루거나 제약 조건에서 버전 구간을 읽어 내는 몇 가지 유틸리티를 제공합니다.
use Composer\Semver\Intervals;
// $candidate가 $constraint의 부분집합인지 확인합니다
Intervals::isSubsetOf(ConstraintInterface $candidate, ConstraintInterface $constraint);
// $a와 $b가 교집합을 가지는지 확인합니다. $a->matches($b)와 동일합니다
Intervals::haveIntersections(ConstraintInterface $a, ConstraintInterface $b);
// 모든 구간을 병합해 복잡한 다중 제약 조건을 가능한 한 가장 작은 다중 제약 조건으로
// 최적화합니다. 단점은 속도가 빠르지 않고, 결과로 나온 다중 제약 조건에는
// 사람이 읽을 수 있는 prettyConstraint가 설정되지 않는다는 점입니다
Intervals::compactConstraint(ConstraintInterface $constraint);
// 주어진 제약 조건을 나타내는 숫자 구간과 브랜치 제약 조건의 배열을 생성합니다
Intervals::get(ConstraintInterface $constraint);
// 제약 조건 처리를 마친 뒤 메모이제이션 캐시를 비웁니다
Intervals::clear()자세한 내용은 클래스의 docblock을 참고하세요.
라이선스
composer/semver는 MIT 라이선스로 배포됩니다. 자세한 내용은 LICENSE 파일을 확인하세요.