$1',
htmlspecialchars($text, ENT_QUOTES, 'UTF-8')
);
}
/**
* Strip all HTML tags and decode entities.
*/
public static function plainText(string $html): string
{
$text = strip_tags($html);
return html_entity_decode($text, ENT_QUOTES, 'UTF-8');
}
/**
* Convert a string to an excerpt (strip HTML, truncate to words).
*/
public static function excerpt(string $html, int $words = 30): string
{
return self::truncateWords(self::plainText($html), $words);
}
/**
* Pad a string on both sides to center it.
*/
public static function center(string $text, int $width, string $pad = ' '): string
{
return str_pad($text, $width, $pad, STR_PAD_BOTH);
}
/**
* Convert newlines to
tags.
*/
public static function nl2br(string $text): string
{
return nl2br(htmlspecialchars($text, ENT_QUOTES, 'UTF-8'));
}
}
// ─── Array Helpers ───────────────────────────────────────────────────────────
class Arr
{
/**
* Get a value from an array using dot notation.
*/
public static function get(array $array, string $key, mixed $default = null): mixed
{
if (array_key_exists($key, $array)) {
return $array[$key];
}
foreach (explode('.', $key) as $segment) {
if (!is_array($array) || !array_key_exists($segment, $array)) {
return $default;
}
$array = $array[$segment];
}
return $array;
}
/**
* Set a value in an array using dot notation.
*/
public static function set(array &$array, string $key, mixed $value): void
{
$keys = explode('.', $key);
$current = &$array;
foreach ($keys as $k) {
if (!isset($current[$k]) || !is_array($current[$k])) {
$current[$k] = [];
}
$current = &$current[$k];
}
$current = $value;
}
/**
* Check if a key exists using dot notation.
*/
public static function has(array $array, string $key): bool
{
if (array_key_exists($key, $array)) return true;
foreach (explode('.', $key) as $segment) {
if (!is_array($array) || !array_key_exists($segment, $array)) {
return false;
}
$array = $array[$segment];
}
return true;
}
/**
* Remove a key using dot notation.
*/
public static function forget(array &$array, string $key): void
{
$keys = explode('.', $key);
$last = array_pop($keys);
$current = &$array;
foreach ($keys as $k) {
if (!is_array($current) || !isset($current[$k])) return;
$current = &$current[$k];
}
unset($current[$last]);
}
/**
* Flatten a multi-dimensional array.
*/
public static function flatten(array $array, int $depth = PHP_INT_MAX): array
{
$result = [];
foreach ($array as $item) {
if (is_array($item) && $depth > 0) {
$result = array_merge($result, self::flatten($item, $depth - 1));
} else {
$result[] = $item;
}
}
return $result;
}
/**
* Pluck a single column from an array of arrays/objects.
*/
public static function pluck(array $array, string $key, ?string $indexBy = null): array
{
$result = [];
foreach ($array as $item) {
$value = is_object($item) ? ($item->$key ?? null) : ($item[$key] ?? null);
if ($indexBy !== null) {
$index = is_object($item) ? ($item->$indexBy ?? null) : ($item[$indexBy] ?? null);
$result[$index] = $value;
} else {
$result[] = $value;
}
}
return $result;
}
/**
* Group an array of arrays/objects by a key.
*/
public static function groupBy(array $array, string $key): array
{
$result = [];
foreach ($array as $item) {
$groupKey = is_object($item) ? ($item->$key ?? '') : ($item[$key] ?? '');
$result[$groupKey][] = $item;
}
return $result;
}
/**
* Return only the specified keys from an array.
*/
public static function only(array $array, array $keys): array
{
return array_intersect_key($array, array_flip($keys));
}
/**
* Return all keys except the specified ones.
*/
public static function except(array $array, array $keys): array
{
return array_diff_key($array, array_flip($keys));
}
/**
* Return the first element matching a callback, or a default.
*/
public static function first(array $array, ?callable $callback = null, mixed $default = null): mixed
{
if ($callback === null) {
return empty($array) ? $default : reset($array);
}
foreach ($array as $key => $value) {
if ($callback($value, $key)) return $value;
}
return $default;
}
/**
* Return the last element matching a callback, or a default.
*/
public static function last(array $array, ?callable $callback = null, mixed $default = null): mixed
{
return self::first(array_reverse($array, true), $callback, $default);
}
/**
* Filter an array where a key matches a value.
*/
public static function where(array $array, string $key, mixed $value): array
{
return array_filter($array, function ($item) use ($key, $value) {
$itemValue = is_object($item) ? ($item->$key ?? null) : ($item[$key] ?? null);
return $itemValue === $value;
});
}
/**
* Sort an array of arrays/objects by a key.
*/
public static function sortBy(array $array, string $key, string $direction = 'asc'): array
{
usort($array, function ($a, $b) use ($key, $direction) {
$aVal = is_object($a) ? ($a->$key ?? null) : ($a[$key] ?? null);
$bVal = is_object($b) ? ($b->$key ?? null) : ($b[$key] ?? null);
$cmp = $aVal <=> $bVal;
return $direction === 'desc' ? -$cmp : $cmp;
});
return $array;
}
/**
* Return unique values from an array of arrays/objects by a key.
*/
public static function uniqueBy(array $array, string $key): array
{
$seen = [];
$result = [];
foreach ($array as $item) {
$val = is_object($item) ? ($item->$key ?? null) : ($item[$key] ?? null);
if (!in_array($val, $seen, true)) {
$seen[] = $val;
$result[] = $item;
}
}
return $result;
}
/**
* Paginate an array and return a slice with metadata.
*/
public static function paginate(array $array, int $perPage = 15, int $page = 1): array
{
$total = count($array);
$totalPages = (int) ceil($total / $perPage);
$page = max(1, min($page, $totalPages));
$offset = ($page - 1) * $perPage;
return [
'data' => array_slice($array, $offset, $perPage),
'total' => $total,
'per_page' => $perPage,
'current_page' => $page,
'total_pages' => $totalPages,
'has_prev' => $page > 1,
'has_next' => $page < $totalPages,
];
}
/**
* Convert array to a key => value map (e.g. for