Documentation index

Make $path absolute, prefixing it with $root when it's relative (NOTE: the result is NOT simplified -- any ../. end up literally in the merged result; run it through simplify() yourself if…

Fill in whatever $uri is missing (scheme, host/user/pass/port, path) from $root.

Same as absolute(), but drive-aware (via isAbsoluteFilename()/relativeFilename() when $isWindows).

Makes the documentation searchable from <mmo-app>'s command palette, the one search box of the application: the search endpoint (SearchController::routeSearch) is declared in `MMO.config.sea…

Get the "drive" of an already-split path (segments array): / for a unix path (a leading empty segment), or the drive letter (e.g.

The canonical in-page anchor for a symbol or member name.

Build a query string in the {json:api} convention (filters[...], sort=, fields=, page[limit]/page[offset]).

The JSON-Schema type of a phpstan array (array<K, V>) according to the type of its keys: integers make a list (array), strings a map (object), anything else (array-key, int|string, `mixed…

Render a number as large, multi-line ASCII-art digits (ASCII_NUMBERS), for banner-style CLI output (e.g.

Ask input from the user

Call \debug_backtrace

Get trace of the caller

Convert a number from one base/alphabet to another.

Extract the filename (last path segment) of a path -- almost the same as PHP's own \basename(), except that in $strict mode it returns false rather than the segment itself when that segment doesn't…

Benchmark a closure

Build a .phar package from a manifest and a list of source files.

Same as \http_build_query(), except it can round-trip true (encoded as a bare key, no =value) and null (encoded as key=NULL) -- \http_build_query() alone can't distinguish those from `'1'…

Get the formatted name of a callable

Convert text to camelCase, treating $separators as word breaks.

Split a text into the characters a terminal shows, one column each: a character is one whatever its bytes (UTF-8), and a letter followed by a combining accent is one character too.

Extract the charset=... parameter's value from a Content-Type header.

Test a version string against a Composer-style constraint string.

Ask for one of a few choices, listed one per line and numbered, with what each one means.

Normalize a version string to its canonical split()+join() round-tripped form.

Get the client's IP address, checking a wider/differently-ordered set of headers than ip() (via \getenv() rather than $_SERVER directly -- functionally equivalent under most SAPIs).

Print a table with a preview of every SHELL_* color/style constant.

Attempt to get the number of columns of the current terminal

Tells if a command is available and executable on the current system

Extract schema keywords/metadata from a PHP doc comment (as returned by \ReflectionProperty::getDocComment() and similar), so a class's own docblocks can double as its JSON-Schema definition (…

Type-aware comparison of two arbitrary values, handling cases plain <=>/== don't get right on their own (iComparable objects, BackedEnum vs its raw backing value, DateTimeInterface by timestamp…

Compare two versions per Semantic Versioning precedence rules (numeric identifiers compared numerically, alphabetic ones lexically, a shorter prerelease set precedes a longer one that's otherwise i…

Find where two traces differ, using their file|line|name to find a difference

Compiles src/styles/documentation.scs to {bin}/mmo.doc.css, recompiling only when the source is newer (dev mode only -- like MMO\client\Theme's own asset jobs, a production deploy is expected…

Ask the user for a confirmation

Auto-wire an object's (or, for a static/string $obj, a class's static) methods to events, by reading their #[MMO\core\attributes\Listen(EventClass::class)] attributes and registering each as a list…

Registers the html documentation renderer, which only makes sense once mmo.client provides the page tree.

Registers this package's controllers as routes (\MMO\connect).

Extract just the content-type value(s) from a Content-Type header, stripping any ;charset=.../other parameters.

The source of a new controller class.

Copy a file or folder (recursively), returning the number of files actually copied.

Copies mmo.client's vendored vendor/prism/prism.js (a Prism.js build already bundling the markup/js/scss/ css/markdown/php grammars) out to {bin}/prism.js, so it's actually servable -- \MM…

Get the number of elements in any iterable (not just a plain array/\Countable) -- for a plain \Iterator without \Countable, this has to fully traverse it (there's no shortcut).

Create a folder (recursively) if it does not exist.

Read and decode a CSV file (a UTF-8 BOM, if present, is stripped first).

Reverse of csvColumnName(): convert a spreadsheet-style column name back to its 0-based index.

Convert a 0-based column index into a spreadsheet-style column name (A, B, ..., Z, AA, AB, ...).

Decode CSV text into an array of rows.

Encode a list of records as CSV text, guessing the headers automatically from the data by default.

Encode a list of lines as CSV text, without any header handling: each line is either an array of column values (joined with $sep) or an already-formatted raw string (used as-is).

Encode a file as a data: URI (its content, base64-encoded, with its detected mime type), ready to use directly as e.g.

Reverse of dataURI(): decode a data: URI and write its content to $filename.

Format a unix timestamp (or a parseable date string) as an RFC 7231 ("IMF-fixdate") GMT date, suitable for an HTTP header (e.g.

The framework's all-purpose date parser: turns a timestamp, a DateTimeInterface, or a string into a DateTime/DateTimeImmutable, trying (in order) an explicit $format, an ISO-8601 duration (a string…

Apply an interval/modifier to a date, always returning a DateTimeImmutable.

Decode one HTTP Link header value: <{href}>;rel="{rel}";title="{title}" ...

Decode a comma-separated recipient list of the form "Name" <email>, other@example.com, ... (as used in mail headers like To/Cc) into [email => name] pairs.

Get PHP's configured default charset (the default_charset ini directive, e.g.

Guess a default language from the environment: $_SERVER['LANG'] (its part before any '.', e.g.

The PHP literal a property of $type defaults to.

Delete the value at the given json-path.

Recursively delete a file or folder.

Describe any value as a compact, technical/debug string representation (unlike render(), which aims for a human-facing display string): an object uses debugName() if available, else a `Class{p…

The hint an error message adds after an unknown name: the closest known names, so a typo tells its reader (a developer, or an AI agent) what was meant instead of only what was wrong.

Get the elements of $a whose value is not (strictly) present anywhere in $b -- like \array_diff(), but using strict (===) comparison instead of string-casting comparison, so it works correctly wi…

The differences between two texts, line by line, the way diff -u shows them: a removed line in red after a -, an added one in green after a +, each change among a few unchanged lines around i…

Get the direct interfaces implemented by a class

Get the direct trait implemented by a class

Extract the directory of a path (same as PHP's \dirname(), but normalizes \ to / first when $isWindows).

Undo a previous connect(): remove an object's (or class's) #[Listen]-declared methods from the events they were registered on.

Look up a domain's A (IPv4) or AAAA (IPv6) record.

Get the document root the running script is resolved against: under a web server $_SERVER['DOCUMENT_ROOT'] through realpath(), on the CLI as is (normally empty).

Turn arbitrary text into a lowercase, dot-separated identifier (a common convention for i18n/config keys).

Get the "drive" of a path string: / for a unix path, or the drive letter (e.g.

Reverse of decodeLink(): encode a uri and its attributes into an HTTP Link header value.

The source of a new entity class.

Same as tryEnumFrom(), but throws instead of returning null when nothing matches.

Print an error message, prefixed with '!!

Escape ~ and / inside a single path segment, so it can safely be joined with / without being mistaken for a path separator (RFC 6902 JSON Pointer escaping: ~ -> ~0, / -> ~1).

Escapes a string to be used as an argument and qotes it.

Used to put shell colors directly into a text Any SHELL_* colors must be in brackets to be replaced

Execute a command through php exec, serializing the parameters passed

Launch a command in the background (fire and forget), serializing the parameters passed

Tells if a value exists at the given json-path (without fetching it).

Test if a local file, or a remote url (via a curl HEAD request), exists/is reachable.

Map an HTTP status code to a shell exit code (the EXIT_* constants), for a CLI request routed through the same Application/Route pipeline as an HTTP one (\MMO\core\Application::run()).

Print a paragraph of explanation, indented and wrapped to the terminal (100 columns at most), so that it reads as prose rather than as lines running off the screen.

Extract the extension of a path (the part after the LAST '.' in its last segment), without the leading '.'.

Reverse lookup: find a file extension whose MIMES entry matches a given content-type header (the first usable content-type found in $header, tried against every entry of MIMES).

Extract the extension from a uri's path (query/fragment are stripped first, so they don't interfere).

Build a Content-Type header value for a file extension (falling back to 'txt' if $ext is unknown).

Strip a leading Content-Type: label (if present) off a header line, and split it on , into its individual content-type values (a header CAN legally list several, comma-separated).

Extract sass configuration from a sass file

Get the underlying filename (for a stream) or command (for a process) of a resource.

Filter (and, in select mode, reorder) an array's keys recursively.

Filter traces

Find the matching closing delimiter for the first opening delimiter found at/after $offset, correctly handling nesting ({a{b}c}), escaped characters, and quoted sub-sequences (ignored entirely, b…

Get the character offset for a specific line/column position in a text.

Find the version(s) in $versions that satisfy $constraint.

Convert a string into a debug constant mask

Format a date, then translate its month/day names to $lang (translateDate()).

Format bytes to human readable size

Format a float as an integer part plus its best rational approximation (a fraction), e.g.

Convert any value into a plain array: an \MMO\core\interfaces\iArray is unwrapped via toArray(), a Generator/Traversable is consumed via \iterator_to_array(), a plain array is returned as-is, and a…

Get a value at the given json-path.

Read the content of a file (given as a filename, read directly) or an already-open stream resource.

The accent-folding table stripAccents()/textRegex() are built on: maps every accented Latin character to its plain-letter equivalent (e.g.

Get the current position of the terminal cursor

Get the 7 day names for $lang, in week order (Monday first).

Alias to getenv(). Return null instead of false in case value is not set in the env

Same as getWorkingDays(), but automatically excludes French public holidays (getFrenchHolidays()) for every year the range spans (not just $startDate's year -- a range crossing into a new…

Get every French public holiday of a given year, as ['Y-m-d' => 'name', ...], sorted by date.

The stream user input is read from.

Get the 12 month names for $lang, in calendar order (January first).

Get every placeholder in a template, without rendering/matching anything (a thin wrapper over loopTemplate()).

Compute the number of working days (Mon-Fri, minus $holidays) between two dates, both inclusive.

Interpolates a color along a linear gradient between two colors, based on a normalized position (0 to 1).

Tells if $a orders after $b (per compare()'s ordering result).

Test if a version (string, or already-split() array) has a wildcard in any of its first 3 (major/ minor/patch) positions -- unlike isAny(), a partial wildcard like '1.*' counts.

Tells if a uri has a scheme:// authority part at all (of any scheme).

Same as hash3Int(), but base-32-encoded (via PHP's own \base_convert(), NOT this file's own baseConvert()) into a short, compact string.

Compute the MurmurHash3 (32-bit) hash of a string, as an int.

Don't use this function directly unless you know what you are doing.

Tells if a uri's scheme is one of this framework's "local" schemes (\MMO\core\helpers\Uri::$LOCAL_SCHEMES, e.g.

Print a title: set apart from what comes before it by a blank line, and ruled across the terminal (100 columns at most) -- how the steps of a long run are told apart at a glance.

Convert a string to its hexadecimal representation, one hex number per byte.

Converts a hex color (6-digit, or the 3-digit CSS shorthand) or a named HTML color to an RGB array.

Get the server's own hostname: $_SERVER['SERVER_NAME'] if set, else the system hostname.

Render a list of records (csvEncode()'s $data shape) as a plain HTML <table>, guessing the header row from the data's own keys (in the order first seen).

Sanitize a value for use as an HTTP status code: pass it through if it is an int that isHttpStatus(), else fall back to 500.

Load an image file (jpeg/png/gif) as a GD image resource/object.

Increment one component (major/minor/patch) of a version, returning the new version string.

Include the documentation in the html response This function is added as a job in the application.

Indent every line of a text.

Return memory info on current execution

Parses phpinfo() output and returns a structured array.

Capture phpinfo()'s HTML output as a standalone, embeddable fragment: styles are rescoped under #phpinfo (instead of being global) and the surrounding <html>/<head>/<body> are stripped, so …

Inject a configuration into $src recursively: every key of $config is itself a json-path into $src, and its value is set() (recursively merge()d with whatever's already there, by default)…

Get the client's IP address, from the first of HTTP_CLIENT_IP/HTTP_X_FORWARDED_FOR/REMOTE_ADDR that's set.

Tells if a path is absolute (starts with '/'; for the split/array form, has at least 2 segments and an empty leading one, per split()'s '/' => ['', ''] convention).

Tells if a uri is absolute: it has a network authority (scheme://host/..., or -- in $strict mode -- a local-scheme authority followed by /), or (falling back to \MMO\core\paths\isAbsoluteF…

Same as isAbsolute(), but for a real filename: also recognizes a Windows drive, and (for a string path) a URI authority (scheme://host/... or //host/...) as making the path absolute.

Test if a string is only made of letters, digits, or the given extra allowed characters.

Test if a version (string, or already-split() array) is a bare wildcard: '*', or a split version whose first 3 elements are all '*' (i.e.

Test whether a Content-Type header matches a given file extension's MIME type(s) (extension()).

Tells if two values are STRICTLY equal, per compare() (i.e.

Test if the character at $pos is escaped: preceded by an ODD number of consecutive $escapeChar (an even number means those escape characters escape each other in pairs, leaving $pos itself unescaped).

Tells if a date is a French public holiday (getFrenchHolidays()).

Tells if $status is a plausible HTTP status code (100-599).

Check if a namespace is inside a list of other namespaces

Tells if the answers are typed by someone at a terminal, rather than read from a pipe, a file or a stream given to setInput.

Tells if a uri refers to the local filesystem: no authority at all (a plain path), or a file:///phar:// scheme.

Tells if a file was modified after $time -- or, for a folder (or an already-obtained loopFolder() generator), if ANY file under it was.

Tells if a status is a "success" HTTP status: [200, 400).

Tells if $text is, as a WHOLE, a single placeholder ({...}) -- e.g.

Test if a string is a syntactically valid PCRE regular expression (delimiters and all).

Tells if a process with the given PID is currently running.

Tells if two values are equal, in either sense compare() can report equality (strict true, or the ordering-comparison tie value 0).

Tells if an array (recursively) contains at least one serialized-object marker (a ['$' => ...] entry, as produced by serialize()), meaning it needs unserialize() to be turned back into …

Tells if the current terminal is a tty (native terminal device)

Tells if every value in $array is distinct (strict, ===, comparison).

Validate whether a string contains a valid value to use as a hostname or IP address.

Heuristically tell if a path looks like a Windows path: either it uses \ and no / at all, or it starts with a valid drive letter immediately followed by a separator (or nothing else).

Join an array of path segments (as produced by split()) back into a path string, escaping each segment.

Reverse of split(): join a parts array back into a uri string.

Reverse of split(): join a split version back into a string, replacing a negative stability int back into its word form (the first STABILITY key with that value -- STABILITY).

Same as join(), but converts every / to \ afterwards when $isWindows is true.

Format a date as ISO 8601 (c), for JSON output.

Read and decode a JSON file (\MMO\core\strings\jsonDecode() for $asArray/$vars/$cleanUp).

Decode a JSON string, optionally tolerating non-standard syntax and templating in {var} values first.

Encode a value as JSON, with a sanity check that guards against a common \json_encode() footgun: silently returning the string 'null' for a value it couldn't actually encode (e.g.

Reverse of jsonUnicodeEncode(): decode a sequence of JSON unicode escapes (backslash, u, then 4 hex digits, repeated) back to a UTF-8 string.

Encode a UTF-8 string as a sequence of JSON \uXXXX unicode escapes (surrogate pairs for anything outside the Basic Multilingual Plane).

Get the keys of any iterable (not just a plain array) as a plain array.

Sort an array by its KEYS, treating them as version numbers (sortCompare()).

Count the number of characters (not bytes) in a UTF-8 string, without needing the mbstring extension.

Get length of a text, removing ansi sequences: a character is counted as one whatever its bytes (UTF-8).

Tells if $a orders before $b (per compare()'s ordering result).

Attempt to get the number of lines of the current terminal

Split text into lines by $separator, like \explode(), EXCEPT a $separator that falls inside a quoted ($enclosure-delimited) section does not split -- so a CSV-style multi-line quoted field stays on…

Replace every @see reference of a markdown text with a link to its target, or with inline code when the target is documented nowhere.

Recursively copy a file or folder, yielding each individual file as it's copied (a folder itself isn't yielded, only the files under it -- but it IS created, even if empty).

Recursively delete a file or folder (depth-first: a folder's contents are deleted before the folder itself), yielding the path of each thing actually removed as it's removed.

Lazily list the entries of a folder (files AND subfolders, each yielded individually -- a subfolder is yielded itself, in addition to whatever's recursed into it).

Loop a template containing placeholders A placeholder has the following format {?path:type} - ?: if the placeholder is optional [optional] - path: a valid json path (: MUST be changed to ~2).

Lazily yield every version in $versions that satisfies $constraint, from highest to lowest (sort()).

Compute the WCAG 2.0 relative luminance of a color (0 = darkest black, 1 = brightest white).

Parse a weighted Accept-family HTTP header (sortAccept()) and find the best-matching entry in $supported: the header's options are tried highest-weight first, and the first one present as a …

Test each key present in $mask against the corresponding key in $value.

Try to match a path against a mask made of plain segments, {name:type} moustache templates (\MMO\core\strings\matchTemplate), and wildcards: * matches exactly one segment, ** matches any…

Try to match an uri against a mask.

Match $text against a loopTemplate()-style template, extracting each placeholder's captured (and, if typed, coerced+validated) value into &$matches.

Print a navigable single-choice menu and return the selected key.

Recursively merge $value into $src: for matching keys whose values are themselves both array-like, merge recursively; otherwise $value's value simply overwrites $src's.

Concatenate several paths (segment arrays or path strings) into one, dropping the trailing empty segment of a path when the next one continues it (so joining doesn't produce a doubled /), and ski…

Same as merge(), but merges $value into whatever is already at $path (instead of into $src itself), then writes the result back with set().

A shallow, synchronous cousin of inject(): recursively merge $config into $src and return the result (rather than mutating a reference and honoring the ?/= path-prefix directives), underst…

Extract a version's build metadata (the part after '+'), without normalizing the rest of the string.

Get the MIME type(s) (MIMES) registered for a file extension.

Move file to new destination

Get a file/url's last-modified time, locally via \filemtime() or remotely via a curl HEAD request.

Get a short, human-readable identifier for a stream or process resource (for logging/debugging).

Get the closest week day (MON-FRI) to the given date: a Saturday snaps back to Friday, a Sunday snaps forward to Monday.

Normalize text for loose/accent-insensitive equality comparison: safeIdentifier() then lowercase.

Normalize a version string: strip its build metadata (the +... suffix, captured into &$metadata), and turn separators (_, -, +, spaces) plus letter/digit boundaries into ., so it can be c…

Replace every \ with /, turning a Windows-style path into a plain one split()/join() can handle.

Compute the total number of distinct days covered by a list of (possibly overlapping) day intervals, by merging them first (unionOfDayIntervals()) so an overlapping day is only counted once.

Open a file and return the resulting stream resource, translating the STREAM_* flag bitmask into the right \fopen() mode (always append-mode when writing, so an existing file's content is preserved…

The options array behind $options: a typed options object (\MMO\core\interfaces\iOptions) gives its toArray(), an array is returned as it is.

Get the requesting page's url: the Referer header, falling back to the Origin header.

Package a list of files into a phar package WARNING: when creating a PharData (no stub), the filename MUST NOT have .phar in the extension.

Pad string ingoring ANSI sequences

Parse a command line This command line option parser supports any combination of three types of options [single character options (-a -b or -ab or -c -d=dog or -cd=dog), long options (`--fo…

Quickly parse a PHP doc comment (`* ...

Converts sass string to an array

Parse this framework's compact type-description mini-language (used in doc comments, commentInformation(), and anywhere a schema is written by hand as a short string) into a JSON-Schema-shaped…

Extract just the path component of a uri (stripping scheme/authority/query/fragment).

Get a file/folder's permissions formatted like unix ls -l (e.g.

Format a raw \fileperms()-style integer as a unix ls -l permission string.

Compact a PHP source string's whitespace (collapse runs of spaces/tabs, strip leading indentation) while preserving line numbers -- unlike stripWhitespace(), this is PHP-token-aware (via \toke…

The reverse of findOffset(): get the line/column for a given character offset in a text.

Interpolate context values into {key} placeholders in $format.

Same as printf(), but converts values via describe() instead of render() -- useful for debug messages where you want a value's raw/technical representation rather than its "nice" ren…

Print lines in a rectangle and returns text's positions in the rectangle This function is safe with ANSI sequences

Print and redraw an in-place progress bar.

Ask for a value, showing the one ENTER keeps, until the answer is a valid one.

Ask for a list of values, separated by commas.

The type a generated property is declared with: a non-nullable class type becomes nullable, so that the property can default to null (a typed property has to be initialized before it is read, and `…

Install a SIGINT/SIGTERM safety net so the terminal is not left in raw/no-echo mode if the process is interrupted (e.g.

Convert framework flags to PSR flags

Append a value to the list at the given json-path (turning a non-list scalar/null already there into a single-element list first, so it can be appended to).

Same as write(), but always appends and creates any missing parent folder (STREAM_PUT = write + create folder).

Read a command from the user input.

Show what ENTER answers, then read the answer.

Read every key press by the user on the command line (as opposed to fgets which waits on return key)

Wait for the user to press a key, then read it with every key that came with it -- a paste, fast typing, keys sent in one go over ssh -- one string for each: a character, or a whole escape sequence…

Read one line of user input, without its line ending.

The half of read that has no terminal to read keys from: the next line of the input is the answer.

Take what the user has typed that nothing has read yet, without waiting for more -- or, given a timeout, waiting that long at most for a first key.

Ask for a secret (e.g.

Turn a plain pattern into a valid delimited regular expression, if it isn't one already (a string that already looks like <delim>...<delim><flags> is passed through unchanged, plus $flags appended).

Express $path relative to $root (both simplified first, so ../. in either are resolved).

The reverse of absolute(): strip out from $uri whatever it shares with $root (scheme, host/user/pass, matching port, and the common leading part of the path -- \MMO\core\paths\relative())…

Same as relative(), but drive-aware (via simplifyFilename() when $isWindows is true).

Strip ANSI escape sequences (colors, cursor movement, ...) from a text, leaving only the visible characters.

Render any value into a "nice", human-facing string: - a scalar is cast to string directly - an \MMO\core\interfaces\iRenderable renders itself - an object with __toString() uses that - an iterable…

Fill in a loopTemplate()-style template's placeholders with values from $data (by default rendered through render(); pass $printer to customize).

Resolve $uri against a base uri and simplify the resulting path -- a direct implementation of RFC 3986's reference resolution algorithm (unlike absolute(), this correctly treats $base's path a…

Undo one call to stopShellBuffering.

Format a timestamp per RFC 1123/2822 (RFC_FORMAT), as used in HTTP dates and email headers.

Converts RGB values to a hex color.

Get the deepest common ancestor folder shared by a list of filenames.

Turn arbitrary text into a safe identifier: strip accents (stripAccents()), trim, and replace every character that isn't a letter/digit/underscore (or in $authorizedChar) with $replace.

Print an informational message, prefixed with '- ' in purple.

Benchmark a closure Returns result in a string ex: $a = new DummyClass(); echo \MMO\core\debug\benchmark('test', function() use ($a) {..}, 10000);

Same as loopFolder(), but eagerly collects the results into an array, naturally case-insensitively sorted and then REVERSED (so entries come back in descending natural order).

Fuzzy-match score of $w1 against $w2 (e.g.

Get the absolute filename of the currently running script (works both under a web server and on the CLI).

Every target the @see references of a text point at, cleaned of the punctuation the sentence around it glued on (@see stop., (stop)), and split when several are written as one (`@see get…

Print a menu of choices and return the keys of the selected options

Serialize an object (or an array possibly containing objects) into a plain, JSON-safe nested array that

Serialize the command All parameters with no string key (plain args) are left untouched (no escape).

Reflect over an object's properties and serialize them into a plain array (the default serialization strategy used by serialize() for objects that don't implement iSerializable themselves).

Set a value at the given json-path, creating missing intermediate arrays by default.

Same as write(), but always replaces the stream's entire existing content (STREAM_SET = write + clear).

Read the user's answers from another stream than STDIN: a file of answers, or -- in a test -- a php://memory stream written beforehand.

Set the default timezone for the rest of the request (date_default_timezone_set()).

Tells if PHP has been compiled with the '--enable-sigchild' option.

Simplify a path by resolving . and .. segments and dropping empty ones, without touching the filesystem (a leading .. past the root is dropped for an absolute path -- you can't go above / -…

Simplify a uri's path component in place (resolving ./.. -- \MMO\core\paths\simplify()), leaving the rest of the uri untouched.

Same as simplify(), but drive-aware: a Windows drive is protected from being simplified away (c:\.. stays c:\, it never turns into just \, since going "above" the drive doesn't mean anyt…

Format a byte count as a human-readable size, with French unit abbreviations (o/ko/Mo/Go/To).

Sort a list of filenames "naturally" (so 'file2' sorts before 'file10' -- \strnatcmp()).

Sort an array by its VALUES, treating them as version numbers (sortCompare()).

Parse a (comma-separated, or already split) Accept-family HTTP header (Accept, Accept-Language, ...) and sort its options by weight (the ;q= parameter), highest first.

Same as compare() (with no operator), except a wildcard version always sorts BEFORE the versions it matches (so 1.* sorts before 1.2.3) rather than comparing equal to them -- this is what …

Sort an array in place using $sortFn, like \uasort()/\uksort(), but stable: when two items are equivalent ($sortFn returns 0), their original relative order is preserved instead of being left unspe…

Sort a (possibly nested) array of source urls by urlPriority, in place.

Split a path string by / into segments, unescaping each one.

Split string on space, except for quoted words

Parse a uri into its RFC 3986 parts.

Split a version string into an array of at least 3 elements [major, minor, patch, ...prerelease], per Semantic Versioning.

Split text ignoring ANSI sequences

Split a class name into its namespace and its short name.

Same as split(), but normalizes \ to / first when $isWindows is true.

Same as \parse_str(), except it distinguishes the three ways an "empty" query value can be written -- the exact reverse of buildQuery(): - xxx= -> '' (empty string) - xxx (no = at all)…

Standardize traces returned by an Exception or debug_backtrace

Get the human-readable message for an HTTP status or shell exit code (MESSAGES).

Stop shell line buffering so you can capture direct input from user, without waiting for a flush (ENTER)

Replace every accented Latin character in $value with its plain-letter equivalent (getAccents()).

Collapse runs of horizontal whitespace to a single space, strip leading indentation on every line, and remove blank lines -- a generic text-compacting helper (NOT PHP-token-aware; phpStripWhit…

substr() ignoring ANSI sequences: offset and length count visible characters, whatever their bytes (UTF-8).

Print what went right, prefixed with '✔ ' in green.

Tells if the current output supports ANSI colors/escape sequences.

Tells if the current terminal support pty (pseudo terminal device).

Compile a list of svg files into a svg sprite.

Make a table text WARNING: to make sure columns are ordered correctly, make sure last item has all the columns in the right order

Create an empty, uniquely-named temporary file (in the {tmp} path alias) and return its filename.

Create an empty, uniquely-named temporary FOLDER (in the {tmp} path alias) and return its filename.

The source of a first test for a class, for the library's phpunit suite.

Pick whichever of 'black'/'white' text reads better on top of the given background color.

Build a case/accent-insensitive regex that matches $value literally, but where every letter also matches any of its accented forms (e.g.

Get an enum case from its backing value (for a BackedEnum) or its case name (for any enum), without throwing.

The length of the type a text starts with, read the way phpstan reads a doc tag: in list<string> the genres, the type is list<string>.

Get the JSON-Schema primitive type name of a PHP value (as used in a schema's type array).

Guess the JSON-Schema type of a raw text value (e.g.

Reverse of escape().

Merge a list of (possibly overlapping or adjacent) day intervals into the smallest set of non-overlapping intervals that covers the same days.

Get a small, stable, per-class-sequential id for an object (1, 2, 3, ...

Merge one or more iterables and keep only the first occurrence of each (strictly, ===) distinct value, re-indexed as a plain list (original keys are discarded).

Same as uniqueList(), but preserves the (first-seen) key of each distinct value instead of re-indexing.

The reverse of resolve(): recover the relative uri that, resolved against $base, would produce $uri.

Turn data produced by serialize() back into live objects/arrays.

Factory used by unserialize() to restore a DateTime serialized by serialize().

Same as unserializeDateTime(), but returns a DateTimeImmutable.

Factory used by unserialize() to restore an enum case serialized by serialize() (['$' => ...unserializeEnum, $class, $case->name]).

Restore an object's properties from serialized data, via reflection (bypassing setters).

Get the current request's full url.

Rank a source url so lower-priority (cheaper/faster to read) sources are processed first by sortUrls.

Split a UTF-8 string into an array of its characters (not bytes -- a multi-byte character stays whole).

Convert every 4-byte UTF-8 character (i.e.

Test if $value can be parsed by \DateTime::createFromFormat() using $format, AND round-trips back to exactly the same string when re-formatted -- i.e.

Validate a string against a JSON-Schema format keyword value.

Tells if a string is a syntactically valid Windows drive designation (a name made of characters allowed in a Windows filename, followed by :).

The low-level primitive get()/exists()/set()/delete()/push() are all built on: walk down a json-path (/-separated, RFC-6902-escaped -- \MMO\core\paths\split()) through nested arrays/Arr…

Print a warning message, prefixed with '!

Parse mode con's output (windows only).

Wrap a text so that no line is wider than $width visible characters -- an ANSI sequence takes no room, and a character is counted as one whatever its bytes (UTF-8).

Write $text to a stream.

Open a zip archive, throwing a descriptive exception (rather than returning an error code) on failure.