Download the PHP package philharmony/http-enum without Composer

On this page you can find all versions of the php package philharmony/http-enum. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Example code of philharmony/http-enum

Informations about the package http-enum

philharmony/http-enum

Validate Static Analysis Test codecov PHP Version Latest Stable Version Total Downloads License

Type-safe HTTP enums for PHP: methods, status codes, headers, content types, schemes and protocol utilities — designed for modern applications and libraries.

📖 Description

philharmony/http-enum provides a set of strictly typed, PSR-compliant enums for common HTTP concepts:

Built for clean, expressive, and safe code, this lightweight library requires PHP 8.1+ and has zero runtime dependencies.
It is ideal for frameworks, middleware, SDKs, and reusable components.

📚 Included Enums

✨ Why Use This Library?

Working with HTTP often involves raw strings and magic numbers:

This library replaces them with type-safe enums:

Benefits:

🚀 Features

📦 Installation

Install via Composer:

⚙️ Requirements

🛠 Usage

HTTP Methods

Status Codes

Content Types

URI Schemes & Ports

HTTP Headers

Authentication Schemes

HTTP Versions

Cache-Control Directives

Content Encoding

SameSite Cookie Policy

✨ Enum Methods

Each enum provides a set of utility methods for semantic checks, parsing, and grouping — enabling expressive, safe, and framework-agnostic HTTP handling.

🏷️ HttpMethod

Represents standard HTTP request methods as a backed enum (string).

Method Description
isSafe(): bool Returns true for safe methods: GET, HEAD, OPTIONS, TRACE
isIdempotent(): bool Returns true for idempotent methods: GET, HEAD, PUT, DELETE, OPTIONS, TRACE, CONNECT
isCacheable(): bool Returns true for cacheable methods: GET, HEAD
isReadOnly(): bool Returns true for read only methods: GET, HEAD, OPTIONS, TRACE
isWriteOnly(): bool Returns true for write only methods: POST, PUT, PATCH, DELETE, CONNECT
usuallyHasBody(): bool Returns true for methods that typically include a request body: POST, PUT, PATCH
allowsBody(): bool Returns true for write only methods: POST, PUT, PATCH, DELETE
isValid(string $method): bool Checks if the given string is a valid HTTP method (case-sensitive)
fromString(string $value) Creates an instance from a valid method string - used strtoupper for value and from()
tryFromString(string $value) Creates an instance from a valid method string - used strtoupper for value and tryFrom()
from(string $value) Built-in (PHP 8.1+) — creates an instance from a valid method string
tryFrom(string $value) Built-in (PHP 8.1+) — returns null if invalid

Example: HttpMethod::isValid('POST') → true Example: HttpMethod::tryFromString('post') → HttpMethod::POST

🔢 StatusCode

Represents HTTP status codes as a backed enum (int) with semantic grouping and standard reason phrases.

Method Description
isInformational(): bool 1xx (100–199)
isSuccess(): bool 2xx (200–299)
isRedirection(): bool 3xx (300–399)
isClientError(): bool 4xx (400–499)
isServerError(): bool 5xx (500–599)
isError(): bool 4xx or 5xx — indicates an error condition
phrase(): string Returns the standard reason phrase (e.g., OK → "OK", I_M_A_TEAPOT → "I'm a teapot")
toStatusLine(): string Returns full status line fragment like 404 Not Found
from(int $code) Built-in — creates from status code
tryFrom(int $code) Built-in — returns null if invalid

Static Group Methods (return StatusCode[]):

Example: StatusCode::NOT_FOUND->isClientError() → true

📝 ContentType

Represents media types as a backed enum (string) with parsing and detection utilities.

Method Description
isTextBased(): bool text/*, application/json, application/xml, application/javascript, etc.
isJson(): bool application/json, application/hal+json, application/problem+json, etc.
isXml(): bool application/xml, application/atom+xml, application/rss+xml, application/xhtml+xml, etc.
isImage(): bool image/*
isAudio(): bool audio/*
isVideo(): bool video/*
isMedia(): bool image/*, audio/*, video/*
isFont(): bool font/woff, font/woff2, font/ttf, font/otf
isForm(): bool application/x-www-form-urlencoded, multipart/form-data
isBinary(): bool Includes media, fonts, PDF, ZIP, Protobuf, etc.
isScript(): bool application/javascript
isArchive(): bool application/zip
isCompressible(): bool Returns true for types suitable for compression
defaultCharset(): ?string Returns default charset for text-like types (heuristic)
baseType(): string Returns base subtype (e.g. application/json → json)
category(): string Returns MIME category (e.g. json, image, video, audio, text)
is(): bool Case-insensitive exact match for MIME type
matches(): bool Pattern match like image/*, application/*
fromHeader(string $header): ?self Parses from Content-Type header (ignores parameters like ; charset=utf-8)
fromExtension(string $extension): ?self Maps file extension (e.g., .json, .png) to content type
fromFilename(string $filename): ?self Maps filename to content type by extension
negotiate(string $accept, array $available): ?self Chooses best type from Accept header (q + specificity)
from(string $value) Built-in — creates from MIME type
tryFrom(string $value) Built-in — returns null if invalid

Static Group Methods (return ContentType[]):

Example: ContentType::fromHeader('application/json; charset=utf-8') → ContentType::JSON

🌍 Scheme

Represents URI schemes as a backed enum (string) with port mapping.

Method Description
defaultPort(): ?int Returns standard port (e.g., HTTP → 80, HTTPS → 443, LDAPS → 636)
isSecure(): bool Returns true for secure protocols: HTTPS, WSS, SFTP, LDAPS, SSH
requiresHost(): bool Returns true for schemes that require a host: HTTP, HTTPS, WS, WSS, FTP, SFTP
isHttp(): bool Returns true for HTTP, HTTPS
isWebSocket(): bool Returns true for WS, WSS
isMail(): bool Returns true for SMTP, IMAP, POP
isLdap(): bool Returns true for LDAP, LDAPS
fromString(string $scheme) Creates enum from scheme string (case-insensitive, trims input)
tryFromString(string $scheme) Safe version returning null if invalid

📨 HttpHeader

Represents common HTTP headers as a backed enum (string) with semantic grouping and normalization utilities.

Method Description
isRequestHeader(): bool Returns true if header is typically used in HTTP requests
isResponseHeader(): bool Returns true if header is typically used in HTTP responses
isContentHeader(): bool Content-* headers (Content-Type, Content-Length, etc.)
isCors(): bool Access-Control-* headers
isProxy(): bool Proxy headers (X-Forwarded-*, X-Real-IP)
isCacheHeader(): bool Cache-related headers (Cache-Control, ETag, Expires, etc.)
isAuthHeader(): bool Authentication headers (Authorization, WWW-Authenticate, etc.)
isSecurityHeader(): bool Security-sensitive headers (Authorization, Cookie, Set-Cookie)
isConditional(): bool Conditional request headers (If-Match, If-None-Match, etc.)
isGeneralHeader(): bool General headers (Cache-Control, Connection, Date, etc.)
isRequestOnly(): bool Returns true if header is request-only (excludes response/general)
isResponseOnly(): bool Returns true if header is response-only (excludes general)
isHopByHop(): bool Hop-by-hop headers (RFC 7230, includes TE and Trailer)
fromString(string $header): self Creates enum from header name (case-insensitive, trims input)
tryFromString(string $header): ?self Safe version returning null if header is unknown
from(string $value) Built-in — creates from header string
tryFrom(string $value) Built-in — returns null if invalid

Example: HttpHeader::fromString('content-type') → HttpHeader::CONTENT_TYPE Example: HttpHeader::isRequestOnly() / HttpHeader::isResponseOnly() for request/response-only checks

🔐 AuthScheme

Represents HTTP authentication schemes used in the Authorization and WWW-Authenticate headers.

Method Description
isTokenBased(): bool Returns true for token-based authentication (Bearer, OAuth)
isChallengeBased(): bool Returns true for challenge-response schemes (Basic, Digest, Negotiate, HOBA, Mutual)
isPasswordBased(): bool Returns true for password-based schemes (Basic, Digest)
fromHeader(string $header): ?self Extracts authentication scheme from Authorization header (case-insensitive)
fromString(string $scheme) Creates enum from scheme name (case-insensitive, trims input)
tryFromString(string $scheme) Same as above but returns null if invalid
from(string $value) Built-in — creates enum from valid string
tryFrom(string $value) Built-in — returns null if invalid

Example: AuthScheme::fromHeader('Bearer token123') → AuthScheme::BEARER Example: AuthScheme::fromString('basic') → AuthScheme::BASIC

🌐 HttpVersion

Represents HTTP protocol versions.

✅ StatusCode Helpers

Method Description
statusClass(): int Returns the status code class (1..5)
category(): string Returns semantic category (success, etc.)
isCacheable(): bool Returns true if cacheable by default (RFC 9111)
Method Description
toProtocolString(): string Returns protocol string like HTTP/1.1, HTTP/2
fromProtocol(string $protocol) Parses version from protocol string (HTTP/1.1, HTTP/2)
fromString(string $version) Creates enum from version string (1.1, 2, 3)
tryFromString(string $version) Safe version returning null if invalid
from(string $value) Built-in — creates enum from version string
tryFrom(string $value) Built-in — returns null if invalid

Example: HttpVersion::fromProtocol('HTTP/1.1') → HttpVersion::HTTP_1_1

🗄️ CacheDirective

Represents Cache-Control directives used to control HTTP caching behavior.

Method Description
isRestriction(): bool Returns true for cache restrictions (no-cache, no-store)
isExpiration(): bool Returns true for expiration directives (max-age, s-maxage)
isVisibility(): bool Returns true for cache visibility (public, private)
fromString(string $directive) Creates enum from directive string (case-insensitive)
tryFromString(string $directive) Safe version returning null if directive is unknown
from(string $value) Built-in — creates enum from valid string
tryFrom(string $value) Built-in — returns null if invalid

Example: CacheDirective::fromString('no-cache') → CacheDirective::NO_CACHE

🗜 ContentEncoding

Represents compression algorithms used in Content-Encoding and Accept-Encoding headers.

Method Description
isCompressed(): bool Returns true for compression algorithms (all except identity)
fromString(string $encoding) Creates enum from encoding string
tryFromString(string $encoding) Safe version returning null if invalid
from(string $value) Built-in — creates enum from valid string
tryFrom(string $value) Built-in — returns null if invalid

🍪 SameSite

Represents cookie SameSite policies used in Set-Cookie headers to control cross-site request behavior.

Method Description
isStrict(): bool Returns true if policy is Strict
allowsCrossSite(): bool Returns true if cookies may be sent with cross-site requests
fromString(string $value) Creates enum from SameSite string
tryFromString(string $value) Safe version returning null if invalid
from(string $value) Built-in — creates enum from valid string
tryFrom(string $value) Built-in — returns null if invalid

📜 RFC Compliance

This library follows behavior defined in several HTTP specifications:

🧪 Testing

The package is strictly tested with PHPUnit 10 to ensure full compliance with HTTP standards and RFCs.

Run Tests

Code Coverage

🏗️ Static Analysis & Code Style

Verified with PHPStan Level 9 to ensure total type safety and prevent runtime errors.

Check and fix code style (PSR-12):

📄 License

This package is open-source and licensed under the MIT License. See the LICENSE file for details.

🤝 Contributing

Contributions, issues, and feature requests are welcome.

If you find a bug or have an idea for improvement, please open an issue or submit a pull request.

⭐ Support

If you find this package useful, please consider giving it a star on GitHub. It helps the project grow and reach more developers.

All versions of http-enum with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package philharmony/http-enum contains the following files

Loading the files please wait ...