PHPackages                             componist/lang-translate-api-deepl - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. componist/lang-translate-api-deepl

ActiveLibrary[Localization & i18n](/categories/localization)

componist/lang-translate-api-deepl
==================================

01PHP

Since Sep 30Pushed 7mo agoCompare

[ Source](https://github.com/componist/lang-translate-api-deepl)[ Packagist](https://packagist.org/packages/componist/lang-translate-api-deepl)[ RSS](/packages/componist-lang-translate-api-deepl/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Lang Translate API DeepL
========================

[](#lang-translate-api-deepl)

Ein Laravel Package zum automatischen Übersetzen von Sprachdateien mit der DeepL API.

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![PHP Version](https://camo.githubusercontent.com/7663c9d53dc13cedaf0660a8745a7e77d2dd711257f36aa86ebce12a0600ef42/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d626c75652e737667)](https://www.php.net/)[![Laravel](https://camo.githubusercontent.com/36ab9eb40d419c375ec1c19e6d5fd0d5ae0aeb01372cc6b164966c412feecdad/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302532422d7265642e737667)](https://laravel.com/)

📋 Inhaltsverzeichnis
--------------------

[](#-inhaltsverzeichnis)

- [Überblick](#%C3%BCberblick)
- [Features](#features)
- [Installation](#installation)
- [Konfiguration](#konfiguration)
- [Verwendung](#verwendung)
- [Beispiele](#beispiele)
- [API-Referenz](#api-referenz)
- [Unterstützte Sprachen](#unterst%C3%BCtzte-sprachen)
- [Best Practices](#best-practices)
- [Troubleshooting](#troubleshooting)
- [Entwicklung](#entwicklung)
- [Lizenz](#lizenz)

🎯 Überblick
-----------

[](#-überblick)

**Lang Translate API DeepL** ist ein Laravel Package, das die automatische Übersetzung von Laravel-Sprachdateien (.php) mit der DeepL API ermöglicht. Es bietet einen Artisan-Command, der verschachtelte Arrays unterstützt und einen sicheren Dry-Run-Modus für Tests bereitstellt.

### Hauptfunktionen

[](#hauptfunktionen)

- ✅ **Automatische Übersetzung** von Laravel-Sprachdateien
- ✅ **DeepL API Integration** für hochwertige Übersetzungen
- ✅ **Verschachtelte Arrays** werden rekursiv verarbeitet
- ✅ **Dry-Run Modus** für sichere Tests
- ✅ **Flexible Sprachkonfiguration** (Quell- und Zielsprachen)
- ✅ **Robuste Fehlerbehandlung** mit Timeout-Schutz
- ✅ **Laravel Service Provider** für einfache Integration

🚀 Features
----------

[](#-features)

### Core Features

[](#core-features)

FeatureBeschreibung**String-Übersetzung**Übersetzt ausschließlich String-Werte, lässt andere Datentypen unverändert**Rekursive Verarbeitung**Unterstützt mehrstufige Array-Strukturen**Dry-Run Modus**Sichere Tests ohne Dateiänderungen**Konfigurierbare Sprachen**Flexible Quell- und Zielsprachen**API-Integration**Direkte DeepL API Integration mit Fehlerbehandlung### Sicherheitsfeatures

[](#sicherheitsfeatures)

FeatureBeschreibung**Validierung**Überprüft Dateiexistenz und Format**API-Key Validierung**Überprüft DeepL API Key Konfiguration**Fehlerbehandlung**Graceful Handling von Netzwerk- und API-Fehlern**Timeout-Schutz**30-Sekunden Timeout für API-Requests📦 Installation
--------------

[](#-installation)

### 1. Package installieren

[](#1-package-installieren)

```
composer require componist/lang-translate-api-deepl --dev
```

### 2. Service Provider registrieren

[](#2-service-provider-registrieren)

Der Service Provider wird automatisch registriert. Falls Sie Laravel 5.5+ verwenden, ist keine manuelle Registrierung erforderlich.

### 3. DeepL API Key konfigurieren

[](#3-deepl-api-key-konfigurieren)

Fügen Sie Ihren DeepL API Key zur `.env` hinzu:

```
// .env
DEEPL_API_KEY=your_deepl_api_key_here
```

### 4. DeepL API Key erhalten

[](#4-deepl-api-key-erhalten)

1. Registrieren Sie sich auf [DeepL API](https://www.deepl.com/pro-api)
2. Erstellen Sie einen kostenlosen API Key (500.000 Zeichen/Monat)
3. Fügen Sie den Key zur `.env` Datei hinzu

⚙️ Konfiguration
----------------

[](#️-konfiguration)

### Umgebungsvariablen

[](#umgebungsvariablen)

VariableBeschreibungStandard`DEEPL_API_KEY`Ihr DeepL API Key-🎮 Verwendung
------------

[](#-verwendung)

### Artisan Command

[](#artisan-command)

Das Package registriert einen Artisan-Command `translate:lang-file`:

```
php artisan translate:lang-file [options] [--]
```

### Parameter

[](#parameter)

ParameterBeschreibungErforderlich`file`Pfad zur Sprachdatei, die übersetzt werden soll✅### Optionen

[](#optionen)

OptionBeschreibungStandardErforderlich`--source[=SOURCE]`Quellsprache (ISO-Code)`de`❌`--target[=TARGET]`Zielsprache (ISO-Code)`en`❌`--dry-run`Zeigt was übersetzt würde, ohne Änderungen vorzunehmen-❌📝 Beispiele
-----------

[](#-beispiele)

### 1. Grundlegende Verwendung

[](#1-grundlegende-verwendung)

```
# Deutsch → Englisch (Standard)
php artisan translate:lang-file lang/en/messages.php

# Mit expliziten Sprachen
php artisan translate:lang-file lang/en/messages.php --source=de --target=en
```

### 2. Verschiedene Sprachkombinationen

[](#2-verschiedene-sprachkombinationen)

```
# Deutsch → Französisch
php artisan translate:lang-file lang/fr/messages.php --source=de --target=fr

# Deutsch → Spanisch
php artisan translate:lang-file lang/es/messages.php --source=de --target=es

# Englisch → Deutsch
php artisan translate:lang-file lang/de/messages.php --source=en --target=de
```

### 3. Dry-Run Modus

[](#3-dry-run-modus)

```
# Test ohne Änderungen
php artisan translate:lang-file lang/en/messages.php --dry-run
```

### 4. Hilfe anzeigen

[](#4-hilfe-anzeigen)

```
php artisan translate:lang-file --help
```

🔄 Beispiel-Übersetzung
----------------------

[](#-beispiel-übersetzung)

### Eingabe (`lang/de/messages.php`):

[](#eingabe-langdemessagesphp)

```