thejano/text-translator

A package to translate text from Google Translator for free without api.

1.1.0 2023-01-03 03:49 UTC

README

Latest Version on Packagist Total Downloads

This package allows text translation using Google Translate for free without an API. It extracts the translated text from the Google Translate website. Meanwhile, it only supports Google Translate.

Supported Languages for Google Translate

https://cloud.google.com/translate/docs/languages

Requirement

The package requires:

  • PHP 8.0 or higher

Installation

You can install the package via composer:

composer require thejano/text-translator

Usage

You can use the package like below example

<?php

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

use TheJano\TextTranslator\GoogleTranslator;

$text = 'Hello World';

$translator = new GoogleTranslator();

$translated =  $translator->translate($text,'ckb'); // ckb stands for Kurdish Sorani language 

echo $translated; // Prints سڵاو جیهان

# Or Call statically
GoogleTranslator::translate($text,'ckb'); 

# Translate from Arabic to English 
GoogleTranslator::translate('مرحبا بالعالم','en','ar'); // will returns Hello World

The class GoogleTranslator by default the source language is set to Auto, also you can override and provide target language on initiation.

new GoogleTranslator(string $sourceLanguage = 'auto', string $targetLanguage = '')

The translate method can be called statically or non statically, and it accepts three parameters, which are:

public function _translate(string $text, string $targetLanguage = '', string $sourceLanguage = ''): string;

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

License

The MIT License (MIT). Please see License File for more information.