Je vais vous présenter ici comment interfacer PHP avec Exchange.
Introduction
Exchange est un incontournable dans le milieu de l’entreprise. Malheureusement, c’est du M$, donc fermé et réservé au C#.
Jusqu’à maintenant, et si vous êtes arrivé là, vous devez déjà le savoir, on pouvait utiliser WebDav.
Or, M$ a annoncé la fin de WebDav sur Exchange 2010, au profit de EWS (Exchange Web Services), un système de services Web en Soap. La première approche n’est pas évidente. J’ai donc décidé d’en faire un tuto ici.
Prérequis
- Un serveur Exchange 2007 SP1 ou 2010
- Un serveur avec PHP5.2 avec cUrl et Soap (logiquement installés par défaut) en ligne de commande de préférence.
PHP-EWS
Un gars bien a réunis ses idées avec celles d’autres pour créer une librairie cohérente. Malheureusement, ce gars bien n’est pas doué pour la doc… http://code.google.com/p/php-ews/
Il faudra prendre la version sur le SVN (sous windows vous pouvez utiliser « Tortoise »)
Considérons donc que vous avez un répertoire de travail EWS, placez y php-ews dedans. J’ai appelé le répertoire contenant php-ews tout simplement « php-ews » (je sais, trop original…)
Let’s go !
Des problèmes, y en aura !
Ça c’est sûr, ça ne marchera pas du 1er coup… Donc on va installer quelques bouts de codes pour nous aider !
Affichage des erreur de cUrl
Dans le fichier NTLMSoapClient.php, vers la ligne 71, à la fin de la définition des options de cUrl, ajoutez
1
2
3
4
5
| curl_setopt($ch, CURLOPT_FAILONERROR,true);
if( ($response = curl_exec($ch)) === false) {
echo 'Erreur Curl : ' . curl_error($ch).""; die();
} |
(commentez le $response = curl_exec($ch) déjà présent bien sûr)
Ce qui nous permettra de voir les erreurs HTTP du style Error 404 (même si ça sera probablement des error 401 qui faudra gérer) Évidemment, il faudra virer ça lorsque tout fonctionnera..
NTLM … ou pas
Suivant la configuration de votre serveur (que je n’expliquerais pas, j’y connais rien…) l’authentification peut se faire par NTLM, ou pas. Créez un fichier index.php et mettez y ceci
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
| require_once 'php-ews/EWS_Exception.php';
require_once 'php-ews/ExchangeWebServices.php';
require_once 'php-ews/NTLMSoapClient.php';
require_once 'php-ews/NTLMStream.php';
require_once 'php-ews/NTLMStream/Exchange.php';
require_once 'php-ews/NTLMSoapClient/Exchange.php';
// A modifier évidemment
$server = 'serveur-exchange.com';
$username = 'guillaume';
$password = 'passpass';
$client = new ExchangeWebServices($server, $username, $password);
$client->CreateItem(null); |
Exécutez, et si vous obtenez
1
| Erreur Curl : The requested URL returned error: 401 |
C’est que le serveur n’utilise pas NTLM, il faudra donc commenter la ligne
1
| curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_NTLM); |
dans NTLMSoapClient.php
Réessayez, et vous devez obtenir une erreur 500 (normal, on a envoyé une requête nulle), mais au moins, l’authentification passe.
On envoi notre 1er mail
Nous allons donc envoyer un 1er mail. Pour cela nous utilisons la doc sur MSDN.
On peut voir dessus la forme de l’XML qui doit être envoyé. Soap se chargeant de transformer nos objets en XML, il nous faut donc fabriquer un objet constitué des informations attendues par le serveur. Avant de commencer, je vais montrer ce qu’on veut, c’est-à-dire le XML avec mes infos, et l’objet qu’on doit créer pour l’obtenir. La comparaison permet de mieux comprendre comment fabriquer son objet.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
| <SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:ns2="http://schemas.microsoft.com/exchange/services/2006/messages">
<SOAP-ENV:Body>
<ns2:CreateItem MessageDisposition="SendAndSaveCopy">
<ns2:SavedItemFolderId>
<ns1:DistinguishedFolderId Id="sentitems"/>
</ns2:SavedItemFolderId>
<ns2:Items>
<ns1:Message>
<ns1:ItemClass>IPM.Note</ns1:ItemClass>
<ns1:Subject>Test envoi de mail</ns1:Subject>
<ns1:Body BodyType="HTML">
Voici le 1er mail envoyé par du code pur et dur ! Ca bazoote ! C'est envoyé par le serveur exchange, et bien visible dans les mails envoyés.
</ns1:Body>
<ns1:ToRecipients>
<ns1:Mailbox>
<ns1:EmailAddress>destinaire@server.fr</ns1:EmailAddress>
</ns1:Mailbox>
</ns1:ToRecipients>
</ns1:Message>
</ns2:Items>
</ns2:CreateItem>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
Et l’objet Soap correspondant
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
| stdClass Object (
[MessageDisposition] => SendAndSaveCopy
[SavedItemFolderId] => stdClass Object (
[DistinguishedFolderId] => stdClass Object (
[Id] => sentitems
)
)
[Items] => stdClass Object (
[Message] => Array (
[0] => stdClass Object (
[ItemClass] => IPM.Note
[Subject] => Test subject sans stream
[Body] => stdClass Object (
[BodyType] => HTML
[_] => Voici le 1er mail envoyé par du code pur et dur ! Ca bazoote ! C est envoyé par le serveur exchange, et bien visible dans les <em>mails envoyés</em>
)
[ToRecipients] => stdClass Object (
[Mailbox] => Array (
[0] => stdClass Object (
[EmailAddress] => destinaire@server.fr
)
)
)
)
)
)
) |
Let’s go !
Pour cela, je vais faire une fonction à part, auquel on paasera d’une part le client SOAP, et d’autre part les infos liées au mail.
function sendMail($client, $params) {
$createItem->MessageDisposition = 'SendAndSaveCopy';
$createItem->SavedItemFolderId->DistinguishedFolderId->Id = 'sentitems';
$message->ItemClass = 'IPM.Note';
if (empty($params['Subject'])) {
$message->SubJect = 'No subject';
} else {
$message->Subject = $params['Subject'];
}
if (empty($params['BodyType'])) {
$message->Body->BodyType = 'Text';
} else {
$message->Body->BodyType = $params['BodyType'];
}
if (empty($params['Body'])) {
return false;
}
$message->Body->_ = $params['Body'];
foreach ($params['Recipients'] as $mail) {
$message->ToRecipients->Mailbox[]->EmailAddress = $mail;
}
$createItem->Items->Message[] = $message;
try {
// Send the request to create and send the e-mail item, and get the response.
$createItemResponse = $client->CreateItem($createItem);
// Determine whether the request was a success.
if ($createItemResponse->ResponseMessages->CreateItemResponseMessage->ResponseClass == 'Error') {
throw new Exception($createItemResponse->ResponseMessages->CreateItemResponseMessage->MessageText);
} else {
echo "Item was created";
}
} catch(Exception $e) {
echo $e->getMessage();
}
} |
Il ne nous reste plus qu’à reprendre notre code du début, mais au lieu d’envoyer un Item null, on appelle notre fonction
require_once 'php-ews/EWS_Exception.php';
require_once 'php-ews/ExchangeWebServices.php';
require_once 'php-ews/NTLMSoapClient.php';
require_once 'php-ews/NTLMStream.php';
require_once 'php-ews/NTLMStream/Exchange.php';require_once 'php-ews/NTLMSoapClient/Exchange.php';
// A modifier évidemment
$server = 'serveur-exchange.com';
$username = 'guillaume';
$password = 'passpass';
$client = new ExchangeWebServices($server, $username, $password);
sendMail($client, array(
'Subject' => 'Test subject sans stream',
'BodyType' => 'HTML',
'Body' => 'Voici le 1er mail envoyé par du code pur et dur ! Ca bazoote ! C\'est envoyé par le serveur exchange, et bien visible dans les <em>mails envoyés</em>'."\n",
'Recipients' => array(
'destinaire@server.fr'
)
)); |
Et voila, logiquement vous devriez avoir un victorieux « Item was created » \o/
Si ce n’est pas le cas, vous pouvez afficher votre objet ($createItem dans la fonction sendMail), ainsi que l’XML de sortie ($resquest dans __doRequest du fichier NTLMSoapClient), et enfin pour voir mieux l’erreur, le résultat $createItemResponse dans la fonction sendMail
Bon courage, et vive M$ (.. ou pas)
]]>
Aujourd’hui j’ai décidé de partager avec vous mon dernier bébé. Un ORM du nom de Lithium que je développe et que j’utilise depuis 1ans environ.
