nowise/uup-ews

Microsoft Exchange Web Service (EWS) Library

0.9.2 2019-10-15 02:22 UTC

This package is auto-updated.

Last update: 2024-04-15 13:21:03 UTC


README

SOAP client library for communication with the EWS. Most code is auto-generated from the WSDL/XSD downloaded from the Excahnge server.

This project is not really maintained (missing usecase) and has only been tested agains Exchange 2013, but made available in hope of being useful for someone!

Notice:

The WSDL and XSD-files bundled in config directory might need to be replaced to match the exchange server running in your organization. When updating WSDL, remember to also re-generate the PHP classes in source/UUP/Exchange/Types

Update WSDL/XSD files:

Download service, message and types definitions from the exchange server by running:

for f in services.wsdl messages.xsd types.xsd; do \
  curl -v --ntlm --user user@example.com \
      https://server.example.com/ews/$f > config/$f
done

Append service definition at end of config/services.wsdl. Replace server.example.com with the actual exchange server to provide default host:

<wsdl:service name="ExchangeServices">
  <wsdl:port name="ExchangeServicePort" binding="tns:ExchangeServiceBinding">
    <soap:address location="https://server.example.com/ews/exchange.asmx" />
  </wsdl:port>
</wsdl:service> 

Update PHP classes:

  1. Use the bundled script to generate PHP classes from WSDL. Requires suggested composer package wsdl2phpgenerator to be installed first:
composer require wsdl2phpgenerator/wsdl2phpgenerator
php bin/generate.php
  1. Download the CLI version of wsdl2phpgenerator, then generate the PHP classes from the WSDL file in the config directory:
php ~/wsdl2phpgenerator.phar -i config/services.wsdl \
    -o source/UUP/Exchange/Types -n "UUP\\Exchange\\Types" \
    --noIncludes --constructorNull --createAccessors

See documentation of wsdl2phpgenerator for more information:

Test:

A simple PHP script for testing connection and basic CRUD operations for calendar events can be found in the bin directory:

php bin/client.php --user=user@example.com --pass=secret \
                   --host=exchange.example.com \
                   --find --start="2015-11-25" --end="2015-12-01"
php bin/client.php --user=user@example.com --pass=secret \
                   --host=exchange.example.com \
                   --add --start="2015-11-25" --end="2015-12-01" \
                   --title="TEST" --body="Some text..."
php bin/client.php --user=user@example.com --pass=secret \
                   --host=exchange.example.com \
                   --delete --id="AABCurZhAAA="

Reference:

How to: Create appointments and meetings by using EWS in Exchange 2013