php-func-lib

Kleine PHP-Utility-Bibliothek mit wiederverwendbaren Helfern fuer:

• Strings und einfache Sanitization
• Zahlenformatierung
• SQL-Zugriffe (mysqli + prepared statements)
• Mailversand
• Link/OpenGraph-Metadaten
• Debug-Helfer
• Troy-/Gitea-API-Aufrufe

Installation

Als Git-Submodule in ein Projekt einbinden:

git submodule add https://git.seemsleg.it/pub/php-func-lib lib

Danach je nach Bedarf einzelne Dateien einbinden oder zentral ueber _func.php laden.

Schnellstart

<?php
include_once __DIR__ . '/lib/_func.php';

echo shortener("Ein sehr langer Text", 10); // "Ein sehr..."
echo decade(12345);                         // "12.345 K" (je nach PHP-Konvertierung)

Module

• string.php: String-Helfer (shortener, onlyAlpha, startsWith, endsWith, linkify, ...)
• numbers.php: Zahlen-Helfer (decade, onlyNumeric)
• sql.php: Klasse SQL fuer Datenbankzugriffe (get, single, list, keyval, set)
• mail.php: Mailfunktionen (send_mail, send_html_mail, send_php_mail)
• link-meta.php: URL-Validierung, Fetching, Meta-Parsing, Bilddownload, Tag-Sanitization
• og.php: Einfacher OG-Scan (scanOG)
• troy-api.php: API-Helfer fuer Troy/Gitea (sendToTroy, sendToGitea)
• debug.php: Cookie-basierte Debug-Ausgabe
• markdown.php: einfache Markdown-nahe Formatierung (md)

Konfiguration

Einige Module erwarten ein lokales secret.php (siehe secret.php.example), z. B. fuer:

• SQL-Zugangsdaten in sql.php
• optionale Absenderadresse in mail.php
• Gitea-Parameter in troy-api.php

Beispiel: Seitenmetadaten lesen

<?php
include_once __DIR__ . '/lib/link-meta.php';

$info = getPageInfo('https://example.org');
if ($info['ok']) {
    echo $info['title'];
}

Hinweise

• Die Bibliothek ist bewusst leichtgewichtig und ohne Composer-Setup gehalten.
• Einzelne Funktionen sind historisch gewachsen; fuer geplante Verbesserungen siehe next_steps.md.