Si vous êtes administrateur d’un serveur, vous avez alors très bien compris que son intégration dans son site web est primordiale : livemap, liste des joueurs connectés, système de donations… Que diriez-vous de pousser encore plus loin ce concept ?

Présentation

PHPsend est un plugin pour serveurs Bukkit développé par kittyPL. Couplé à une API PHP, il vous permettra en seulement quatre lignes de code d’envoyer des commandes à votre serveur, de manière totalement sécurisée. Simple, mais efficace !

Attention : ce plugin ne s’adresse pas à n’importe-qui. En effet, étant principalement utile pour le développement de sites web, des connaissances accrues dans le langage PHP sont nécessaires à son utilisation. Envoyez-donc un lien vers cet article à votre webmaster !

Installation

Premièrement, téléchargez la dernière version du plugin et de son API. Une fois l’archive extraite, vous devriez obtenir deux fichiers : PHPsend.jar, le plugin, et PHPsend.php, l’API.

Installez le plugin comme vous le feriez d’habitude, en prenant bien soin d’aller faire un tour dans sa configuration ;

  • port – le port utilisé par le plugin (n’oubliez pas de l’ouvrir !)
  • password – le mot de passe utilisé pour l’authentification (vous pouvez le modifier)

Une fois cela fait, placez le fichier PHPsend.php où vous voulez dans votre site web. L’installation est terminée !

Utilisation

Voici comment créer un script permettant d’envoyer une commande à votre serveur. L’API ne contient que quatre méthodes, ce n’est donc pas très compliqué.

Premièrement, vous devez inclure l’API dans votre script (pensez à remplacer le texte entre crochet par l’emplacement du fichier PHPsend.php)  :

include_once("<chemin vers l'API sur votre site web>");

Ensuite, vous devez établir une connexion vers votre serveur. Voici comment procéder :

$connec = new PHPsend();
$result = $connec->PHPconnect("<adresse du serveur>","<mot de passe PHPsend>","<port PHPsend>");

A ce stade là, la variable $result peut prendre les valeurs suivantes :

  • 0 – aucune erreur, la connexion est établie
  • 1 – PHPsend n’a pas pu se connecter au serveur
  • 2 – le mot de passe est incorrect

Vous êtes maintenant prêt à envoyer une commande au serveur. Pour cela, rien de plus simple :

$connect->PHPcommand("<commande sans />");

Faites bien attention à ne pas mettre de slash (/) dans la commande ! Si tout s’est bien passé, PHPcommand renverra 0 sinon 1 si il y a eu une erreur (attention : ça n’inclut pas l’erreur « commande introuvable »).

Une fois toutes vos commandes envoyées, vous devez vous déconnecter du serveur :

$result = $connec->PHPdisconnect();

La variable $result peut alors être de deux valeurs :

  • 0 si la déconnexion a bien réussie
  • 1 si il y a eu une erreur lors de la déconnexion

Voilà, vous êtes fin prêts à créer de beaux sites web ! Si vous voulez perfectionner le plugin, vous pouvez en créer des améliorations ; tout ce que vous devez savoir se trouve ici et ici.