PHP wrapper for easy implementation of Microsoft Graph services
Version >=1.2 requires PHP >=8.1
composer require andrewsauder/microsoft-services
$config = new \andrewsauder\microsoftServices\config();
$config->clientId = '{Azure Application ID}';
$config->clientSecret = '{Azure Client Secret}'; //certificates not yet supported
$config->tenant = 'example.com';
$config->driveId = ''; //required if using the files service - cay be found using Graph explorer
$config->fromAddress = 'noreply@example.com'; //required if using mail service - this is just a default$microsoftFiles = new \andrewsauder\microsoftServices\files( $config );
$files = $microsoftFiles->list();//example subdirectory: {root}/2021-0001/Building 1/Inspections
$microsoftFiles = new \andrewsauder\microsoftServices\files( $config );
$files = $microsoftFiles->list( [ '2021-0001', 'Building 1', 'Inspections' ] );$microsoftFiles = new \andrewsauder\microsoftServices\files( $config );
$uploadFileResponse = $microsoftFiles->upload( 'C:\tmp\testFile.txt', 'testFile.txt' );//example subdirectory: {root}/2021-0001/Building 1/Inspections
$microsoftFiles = new \andrewsauder\microsoftServices\files( $config );
$uploadFileResponse = $microsoftFiles->upload( 'C:\tmp\testFile.txt', 'testFile.txt', [ '2021-0001', 'Building 1', 'Inspections' ] );$microsoftFiles = new \andrewsauder\microsoftServices\files( $config );
$deleteResponse = $microsoftFiles->delete( $itemId );If no user token is provided, the application token will be used.
If the application token is being used, verify that the Azure application has correct Mail.X permissions for the email address being used. To limit application access to only certain mailboxes, use ExchangeOnline Powershell to apply access policy. More info https://learn.microsoft.com/en-us/powershell/module/exchange/new-applicationaccesspolicy?view=exchange-ps
If a user access token is provided when creating the service (mail($config, 'user-access-token-string')), verify that
the user has 'send on behalf' of or 'send as' permissions configured properly in Office 365.
If the from address is not provided, the default from address in the config will be used.
$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$microsoftMail->addAttachment( 'C:\tmp\testFile.txt' );
$rsp = $microsoftMail->send( 'to@example.com', 'Subject', 'HTML compatible message', 'from@example.com' );
if( $rsp->getStatus() < 200 || $rsp->getStatus() >= 300 ) {
error_log( 'Failed' );
}Continue an existing conversation instead of starting a new one. replyIntoThread() creates a reply
draft anchored on a message you previously sent (so it inherits that conversation and its RE: subject),
sets the recipients and body you provide, and sends it. Store the returned message's immutable id as the
anchor for the next reply, and its conversation id for inbound matching.
Provide the from mailbox, the immutable id of the last message you sent in the thread, and the
recipients/body. Do not set a subject - the reply inherits it.
$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$sent = $microsoftMail->replyIntoThread(
'helpdesk@example.com', // from (owns the anchor message)
$lastMessageId, // immutable id of the last message sent in the thread
[ 'to@example.com' ], // to
[], // bcc
'HTML compatible message',
[ 'cc@example.com' ] // cc (optional)
);
$nextAnchor = $sent->getId(); // store as the next thread anchor
$conversationId = $sent->getConversationId(); // store for inbound reply matchingIf the anchor message no longer exists (deleted), replyIntoThread() throws a serviceException - catch
it and fall back to createDraft() / sendDraft() to start a fresh thread.
Only the immutable id is needed to reply. If you have lost it but still know the conversation id, recover an anchor with:
$latest = $microsoftMail->getLatestMessageInConversation( 'helpdesk@example.com', $conversationId );
$anchorId = $latest?->getId();You can also create just the draft (without sending) with createReplyDraft( $messageId, $from ).
$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$messages = $microsoftMail->getAllMessages( 'joeschmoe@example.com' );$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$messages = $microsoftMail->getMessagesInFolder( 'joeschmoe@example.com', 'mail-folder-id' );$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$folders = $microsoftMail->getFolders( 'joeschmoe@example.com' );$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$attachments = $microsoftMail->getAttachments( 'joeschmoe@example.com', 'message-id' );$microsoftMail = new \andrewsauder\microsoftServices\mail( $config );
$graphResponse = $microsoftMail->deleteMessage( 'joeschmoe@example.com', 'message-id' );$microsoftUserService = new \andrewsauder\microsoftServices\user( $config );
$users = $microsoftUserService->allUsersInOrganization();$microsoftUserService = new \andrewsauder\microsoftServices\user( $config );
$users = $microsoftUserService->getUserByUserPrincipalName( 'andrew@sauder.software' );$microsoftUserService = new \andrewsauder\microsoftServices\user( $config );
$users = $microsoftUserService->getUserById( '15bd6895-bf60-4125-a1d2-affb7e0de5d8' );See https://learn.microsoft.com/en-us/graph/filter-query-parameter?tabs=http for filter details
$microsoftUserService = new \andrewsauder\microsoftServices\user( $config );
$users = $microsoftUserService->getUsersByFilter( 'startswith(userPrincipalName,"andrew")' );