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.

1.9 KiB Raw Blame History