본문 바로가기
← 패키지 목록

Semver

인증된 제출자

composer/semver

제출자 이우진
최신 v3.6.0라이센스 MIT배포 2026년 10월 29일
DevOps

유틸리티, 버전 제약 조건 파싱 및 검증 기능을 제공하는 버전 비교 라이브러리입니다.

composer/semver

유틸리티, 버전 제약 조건 파싱 및 검증 기능을 제공하는 버전 비교 라이브러리입니다.

가능한 한 semver(유의적 버전)를 따르지만, version_compare 및 하위 호환성의 제약을 받기 때문에 semver를 엄격하게 구현하지는 못합니다.

원래 composer/composer의 일부로 작성되었으며, 현재는 독립 실행형 라이브러리로 분리되어 제공됩니다.

Continuous Integration PHP Lint PHPStan

설치

다음 명령으로 최신 버전을 설치합니다.

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.0

Semver

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 파일을 확인하세요.