Github : API SMS PHP

Cet article explique comment vous pouvez apporter des modifications à l'API SMS PHP, située sur GitHub, depuis votre ordinateur. Cette solution ne prendra qu'environ 20 minutes à réaliser. Vous apprendrez comment installer Git pour Windows et TortoiseGit. Cela commencera par le téléchargement de Git et se terminera par la visibilité de vos modifications sur GitHub. Nous supposons que vous êtes familier avec GitHub et PHP. La vidéo est facile à suivre et détaillée, vous n'aurez donc aucun mal à comprendre le processus. Ne perdez plus de temps ! Allons-y !

Qu'est-ce que l'API SMS PHP

L'API SMS PHP est un dépôt (bibliothèque) pour le codage PHP. Elle est destinée aux développeurs pour créer du code PHP qui interagit avec Ozeki SMS Gateway. Ce dépôt peut être utilisé pour diverses tâches, telles que l'envoi, la réception, la suppression et la planification de messages SMS. Comme elle est entièrement personnalisable, elle peut être utilisée pour toute condition définie par le développeur. Elle peut effectuer les opérations mentionnées ci-dessus en masse, comme l'envoi de SMS à des centaines de milliers de clients simultanément.

Qu'est-ce que Git pour Windows

Git signifie Global Information Tracker. C'est un logiciel qui vous permet de valider des modifications de code en ligne. Il est souvent associé à GitHub, car il télécharge les modifications sur le site web de GitHub. C'est incroyablement utile pour les tâches de codage où plusieurs personnes travaillent sur le même projet en même temps. Dans ce guide, nous allons valider une modification dans un code d'envoi de SMS PHP.

Qu'est-ce que GitHub

GitHub est une plateforme de collaboration basée sur le web pour les développeurs de logiciels. Elle est utile pour le contrôle de version, car dans les grands projets, plusieurs personnes peuvent travailler sur le même code simultanément. Les développeurs peuvent utiliser GitHub pour cloner des dépôts et des codes sources. Les modifications validées par les développeurs seront également téléchargées sur GitHub, où elles deviendront visibles une fois validées.

Qu'est-ce que TortoiseGit

TortoiseGit fournit des icônes de superposition et diverses options dans les menus Windows, destinées à être utilisées pour l'interaction avec GitHub. Ce programme permet aux développeurs d'accéder facilement aux fonctionnalités de validation et de mettre en ligne leurs modifications sur GitHub sans difficulté. Vous pouvez accéder à TortoiseGit en faisant un clic droit dans n'importe quel répertoire, après son installation. Il vous permet également d'attacher des journaux de modifications à vos validations. C'est utile pour les grands projets où plusieurs développeurs travaillent sur le même code.

Comment fonctionne le système

L'architecture du système fonctionne comme illustré dans la Figure 1. Tout d'abord, l'utilisateur doit télécharger la bibliothèque de l'API SMS PHP depuis GitHub. Ce processus est également appelé clonage. Une fois le clonage terminé, le dépôt est prêt à être utilisé. L'API SMS PHP envoie une Requête à Ozeki SMS Gateway fonctionnant sur votre ordinateur ou appareil mobile. Le SMS Gateway envoie ensuite le message SMS conformément à la requête. Il renvoie également un retour sous forme de Réponse. Cette réponse est utilisée pour confirmer que le message a été envoyé avec succès.

comment télécharger la dernière bibliothèque sms php depuis github
Figure 1 - Comment télécharger la dernière bibliothèque SMS PHP depuis Github

Comment télécharger l'API SMS PHP depuis GitHub (étapes rapides)

Pour télécharger l'API SMS PHP depuis GitHub :

  1. Configurer Ozeki SMS Gateway
  2. Télécharger Git pour Windows
  3. Installer TortoiseGit
  4. Exécuter l'assistant de première utilisation
  5. Créer un dossier pour l'API SMS PHP
  6. Cloner php-send-sms-http-rest-ozeki avec Git
  7. Valider les modifications dans l'API SMS PHP
  8. Se connecter à GitHub
  9. Vérifier les modifications sur GitHub

Télécharger : https://gitforwindows.org/

Télécharger : https://tortoisegit.org/download/

1. vidéo : Installer Git pour Windows

Dans cette vidéo, vous apprendrez comment installer Git (Vidéo 1). Ce logiciel vous permet de valider des modifications de code en ligne sur GitHub. Tout d'abord, nous allons télécharger l'installateur de Git depuis le site officiel. Ensuite, nous allons l'ouvrir et passer par le processus de configuration pour l'installation. Commencez par visiter le lien de téléchargement ci-dessus.

Vidéo 1 - Comment installer Git pour Windows (Tutoriel vidéo)

Télécharger Git pour Windows

Téléchargez Git pour Windows en visitant le lien suivant : https://gitforwindows.org/. Cliquez sur le bouton bleu Télécharger pour commencer à télécharger l'installateur de Git (Figure 2). Une fois terminé, Git est prêt à être installé sur votre ordinateur.

télécharger git pour windows
Figure 2 - Télécharger Git pour Windows

Ouvrir l'installateur

Ouvrez l'installateur de Git que vous avez précédemment téléchargé. Faites-le en cliquant dessus, dans la fenêtre de téléchargements en haut (Figure 3). L'ouverture de ce fichier lancera le processus d'installation de Git.

ouvrir l'installateur exe
Figure 3 - Ouvrir l'installateur exe

Accepter la licence

Pour commencer l'installation de Git, vous devez d'abord accepter le contrat de licence du logiciel. Cliquez sur le bouton Suivant pour le faire (Figure 4).

accepter la licence
Figure 4 - Accepter la licence

Sélectionner le chemin d'installation

Maintenant, vous devez sélectionner un chemin d'installation. Cliquez sur le bouton Parcourir pour sélectionner un répertoire ou laissez-le comme chemin par défaut (Figure 5). Cliquez sur Suivant pour continuer.

sélectionner l'emplacement d'installation
Figure 5 - Sélectionner l'emplacement d'installation

Sélectionner les composants

Ensuite, vous devez sélectionner les composants de Git que vous souhaitez installer (Figure 6). Nous recommandons de laisser les options par défaut sélectionnées. Cliquez sur Suivant pour continuer.

sélectionner les composants
Figure 6 - Sélectionner les composants

Sélectionner les options d'installation préférées

Maintenant, vous devez sélectionner vos options d'installation préférées. Pour cette instance, sélectionnez Git Credential Manager (Figure 7). Cliquez à nouveau sur Suivant pour continuer.

sélectionner les options d'installation préférées
Figure 7 - Sélectionner les options d'installation préférées

Processus d'installation

Le processus d'installation a maintenant commencé (Figure 8). Attendez que l'installateur termine le processus.

processus d'installation
Figure 8 - Processus d'installation

Terminer l'installation

Cliquez sur Terminer pour compléter l'installation (Figure 9) Git est maintenant installé avec succès et prêt à être utilisé.

terminer l'installation
Figure 9 - Terminer l'installation

2. vidéo : Installer TortoiseGit

Ce tutoriel vidéo vous montre comment télécharger et installer TortoiseGit. Ce logiciel permet à l'utilisateur de valider des modifications sur GitHub et d'attacher des journaux de modifications aux validations. Nous allons télécharger l'installateur de TortoiseGit depuis son site web. Exécutez l'installateur et configurez les détails de votre installation en suivant les étapes de cette vidéo (Vidéo 2).

Vidéo 2 - Comment installer TortoiseGit (Tutoriel vidéo)

Télécharger l'installateur de TortoiseGit

Téléchargez TortoiseGit depuis ce site web : https://tortoisegit.org/download/. Trouvez la section qui indique pour Windows 64 bits. Cliquez sur le lien Télécharger en dessous (Figure 10). Cela commencera le téléchargement de l'installateur de TortoiseGit dans le répertoire par défaut de votre navigateur.

télécharger l'installateur tortoisegit
Figure 10 - Télécharger l'installateur TortoiseGit

Ouvrir l'installateur

Une fois le téléchargement terminé, l'installateur de TortoiseGit apparaîtra dans vos téléchargements (Figure 11). Cliquez dessus pour lancer l'installateur.

ouvrir l'installateur msi
Figure 11 - Ouvrir l'installateur msi

Accepter la licence

Pour pouvoir utiliser le logiciel TortoiseGit, vous devez accepter le contrat de licence (Figure 12). Cliquez sur Suivant pour l'accepter et continuer.

accepter la licence
Figure 12 - Accepter la licence

Sélectionner les fonctionnalités et l'emplacement

Dans cette fenêtre, vous devez spécifier le chemin d'installation pour TortoiseGit (Figure 13). Vous devez également choisir les fonctionnalités que vous souhaitez installer avec le programme. Une fois tout terminé, cliquez sur Suivant pour continuer.

sélectionner les fonctionnalités et l'emplacement
Figure 13 - Sélectionner les fonctionnalités et l'emplacement

Commencer l'installation

Cliquez sur le bouton Installer pour commencer le processus d'installation (Figure 14). Attendez que l'installateur termine.

commencer l'installation
Figure 14 - Commencer l'installation

Terminer l'installation

Maintenant, l'installation est terminée. Activez l'option Exécuter l'assistant de première utilisation (Figure 15). Cliquez sur Terminer pour terminer la configuration. Vous serez redirigé vers la fenêtre de l'assistant de première utilisation.

terminer l'installation
Figure 15 - Terminer l'installation

Sélectionner la langue

Sur le premier écran de l'assistant de première utilisation, il vous sera demandé de choisir une langue. Choisissez Anglais et cliquez sur Suivant (Figure 16).

sélectionner la langue
Figure 16 - Sélectionner la langue

Configurer git.exe

Maintenant, vous devez configurer l'emplacement de git.exe (Figure 17). Cliquez sur le bouton Parcourir et choisissez un chemin de fichier. Ce répertoire est l'endroit où git.exe sera situé sur votre ordinateur après l'installation. Cliquez sur Suivant pour continuer.

configurer git exe
Figure 17 - Configurer git.exe

Configurer le nom d'utilisateur et l'e-mail Git

Git vous demande d'entrer votre nom d'utilisateur et votre adresse e-mail. Notez que ceux-ci sont utilisés pour vos validations et non pour l'authentification. Entrez votre nom et mot de passe dans les champs de texte respectifs (Figure 18). Cliquez sur Suivant pour continuer.

configurer le nom d'utilisateur et l'e-mail git
Figure 18 - Configurer le nom d'utilisateur et l'e-mail Git

Configurer l'authentification et le stockage des identifiants

La dernière étape consiste à configurer l'authentification et le stockage des identifiants. Vous devriez choisir OpenSSH dans la première liste déroulante (Figure 19). À côté de Gestionnaire d'identifiants, vous devriez sélectionner manager. Cliquez sur Terminer pour terminer le processus d'installation.

configurer l'authentification et le stockage des identifiants
Figure 19 - Configurer l'authentification et le stockage des identifiants

3. vidéo : Cloner un dépôt PHP avec Git

Dans ce tutoriel vidéo, vous apprendrez comment cloner un dépôt depuis GitHub en utilisant Tortoise Git. Cloner un dépôt est nécessaire pour utiliser ses fonctions dans vos codes. Accédez à la fonction de clonage depuis votre explorateur et collez l'URL de votre dépôt souhaité depuis GitHub pour commencer le clonage (Vidéo 3).

Vidéo 3 - Comment cloner un dépôt depuis GitHub en utilisant Tortoise Git (Tutoriel vidéo)

Copier l'URL du dépôt

Pour cloner le dépôt, vous devez d'abord copier l'URL du dépôt. Faites-le en visitant le dépôt sur le site web de GitHub. Cliquez sur le menu déroulant Code (Figure 20). Sous HTTPS, cliquez sur le bouton Copier. L'URL est maintenant copiée.

copier l'url du dépôt
Figure 20 - Copier l'URL du dépôt

Créer un dossier pour le dépôt

Maintenant, vous devez créer un dossier pour placer le dépôt. Faites un clic droit dans n'importe quel répertoire, puis cliquez sur créer un nouveau dossier. Nommez-le Ozeki et ouvrez-le (Figure 21).

créer un dossier pour le dépôt
Figure 21 - Créer un dossier pour le dépôt

Sélectionner l'option Git clone

Pour commencer le clonage, vous devez d'abord ouvrir Git. Faites un clic droit dans le dossier nouvellement créé et cliquez sur Git Clone... (Figure 22). Cela ouvrira la fonction de clonage Git dans Tortoise Git.

sélectionner l'option git clone
Figure 22 - Sélectionner l'option Git clone

Configurer l'URL

Collez l'URL que vous avez précédemment copiée à côté de URL : (Figure 23). Cliquez sur OK pour commencer le clonage. Cela téléchargera tous les contenus du dépôt dans votre répertoire choisi.

configurer l'url
Figure 23 - Configurer l'URL

Clonage réussi

Une fois le processus de clonage terminé, Tortoise Git vous en informera. Un message bleu apparaîtra indiquant Succès (Figure 24). Vous pouvez maintenant fermer le programme et commencer à coder.

clonage réussi
Figure 24 - Clonage réussi

Dépôt cloné

Vous pouvez voir qu'après que le clonage a été terminé avec succès, le dépôt apparaîtra dans votre dossier choisi (Figure 25).

dépôt cloné
Figure 25 - Dépôt cloné

4. vidéo : Valider des modifications avec Git

Cette vidéo explique comment vous pouvez valider des modifications dans des morceaux de code en utilisant Git. Vous pouvez accéder à la fonction de validation depuis votre explorateur (Vidéo 4). Ce processus est effectué via TortoiseGit. Tortoise Git vous permet de valider des modifications dans les codes et d'attacher des journaux de modifications aux validations. Ces modifications apparaîtront sur GitHub une fois qu'elles auront été validées.

Vidéo 4 - Comment valider des modifications dans des morceaux de code en utilisant Git (Tutoriel vidéo)

Sauvegarder les modifications

Testez la fonction de validation sur Git en modifiant le fichier PHP Send_Message. Ouvrez d'abord le fichier dans Notepad. Ajoutez un commentaire à la fin, puis sauvegardez le fichier (Figure 26). Vous pouvez maintenant fermer Notepad.

sauvegarder les modifications
Figure 26 - Sauvegarder les modifications

Sélectionner l'option Git commit

Faites à nouveau un clic droit dans le répertoire, puis cliquez sur Git Commit -> main (Figure 27). Cela ouvrira à nouveau Tortoise Git, où vous pourrez configurer votre validation.

sélectionner l'option git commit
Figure 27 - Sélectionner l'option Git commit

Valider et pousser

Dans Tortoise Git, vous pouvez également attacher un journal de modifications à votre validation (Figure 28). Tapez votre texte de journal de modifications dans la zone de texte ci-dessus. Cliquez sur Commit & Push pour valider vos modifications.

valider et pousser
Figure 28 - Valider et pousser

Se connecter à Git

Après avoir cliqué sur Commit & Push, il vous sera demandé de vous connecter à GitHub. Une nouvelle fenêtre s'ouvrira, où vous devrez entrer votre e-mail et mot de passe pour votre compte GitHub (Figure 29). Cliquez sur Login pour vous connecter à GitHub.

se connecter à git
Figure 29 - Se connecter à Git

Validation réussie

Lorsque votre validation est terminée, un message indiquera qu'elle a été réussie. Très similaire au clonage, un message bleu indiquera Succès (Figure 30). Vous pouvez maintenant ouvrir GitHub dans votre navigateur et voir les modifications que vous avez apportées.

validation réussie
Figure 30 - Validation réussie

Modifications dans le dépôt

Visitez le dépôt sur le site web de

More information