Utilisation des fonctions (SOAP) de gestion des emails en PHP

Cet article est le premier d'une série qui sera destinée à vous aider à exploiter l'ensemble des fonctions mises à disposition par OVH.

Cette mise à disposition correspond à la mise en oeuvre d'une API par le biais d'un serveur communiquant en SOAP, cette API ouvrant toutes

les fonctionnalités majeures pour l'exploitation des hébérgements OVH.

Résumé:

Nous nous proposons au cours de ce document de recréer une interface de gestion des emails similaire au manager v2 d'ovh.com.

Cette interface sera ecrite en PHP puisque c'est l'un des languages de programmation les plus utilisés, cet exemple touchera un plus grand public

Le cahier des charges

L'interface doit permettre pour un domaine de:

-Consulter la liste des adresses installées

-Consulter la liste des alias et des redirections

-Consulter la liste des répondeurs

Elle doit également permettre de créer, modifier ou effacer chacun de ces elements.

On utilise une librairie en PHP écrite par Nicolas Merlet qui profite du caractere standards des appels de fonctions pour factoriser la vérification des erreurs:

http://www.merletn.org/lab/api.zip

Pour utiliser cette librairie, installer le module pear SOAP (pear install soap)

telecharger l'exemple: http://guides.ovh.com/v3/exemple.zip

ou en tar.gz: http://guides.ovh.com/v3/exemple.tar.gz

Les pages de base

La connexion

"A la main"



<?php

require('SOAP/Client.php');

$soap_client=new SOAP_Client('http://ovh.com:1663');

$options=array('namespace'=>'urn:xxxx','trace'=>1,'timeout'=>10);



//Pour se connecter :

$tab=array("nic" => "AAYYY-OVH", "password" => "XXXXXXX");

$params=array(&$tab);

$retour=$soap_client->call("Login",$params,$options);



// pour recuperer le contenu de $retour->{value}

// ici il s'agit du num ro de session OVH

$tmp=get_object_vars($retour);

$ID_OVH_SESSION=$tmp"value";

?>

Avec l'api qui factorise les appels



// On ouvre la connexion vers les serveur RPC d'OVH

    $result = ovh ( "Login" , array ( "nic" => $login , "password" => $pass ) );

Liste des comptes et actions

"A la main"



// pour appeler un fct qui veut ID_OVH_SESSION

$tab=array("pop" => $_POST'popname', "domain"=>$_POST'domaine',"desc" => $_POST'desc');

$params=array($id_session,&$tab);

$ret=$soap_client->call("PopModifyAccount",$params,$options);

$ret=get_object_vars($ret);

Avec l'api qui factorise les appels



//on recupére les infos concernant la liste des pops du domaine donne en paramètres

$result = ovh ("PopListAccounts", $_SESSION'id_ovh_session', array( "domain" => $domain ) );// or die ( "Erreur lors de la recupération des pops" );

Retour