Halo semuanya,
Dalam beberapa bulan terakhir kami tidak memberikan banyak perhatian pada ProJekt ini. DEEPL di sisi lain telah mengembangkan pustaka klien untuk Python, .net dan node.js (lihat: API-DOC).
Karena ada php-library dalam karya GitHub dan rekam jejak kami dengan mempertahankan perpustakaan kami tidak sebagus yang seharusnya, kami memutuskan untuk meninggalkan perpustakaan ini dan beralih secara internal ke yang resmi.
Untuk memperjelas bahwa kami tidak akan terus mengerjakan repositori ini, kami akan mengarsipkannya. Jika ada orang dari komunitas yang ingin melanjutkan pekerjaan kami, kami dapat menempatkan garis di readme untuk menunjuk ke repositori yang dipertahankan baru.
Jika tidak, kami sarankan Anda untuk memeriksa perpustakaan baru yang berasal dari Deepl.
Terima kasih untuk semua orang yang berkontribusi pada proyek ini selama bertahun -tahun.
Perpustakaan PHP sederhana untuk API Deept. Anda dapat menerjemahkan satu atau beberapa string teks (hingga 50) per permintaan.
???????????????????????????????????????????????????????
API DEEPL Resmi
Changelog
Gunakan komposer jika Anda ingin menggunakan perpustakaan ini di proyek Anda.
composer require babymarkt/deepl-php-libBuat contoh dengan kunci auth Anda:
use BabyMarkt DeepL DeepL ;
$ authKey = ' <AUTH KEY> ' ;
$ deepl = new DeepL ( $ authKey );Gunakan Deepl API Pro:
use BabyMarkt DeepL DeepL ;
$ authKey = ' <AUTH KEY> ' ;
$ deepl = new DeepL ( $ authKey , 2 , ' api-free.deepl.com ' );Menerjemahkan satu teks:
$ translatedText = $ deepl -> translate ( ' Hallo Welt ' , ' de ' , ' en ' );
echo $ translatedText [ 0 ][ ' text ' ]. PHP_EOL ;Terjemahkan banyak teks:
$ text = array (
' Hallo Welt ' ,
' Wie geht es dir ' ,
' Macht doch einfach mal '
);
$ translations = $ deepl -> translate ( $ text , ' de ' , ' en ' );
foreach ( $ translations as $ translation ) {
echo $ translation [ ' text ' ]. PHP_EOL ;
}| param | Keterangan |
|---|---|
| $ teks | Teks yang akan diterjemahkan. Hanya teks polos yang dikodekan UTF8 yang didukung. Parameter dapat ditentukan sebagai array dan terjemahan dikembalikan dalam urutan yang sama seperti yang diminta. Setiap nilai array dapat berisi beberapa kalimat. Hingga 50 teks dapat dikirim untuk diterjemahkan dalam satu permintaan. |
| $ Sourcelang | Bahasa teks yang akan diterjemahkan. Default: "" (Deepl Will Auto-Detect) |
| $ targetlang | Bahasa di mana teks harus diterjemahkan. Default: en |
| $ taghandling | Set tag jenis apa yang harus ditangani. Opsi saat ini tersedia: "XML" |
| $ Ignoretags | Array tag XML yang menunjukkan teks untuk tidak diterjemahkan. Default: NULL |
| $ formalitas | Menetapkan apakah teks yang diterjemahkan harus condong ke arah bahasa formal atau informal. Fitur ini saat ini berfungsi untuk semua bahasa target kecuali "en" (bahasa Inggris), "en-gb" (Inggris Inggris), "en-us" (bahasa Inggris Amerika), "ES" (Spanyol), "JA" (Jepang) dan "ZH" (Cina). Pilihan yang mungkin adalah: "default" (default) "lebih" - untuk bahasa yang lebih formal "Kurang" - untuk bahasa yang lebih informal |
| $ splitsentences | Array tag xml yang selalu menyebabkan perpecahan Default: NULL |
| $ PreserveFormatting | Menetapkan apakah mesin terjemahan harus menghormati pemformatan asli, bahkan jika biasanya akan memperbaiki beberapa aspek. Nilai yang mungkin adalah: "0" (default) "1" Aspek pemformatan yang dipengaruhi oleh pengaturan ini meliputi: Tanda baca di awal dan akhir kalimat Kasus atas/bawah di awal kalimat |
| $ nonsplittingtags | Daftar tag XML yang dipisahkan secara koma yang tidak pernah membagi kalimat. Default: NULL |
| $ Outlinedetection | Lihat: https://www.deepl.com/docs-api/handling-xml/outline-detection/ Default: 1 |
| $ splittingtags | Array tag XML yang selalu menyebabkan perpecahan. Default: NULL |
Dalam versi 2 kami menghapus daftar internal bahasa yang didukung. Sebaliknya, Anda sekarang bisa mendapatkan array dengan bahasa yang didukung secara langsung membentuk Deepl:
$ languagesArray = $ deepl -> languages ();
foreach ( $ languagesArray as $ language ) {
echo ' Name: ' . $ language [ ' name ' ]. ' Api-Shorthand: ' . $ language [ ' language ' ]. PHP_EOL ;
}Anda dapat memeriksa bahasa sumber yang didukung:
$ sourceLanguagesArray = $ deepl -> languages ( ' source ' );
foreach ( $ sourceLanguagesArray as $ sourceLanguage ) {
echo ' Name: ' . $ sourceLanguage [ ' name ' ]. ' Api-shorthand: ' . $ sourceLanguage [ ' language ' ]. PHP_EOL ;
}Periksa bahasa target yang didukung:
$ targetLanguagesArray = $ deepl -> languages ( ' target ' );
foreach ( $ targetLanguagesArray as $ targetLanguage ) {
echo ' Name: ' . $ targetLanguage [ ' name ' ]. ' Api-Shorthand: ' . $ targetLanguage [ ' language ' ]. PHP_EOL ;
}Anda sekarang dapat memeriksa berapa banyak yang Anda terjemahkan, serta batasnya:
$ usageArray = $ deepl -> usage ();
echo ' You have used ' . $ usageArray [ ' character_count ' ]. ' of ' . $ usageArray [ ' character_limit ' ]. ' in the current billing period. ' . PHP_EOL ;Buat glosarium
$ glossary = $ deepl -> createGlossary ( ' MyGlossary ' , [ ' Hallo ' => ' Hello ' ], ' de ' , ' en ' );| param | Keterangan |
|---|---|
| $ name | Nama Glosarium |
| $ entri | Array entri |
| $ Sourcelanguage | Bahasa sumber yang diterapkan aturan glosarium |
| $ TargetLanguage | Bahasa target di mana aturan glosarium berlaku |
Hapus glosarium
$ glossary = $ deepl -> deleteGlossary ( $ glossaryId );| param | Keterangan |
|---|---|
| $ glosaryid | Glosarium UUID (diatur oleh Deepl saat glosarium dibuat) |
Daftar glosarium
use BabyMarkt DeepL Glossary ;
$ glossaries = $ deepl -> listGlossaries ();
foreach ( $ glossaries as $ glossary ) {
var_dump ( $ glossary );
}Dapatkan Informasi Meta Glosarium: Tanggal Pembuatan, adalah glosarium siap digunakan ...
use BabyMarkt DeepL Glossary ;
$ glossaryInformation = $ deepl -> glossaryInformation ( $ glossaryId );
var_dump ( $ glossaryInformation );| param | Keterangan |
|---|---|
| $ glosaryid | Glosarium UUID (diatur oleh Deepl saat glosarium dibuat) |
Dapatkan entri glosarium
$ entries = $ deepl -> glossaryEntries ( $ glossaryId );
foreach ( $ entries as $ sourceLangText => $ targetLangText ) {
echo $ sourceLangText . ' > ' . $ targetLangText ;
}| param | Keterangan |
|---|---|
| $ glosaryid | Glosarium UUID (diatur oleh Deepl saat glosarium dibuat) |
Jika Anda perlu menggunakan proxy, Anda dapat mengkonfigurasi klien curl yang mendasarinya untuk menggunakannya. Anda juga dapat menentukan batas waktu untuk menghindari menunggu beberapa menit jika Deepl tidak terjangkau
$ deepl -> setTimeout ( 10 ); //give up after 10 seconds
$ deepl -> setProxy ( ' http://corporate-proxy.com:3128 ' );
$ deepl -> setProxyCredentials ( ' username:password ' );Jalankan tes php_codesniffer:
composer csJalankan tes PHPMD:
composer mdJalankan tes phpunit:
composer testJalankan semua tes:
composer test:allLisensi MIT (MIT). Silakan lihat file lisensi untuk informasi lebih lanjut.