Loheide-eu-mitarbeiterplatt.../vendor/guzzlehttp/psr7/docs/header-and-query-helpers.md
Friederich Loheide 9c0f8de791
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m12s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m7s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m19s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 1m32s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 1m22s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 1m32s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 1m35s
CI / Build-Artefakte aktuell (pull_request) Failing after 1m7s
Phase 0: Fundament für Inhaus
- Laravel 13 mit Filament 5 (Admin), Inertia 3 + Vue 3 + Vuetify 4 (Material 3)
- Anmeldung über Fortify (Login, Passwort vergessen/ändern), keine Selbstregistrierung
- Profil mit Profilbild (WebP in festen Größen), Personenseiten, Header mit Avatar-Menü
- Material-3-Farbschema aus der Primärfarbe, hell/dunkel/System pro Person
- Basis-Branding (Portalname, Logo, Primärfarbe) im Admin unter „Erscheinungsbild“
- Benutzerverwaltung im Admin, Zugang vorläufig über is_admin
- vendor/ (ohne Dev-Pakete) und Frontend-Build mitversioniert, Dev-Pakete in vendor-dev/
- PHPUnit-Tests gegen MySQL/MariaDB, Forgejo-CI-Matrix, Docker-Entwicklungsumgebung
- VERSION, CHANGELOG.md und CONTRIBUTING.md mit Release-Ablauf

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-25 20:35:30 +00:00

3.6 KiB

Header and Query Helpers

This page covers helper methods for parsing structured header values, splitting list headers, and parsing or building query strings. For basic message header behavior, see PSR-7 Messages.

GuzzleHttp\Psr7\Header::parse

public static function parse(string|array $header): array

Parses semicolon-separated header parameters into associative arrays, one per comma-separated header value. Parameters without a value are appended as values under integer keys.

GuzzleHttp\Psr7\Header::splitList

public static function splitList(string|string[] $header): string[]

Splits an HTTP header defined to contain a comma-separated list into each individual value. Empty values are removed:

$knownEtags = Header::splitList($request->getHeader('if-none-match'));

Example headers include accept, cache-control, and if-none-match.

This method must not be used to parse headers that are not defined as a list, such as user-agent or set-cookie.

GuzzleHttp\Psr7\Query::parse

public static function parse(string $str, int|bool $urlEncoding = true): array

Parse a query string into an associative array.

If multiple values are found for the same key, the value of that key-value pair becomes an array. This function does not parse nested PHP style arrays into an associative array. For example, foo[a]=1&foo[b]=2 will be parsed into ['foo[a]' => '1', 'foo[b]' => '2'].

GuzzleHttp\Psr7\Query::build

public static function build(array $params, int|false $encoding = PHP_QUERY_RFC3986, bool $treatBoolsAsInts = true): string

Build a query string from an array of key-value pairs.

This function can use the return value of parse() to build a query string. This function does not modify the provided keys when an array is encountered, unlike http_build_query().

GuzzleHttp\Psr7\Utils::asciiToLower

public static function asciiToLower(string $string): string

Converts ASCII uppercase letters in a string to lowercase.

Unlike strtolower(), which honors LC_CTYPE before PHP 8.2, the conversion is locale-independent and leaves every non-ASCII byte unchanged, as HTTP protocol elements require.

GuzzleHttp\Psr7\Utils::asciiToUpper

public static function asciiToUpper(string $string): string

Converts ASCII lowercase letters in a string to uppercase.

Unlike strtoupper(), which honors LC_CTYPE before PHP 8.2, the conversion is locale-independent and leaves every non-ASCII byte unchanged, as HTTP protocol elements require.

GuzzleHttp\Psr7\Utils::asciiUcFirst

public static function asciiUcFirst(string $string): string

Converts the first character of a string to uppercase when it is an ASCII lowercase letter.

Unlike ucfirst(), which honors LC_CTYPE before PHP 8.2, the conversion is locale-independent and leaves every non-ASCII byte unchanged, as HTTP protocol elements require.

GuzzleHttp\Psr7\Utils::caselessContains

public static function caselessContains(string $haystack, string $needle): bool

Checks whether the haystack contains the needle, comparing ASCII letters case-insensitively and without locale sensitivity.

GuzzleHttp\Psr7\Utils::caselessEquals

public static function caselessEquals(string $left, string $right): bool

Checks whether two strings are equal, comparing ASCII letters case-insensitively and without locale sensitivity.

GuzzleHttp\Psr7\Utils::caselessRemove

public static function caselessRemove(array $keys, array $data): array

Remove the items given by the keys from the data, case-insensitively.