rex_string & rex_formatter

// Dateiname-Normalisierung (Upload-Handling)
$filename = rex_string::normalize($_FILES['upload']['name']);
// "Über 50€ Sparen!.pdf" → "ueber_50_sparen_pdf"

// Slug mit Bindestrichen
$slug = rex_string::normalize($title, '-');
// "Hallo Welt!" → "hallo-welt"

// Erlaubte Zeichen definieren
$key = rex_string::normalize($input, '_', '.-');
// "my-file.2023" → "my-file.2023" (Punkte/Bindestriche erlaubt)

// Short-Key Generator (YForm, ID-Kombination)
$shortKey = rex_string::normalize($city . '_' . $id);
// "München_123" → "muenchen_123"

// Config speichern
$config = ['api_key' => 'abc', 'timeout' => 30];
rex_file::put(
    rex_path::addonData('myaddon', 'config.yml'),
    rex_string::yamlEncode($config)
);

// Config laden
try {
    $yaml = rex_file::get(rex_path::addonData('myaddon', 'config.yml'));
    $config = rex_string::yamlDecode($yaml);
} catch (rex_yaml_parse_exception $e) {
    rex_logger::logException($e);
}

// URL-Parameter (verschachtelt)
$params = [
    'func' => 'edit',
    'filter' => ['status' => 1, 'cat' => [2, 5]]
];
$query = rex_string::buildQuery($params);
// "func=edit&filter[status]=1&filter[cat][0]=2&filter[cat][1]=5"

// HTML-Attribute
$attrs = rex_string::buildAttributes([
    'id' => 'myform',
    'class' => ['form', 'form-horizontal'],
    'data-action' => 'submit'
]);
// ' id="myform" class="form form-horizontal" data-action="submit"'

// CLI-Parameter parsen
$input = "cmd --option='value with spaces' --flag";
$parts = rex_string::split($input);
// ['cmd', 'option' => 'value with spaces', 'flag']

// Form-Attribute parsen
$attrs = rex_string::split("class='btn btn-primary' disabled");
// ['class' => 'btn btn-primary', 'disabled']

// IntlDateFormatter (empfohlen, locale-aware)
echo rex_formatter::intlDate('2025-01-15');
// de: "15. Jan. 2025" | en: "Jan 15, 2025"

echo rex_formatter::intlDateTime('2025-01-15 14:30:00', IntlDateFormatter::SHORT);
// de: "15.01.25, 14:30" | en: "1/15/25, 2:30 PM"

// Mit Custom Pattern
echo rex_formatter::intlDateTime($timestamp, 'dd.MM.y HH:mm');
// "15.01.2025 14:30"

// Nur Zeit
echo rex_formatter::intlTime(time());
// de: "14:30" | en: "2:30 PM"

// Array-Format [DateFormat, TimeFormat]
echo rex_formatter::intlDateTime($date, [IntlDateFormatter::SHORT, IntlDateFormatter::MEDIUM]);
// de: "15.01.25, 14:30:00"

// rex_list – Datumsspalten formatieren
$list->setColumnFormat('createdate', 'custom', function($params) {
    return rex_formatter::intlDateTime($params['value'], IntlDateFormatter::SHORT);
});

// rex_list – Dateigröße
$list->setColumnFormat('filesize', 'bytes', [2]);
// 1536000 → "1.46 MiB"

// rex_list – Zahlen
$list->setColumnFormat('price', 'number', [2, ',', '.']);
// 1234.5 → "1.234,50"

// Text kürzen (Snippet-Anzeige)
$short = rex_formatter::truncate($description, [
    'length' => 120,
    'etc' => '…',
    'break_words' => false // Wörter nicht trennen
]);

// Hurenkind vermeiden (typografisch)
$headline = rex_formatter::widont('Das ist eine lange Überschrift');
// "Das ist eine lange Überschrift" (letztes Space → nbsp)

// Eigene Formatierung (YForm-Style)
rex_formatter::custom($value, function($val) {
    return '<span class="badge">' . strtoupper($val) . '</span>';
});

// Mit zusätzlichen Parametern
rex_formatter::custom($value, [
    'MyClass::formatStatus',
    ['classes' => 'badge badge-success']
]);

class MyClass {
    public static function formatStatus($params) {
        // $params['subject'] = $value
        // $params['classes'] = 'badge badge-success'
        return '<span class="' . $params['classes'] . '">' . $params['subject'] . '</span>';
    }
}

// Version kürzen
echo rex_formatter::version('5.17.1', '%s.%s');
// "5.17"

echo rex_formatter::version('2.1.3', 'v%s.%s.%s');
// "v2.1.3"

// URL-Link generieren
echo rex_formatter::url('example.com', [
    'attr' => ' target="_blank" rel="noopener"',
    'params' => 'ref=newsletter'
]);
// <a href="http://example.com?ref=newsletter" target="_blank" rel="noopener">http://example.com</a>

// E-Mail-Link
echo rex_formatter::email('info@example.com', [
    'params' => 'subject=Anfrage&body=Hallo...'
]);
// <a href="mailto:info@example.com?subject=Anfrage&body=Hallo...">info@example.com</a>

// Upload-Verarbeitung
$file = $_FILES['upload'];
$filename = rex_string::normalize($file['name'], '_', '.-');
$target = rex_path::addonData('uploads', $filename);

if (move_uploaded_file($file['tmp_name'], $target)) {
    $size = rex_formatter::bytes(filesize($target), [2]);
    $date = rex_formatter::intlDateTime(time());
    
    rex_logger::factory()->log(
        "Upload: {$filename} ({$size}) am {$date}",
        rex_logger::INFO
    );
}