tereta/utilities

Lightweight utility helpers for the Tereta Framework: byte formatting, slug/template strings, CIDR matching, path normalization, and Factory-enabled DOMDocument/DOMXPath wrappers.

1.0.11 2026-04-27 22:25 UTC

Requires

• php: >=8.4
• tereta/core: ^1.0.5

Apache-2.0

• Tereta Alexander

• framework
• network
• path
• helpers
• math
• dom
• string
• utilities
• cidr
• tereta

README

🌐 Русский | English

Overview

Lightweight utility module providing common helpers used across the application: math, string, network and filesystem-path primitives, plus Factory-trait wrappers around the native PHP DOM classes.

• Services

  • Math — unit-conversion helpers.
    • formatBytes(int $bytes) — human-readable byte formatting (1048576 → 1.00 MB; scales B → KB → MB → GB → TB).
  • Stringable — string-oriented helpers.
    • file(string $path, array $variables = []) — renders a .phtml template with extract()ed variables and a second {key} placeholder pass. Path is hardened via realpath() + is_file() to block path-traversal and null-byte injection.
    • identifier(string $string) — normalises arbitrary text into a slug-like snake_case token (lowercase, non-alphanumeric runs collapsed to _). Useful for cache keys, filenames, attribute names.
    • code(string $code) — prepares a heredoc-style snippet for <pre> output: trims blank edge lines, removes the common leading indent, HTML-escapes the result.
    • splitLines(string $string, int $length) — soft-wraps text at whitespace boundaries while preserving existing line breaks; counts length in Unicode code points.
  • Network — network-related helpers.
    • cidrMatch(string $ip, string $cidr) — tests whether an IPv4 or IPv6 address falls within a CIDR range; returns false on malformed input or family mismatch.
    • isPortOpen(string $host, int $port, float $timeout = 5.0) — TCP probe via fsockopen.
  • File — filesystem-path helpers (string-only, no I/O).
    • path(string $path, ?string $allowBase = null) — collapses empty segments, . and .. purely textually. When $allowBase is provided, throws RuntimeException if the resolved path falls outside that base — handy for sandboxing user-supplied paths.

• DOM wrappers (Tereta\Utilities\DOMDocument, Tereta\Utilities\DOMXPath) — extend the native classes and add the Tereta\Core\Traits\Factory trait so they can be instantiated through the framework's DI factory pipeline.

Installation

composer require tereta/utilities

Author and License

Author: Tereta Alexander
Website: tereta.dev
License: Apache License 2.0. See LICENSE.

 www.████████╗███████╗██████╗ ███████╗████████╗ █████╗
     ╚══██╔══╝██╔════╝██╔══██╗██╔════╝╚══██╔══╝██╔══██╗
        ██║   █████╗  ██████╔╝█████╗     ██║   ███████║
        ██║   ██╔══╝  ██╔══██╗██╔══╝     ██║   ██╔══██║
        ██║   ███████╗██║  ██║███████╗   ██║   ██║  ██║
        ╚═╝   ╚══════╝╚═╝  ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝
                                                      .dev

Copyright (c) 2008-2026 Tereta Alexander