Dokumentation - Server Grundfunktionen (public)

`CONST platform\deepl::LANGTARGET = 'target'`	selektiert die Zielsprache
`CONST platform\deepl::LANGSOURCE = 'source'`	selektiert die Quellsprache

static platform\deepl::translate ($string $text = null[, $string $object $targetLang = null[, $array $object $options = null]])

`$text`	gibt den Text an der übersetzt werden soll; auch HTML Tags sind verwendbar
`$targetLang`	optional; Angabe der Ziel-Sprache als string; Groß- und Kleinschreibung wird nicht beachtet; oder als new lang() Objekt; wird kein Sprachcode angegeben wird die Standartsprache von new lang() ausgegeben
`$options`	optional; legt Optionen als $array fest [ 'context' => null // legt den Kontext als string der Übersetzung fest 'formality' => null // Formell/Informell wählbar, nur bei unterstützten Sprachen: 'default', 'more', 'less', 'prefer_more', 'prefer_less' 'ignore_tags' => null // Liste von XML-Tags, deren Inhalt nicht übersetzt wird: 'br,h1' 'model_type' \| model => null // legt das Übersetzungsmodell als string fest, 'latency_optimized', 'quality_optimized', 'prefer_quality_optimized' 'non_splitting_tags' => null // Liste von XML-Tags, bei denen Sätze nie getrennt werden: 'br,h1' 'outline_detection' // bool, legt fest ob xml automatisch erkannt werden soll 'preserve_formatting' => null // bestimmt, ob das Originalformat strikt beibehalten wird 'show_billed_characters' => null // gibt bei Aktivierung die abrechnungsrelevante Zeichenanzahl zurück 'source_lang' \| 'sourcelang' => null // legt die Quellsprache fest als string oder new lang() Objekt 'split_sentences' => null // legt fest, ob der Text zuerst in Sätze aufgeteilt wird 'splitting_tags' => null // Liste von XML-Tags, die immer Satztrennungen auslösen 'tag_handling' \| tag => null // legt die Tags fest, 'xml', 'html' ]

https://developers.deepl.com/api-reference/translate/request-translation

gibt ein array zurück ['text' => 'Übersetzter Text', 'source_lang' => , 'target_lang' => ], mit den übersetzten Text; im Fehlerfall wird null zurückgegeben


    platform\deepl::translate('Groß- und Kleinschreibung wird nicht beachtet', 'en'));


    platform\deepl::translate('Apple AirPods Pro: Aktive Geräuschunterdrückung, Transparenzmodus, kabelloses Laden, Schweiß- und wasserresistent, bis zu 24 Stunden Akkulaufzeit.', 'en', ['source_lang' => new lang('de'), 'context' => 'Beschreibung eines Produktes']);

static platform\deepl::translateDoc ()

muss noch ausgearbeitet werden, wahrscheinlich deepl Pro Version notwendig

static platform\deepl::detectLang ($string $text = null)

$text gibt den Text an der übersetzt werden soll; auch HTML Tags sind verwendbar

gibt die erkannte Sprache des Textes als new lang() Objekt zurück; im Fehlerfall null


    platform\deepl::detectLang ('parle vous francais?'); // Rückgabe: new lang('fr')

static platform\deepl::supportLang ([$string $type = platform\deepl::LANGTARGET])

$type optional; gibt den Typ an, ob es sich um Zielsprachen oder Ausgangssprachen handelt

gibt ein new lang\container() Objekt zurück mit allen Sprachen die unterstützt werden; im Fehlerfall wird null zurückgegeben


    echo platform\deepl::supportLang (platform\deepl::LANGSOURCE);

static platform\deepl::supportMime ()

gibt immer ein new mime\container() Objekt zurück mit allen Mimetypen die unterstützt werden


    echo platform\deepl::supportMime ();

static platform\deepl::validLang ($string $object $lang = null[, $string $type = platform\deepl::LANGTARGET])

`$lang`	optional; Angabe der Sprache als string oder als new lang() Objekt
`$type`	optional; gibt den Typ an, ob es sich um Zielsprachen oder Ausgangssprachen handelt

gibt true zurück, wenn die angegebene Sprache von Deepl unterstützt wird; ansonsten wird false zurückgegeben


    var_dump(platform\deepl::validLang('en'));

static platform\deepl::validMime ($string $object $mime = null)

$mime optional; Angabe des Mimetypes als string oder als new mime() Objekt

gibt true zurück, wenn der Mimetype von Deepl unterstützt wird; ansonsten wird false zurückgegeben


    var_dump(platform\deepl::validMime('html'));

static platform\deepl::usage ()

gibt ein array zurück, wieviel Buchstaben schon übersetzt wurden ['character_count' => 0, 'character_limit' => 500000]; ansonsten wird null zurückgegeben


    print_r(platform\deepl::usage());