Rechercher dans la communauté

Bien le bonjour moussaillon, et bienvenue à toi sur un nouveau tutoriel passionnant et assez complexe à la fois. Aujourd'hui, après quelques mois d'absence, je reviens vers toi pour te partager un script que j'ai créé, sur lequel j'ai passé 5h, et qui s'avérait être inexistant sur la toile. Oui, aujourd'hui, tu vas apprendre à intégrer en PHP/JSON l'API Deepl sur ton site internet, ce qui te permettra de proposer à tes internautes, la possibilité de traduire proprement et dans le respect de l'art ton site internet. Ce tutoriel fait suite à un autre tutoriel que j'avais présenté par le passé sur HabboDev, et qui reste accessible ici. Nous pouvons maintenant commencer ! Une documentation complète et officielle est accessible à ce lien : [hide]https://www.deepl.com/docs-api/[/hide] Pour pouvoir intégrer l'API Deepl à ton site internet, il te faudra un minimum de connaissances dans le domaines des tableaux, du curl et/ou du httprequest. De plus, la mauvaise nouvelle, c'est qu'il te faudra un compte "Développeur" afin de pouvoir avoir accès à une clé d'authentification qui te permettra par la suite d'utiliser l'API sur ton site internet, malheureusement, l'abonnement coûte 5€/mois puis 20,00 € pour 1 000 000 de caractères traduits (tu as de la marge). Ensuite, la bonne nouvelle, c'est que Deepl propose 1 mois GRATUIT à tous les nouveaux utilisateurs, ce qui te permettra de pouvoir au moins tester l'API, t'entraîner, voir peut-être par la suite, l'utiliser pour des clients potentiels (si tu es freelance) ou tout simplement pour la future entreprise pour laquelle tu travailleras. Lien des tarifs (Section Développeur) : https://www.deepl.com/pro?cta=menu-plans/ Enfin, rien ne t'oblige à utiliser cet API, car il existe bien d'autres manières pour pouvoir proposer un système de traduction à tes futurs internautes, mais il faut tirer que du positif de ce tutoriel, car, en plus de te sortir de ta zone de confort, il t'enseignera des rudiments du code qui te seront importants pour la poursuite de tes études et/ou de ton apprentissage dans le développement. CURL, et les TABLEAUX sont des fondamentaux en PHP. Une personne se prétendant "Développeur" et ne sachant pas les utiliser, est une personne qui est vouée à l'échec dans ce domaine. Nous pouvons commencer ! Etape I - Choisir une méthode Tu vas devoir déjà faire un choix entre la méthode CURL et la méthode HTTPREQUEST pour pouvoir consommer ton API. Etape II - Convertir CURL et/ou HTTPREQUEST en PHP Si tu es plus expérimenté, je te laisse la possibilité de faire à ta manière, voici en tout cas les informations à consommer pour 1 mot à traduire : - Méthode Curl curl https://api.deepl.com/v2/translate \ -d auth_key=[yourAuthKey] \ -d "text=Hello, world" \ -d "target_lang=FR" - Méthode HTPPREQUEST POST /v2/translate?auth_key=[yourAuthKey]> HTTP/1.0 Host: api.deepl.com User-Agent: YourApp Accept: */* Content-Length: 54 Content-Type: application/x-www-form-urlencoded auth_key=[yourAuthKey]&text=Hello, world&target_lang=FR Si tu es moins expérimenté, nous allons partir sur la méthode CURL et la convertir en PHP : - Méthode Curl curl https://api.deepl.com/v2/translate \ -d auth_key=[yourAuthKey] \ -d "text=Hello, world" \ -d "target_lang=FR" Tu vas utiliser un convertisseur déjà existant grâce à curl-to-PHP, et coller le code ci-dessus dans la case prévue à cet effet (c'est magique, et plutôt rapide ). Tu devrais avoir ce résultat : // Generated by curl-to-PHP: http://incarnate.github.io/curl-to-php/ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://api.deepl.com/v2/translate'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, "auth_key=[yourAuthKey]&text=Hello, world&target_lang=FR"); $headers = array(); $headers[] = 'Content-Type: application/x-www-form-urlencoded'; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); Etape III - Paramétrer le code PHP Si tu comprends bien l'Anglais, et que tu as un minimum de compétences dans ce domaine, tu dois déjà avoir trouvé les paramètres à modifier dans le code. Sinon, je vais t'éclairer : Et voilà, tu as fini de paramétrer ton code ! Etape IV - Convertir le JSON vers le BRUT Et maintenant, il va falloir afficher ton mot traduit, et pour cela, tu vas devoir jouer avec du JSON et du PHP : <?php // Generated by curl-to-PHP: http://incarnate.github.io/curl-to-php/ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, 'https://api.deepl.com/v2/translate'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, "auth_key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx&text=Hello, world&target_lang=FR"); $headers = array(); $headers[] = 'Content-Type: application/x-www-form-urlencoded'; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); $translatedWords = json_decode($result, true); // Décoder le mot $result = $translatedWords['translations'][0]['text']; // Chercher le mot echo $result; // Afficher le mot Et voilà, ton site est bien connecté à Deepl ! Si tout s'est bien passé; et que tu as bien suivi le tutoriel, ceci devrait s'afficher : Et enfin, comme d'habitude, si tu as eu la flemme de suivre le tutoriel et que tu préfères le direct, voici le lien de téléchargement du code : [hide] index.php [/hide] Eh voilà moussaillon, ce sujet touche enfin à sa fin ! J'espère qu'il te sera utile, et que tu proposeras aux utilisateurs d'inshare, une version améliorée de ce script afin de le faire perdurer dans le temps ! En attendant, je te souhaite une bonne continuation, et un bon courage pour la suite, et que la mer soit avec toi !