statickidz/php-google-translate-free

The `statickidz/php-google-translate-free` library is a PHP package designed to translate text using the unofficial public Google Translate service, without requiring an API key. Unlike Google Cloud Translation API, which is a paid service, this library leverages the free, web-based Google Translate functionality, often by mimicking browser requests or scraping the public interface.

Key Features and Characteristics:
* Free Usage: The primary advantage is that it doesn't require any API keys or payment, making it accessible for personal projects, quick prototypes, or scenarios with limited budgets.
* Ease of Use: It provides a straightforward interface to perform translations, usually by specifying the source text, source language, and target language.
* Composer Integration: It's easily installable via Composer, the popular PHP dependency manager.

Important Considerations and Limitations:
* Unofficial and Unsupported: This library is not officially endorsed or supported by Google. Google can change its public translation interface at any time, which might break the library's functionality.
* Reliability: Due to its unofficial nature, there are no guarantees regarding its uptime, stability, or long-term reliability. It's generally not recommended for critical production systems that require high availability or consistent performance.
* Rate Limiting: Extensive usage from a single IP address might trigger Google's rate limiting mechanisms, leading to temporary blocks or failed translation requests. Users should be aware of Google's terms of service and acceptable use policies.
* Accuracy: While it uses Google Translate's underlying translation engine, the accuracy and quality of translations are subject to the same limitations as the public Google Translate service itself.
* Limited Features: It typically offers basic text translation and may not support advanced features like document translation, glossary integration, or custom models available in the official Google Cloud Translation API.

In summary, `statickidz/php-google-translate-free` is a convenient solution for non-critical translation needs where a free, quick-to-implement option is preferred. For robust, scalable, and enterprise-grade translation requirements, the official Google Cloud Translation API or similar paid services are more appropriate.

<?php

require_once __DIR__ . '/vendor/autoload.php';

use Statickidz\GoogleTranslate\GoogleTranslate;

// --- Installation (using Composer) ---
// If you haven't already, install the library via Composer in your project directory:
// composer require statickidz/php-google-translate-free

// --- Basic Usage Example ---

try {
    $sourceLanguage = 'en'; // Source language (English)
    $targetLanguage = 'es'; // Target language (Spanish)
    $textToTranslate = 'Hello, how are you? This is an example of text translation using a free PHP library.';

    echo "Original Text (en): " . $textToTranslate . "\n";

    // Initialize the GoogleTranslate instance
    $translator = new GoogleTranslate();

    // Perform the translation
    $translatedText = $translator->translate($sourceLanguage, $targetLanguage, $textToTranslate);

    echo "Translated Text (es): " . $translatedText . "\n\n";

    // --- Another example: German to French ---
    $sourceLanguage2 = 'de'; // Source language (German)
    $targetLanguage2 = 'fr'; // Target language (French)
    $textToTranslate2 = 'Guten Tag, wie geht es Ihnen heute?';

    echo "Original Text (de): " . $textToTranslate2 . "\n";
    $translatedText2 = $translator->translate($sourceLanguage2, $targetLanguage2, $textToTranslate2);
    echo "Translated Text (fr): " . $translatedText2 . "\n\n";

    // --- Example with an unsupported language code (will likely throw an exception) ---
    // $sourceLanguage3 = 'xx'; // Invalid language code
    // $targetLanguage3 = 'en';
    // $textToTranslate3 = 'Some text here.';
    // echo "Trying with invalid language...\n";
    // $translatedText3 = $translator->translate($sourceLanguage3, $targetLanguage3, $textToTranslate3);
    // echo "Translated Text: " . $translatedText3 . "\n\n";

} catch (\Exception $e) {
    echo "An error occurred during translation: " . $e->getMessage() . "\n";
    // For debugging, you might want to log the full exception:
    // error_log("Translation error: " . $e->getMessage() . "\n" . $e->getTraceAsString());
}

?>