README

简单翻译文本。

这是一个无需依赖项的简单库，用于自动翻译您的文本。

📦 安装

最好使用 Composer 进行安装，您也可以在 Packagist 和 GitHub 上找到此包。

要安装，只需使用以下命令

$ composer require baraja-core/deepl

您可以通过创建内部类的实例或注册DIC扩展来直接将服务链接到Nette框架来手动使用此包。

如何使用

此库无需依赖项。只需创建一个实例，传递API密钥并开始翻译

$apiKey = '...';
$isFreeApiKey = true;
$deepl = new \Baraja\Deepl\Deepl($apiKey, $isFreeApiKey);

// Translate "Hello!" to DE
echo $deepl->translate('Hello!', DeeplLocale::DE);

此库设计得尽可能简单易用。同时，您可以轻松配置所有模块。

支持的语言

您可以从 DeeplLocale 枚举中获取支持语言列表

echo 'Supported languages: ';
$enumValues = array_map(static fn(\UnitEnum $case): string => htmlspecialchars($case->value ?? $case->name), DeeplLocale::cases());
echo implode(', ', $enumValues);

对于正常翻译工作，我们建议直接使用内置枚举情况

$deepl->translate('Text', DeeplLocale::CS, DeeplLocale::EN);

第一个语言参数指定翻译的目标语言，第二个参数指定源语言。如果您没有指定语言，它将自动检测。

翻译缓存

我们知道，重复翻译相同的请求可能会非常昂贵，因为API按实际请求计费。因此，此库直接实现了一个本地缓存，用于在临时存储中存储翻译结果。

默认缓存实现是 FileResultCache 服务，其中您可以配置自定义磁盘路径。缓存默认存储在 sys_get_temp_dir() . '/deepl'。

$cache = new \Depl\FileResultCache(__DIR__ . '/cache');
$apiKey = '...';
$deepl = new \Baraja\Deepl\Deepl($apiKey, false, $cache);

📄 许可证

baraja-core/deepl 在MIT许可下授权。有关更多详细信息，请参阅LICENSE 文件。

baraja-core / deepl

维护者