" storage segment. * * @param int|string|null $order */ public static function key($order, string $folder, ?int $digits = null): string { $prefix = self::prefix($order, $digits); return $prefix !== '' ? $prefix . $folder : $folder; } /** * Parse a folder name into [order, slug, digits]. * Returns [null, $name, null] when there is no numeric prefix. * * @return array{0: int|null, 1: string, 2: int|null} */ public static function parse(string $name): array { if ($name !== '' && preg_match('/^(\d+)\.(.+)$/u', $name, $m) === 1) { return [(int) $m[1], $m[2], strlen($m[1])]; } return [null, $name, null]; } /** * Extract the digit width of an existing folder name's prefix, or null * when the folder has no numeric prefix. Cheap regex over a basename. */ public static function digitsFromFolder(?string $folder): ?int { if ($folder === null || $folder === '') { return null; } return preg_match('/^(\d+)\./u', $folder, $m) === 1 ? strlen($m[1]) : null; } /** * Configured default zero-pad width, cached per request. */ public static function defaultDigits(): int { if (self::$configuredDigits !== null) { return self::$configuredDigits; } $digits = self::DEFAULT_DIGITS; $grav = Grav::instance(); if (isset($grav['config'])) { $configured = (int) $grav['config']->get('system.pages.order_digits', self::DEFAULT_DIGITS); $digits = self::clampDigits($configured); } return self::$configuredDigits = $digits; } /** * Reset the cached default — for tests or after config reloads. */ public static function resetCache(): void { self::$configuredDigits = null; } private static function clampDigits(int $digits): int { if ($digits < self::MIN_DIGITS) { return self::MIN_DIGITS; } if ($digits > self::MAX_DIGITS) { return self::MAX_DIGITS; } return $digits; } }