NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #752 most downloaded on Packagist
The Microsoft Graph SDK for PHP
Latest stable
v3.10.0
Last release 9 days ago
09 Nov 2026
Release timing varies
gaps range from 2 weeks to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
218 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1517
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.7.0...2.8.0
Main by @SilasKenneth in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1512
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.6.0...2.7.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1510
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.5.0...2.6.0
Merge pull request #1494 from microsoftgraph/dev by @SilasKenneth in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1495
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.4.0...2.5.0
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1492
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.3.0...2.4.0
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1454
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.2.0...2.3.0
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1425
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.1.0...2.2.0
Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1402
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.1...2.1.0
- bumps patch version by @baywet in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1416
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0...2.0.1
Release 2.0.0 🚀 by @SilasKenneth in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1401
Please see the Upgrade Guide for more.
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.109.0...2.0.0
PATCH requests now return the deserialized response body.
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC8...2.0.0-RC9
Generated models and request builders using Kiota by @github-actions in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1001
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC7...2.0.0-RC8
Generated models and request builders using Kiota by @github-actions in https://github.com/microsoftgraph/msgraph-sdk-php/pull/995
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC6...2.0.0-RC7
For $ref requests that accept a request body, the Ref model is deprecated in favor of ReferenceCreate
$ref requests that accept a request body, the Ref model is deprecated in favor of ReferenceCreatesetodatatype & getodatatype to setOdataType & getOdataType respectively&getOdatanextLinktosetOdataNextLink &getOdataNextLink` respectivelyFull Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC5...2.0.0-RC6
This release contains model bug fixes and the following improvements:
This release contains model bug fixes and the following improvements:
use Microsoft\Kiota\Authentication\Oauth\AuthorizationCodeContext;
use Microsoft\Kiota\Authentication\PhpLeagueAuthenticationProvider;
$tokenRequestContext = new AuthorizationCodeContext(
'tenantId',
'clientId',
'clientSecret',
'authCode',
'redirectUri'
);
$scopes = ['User.Read', 'Mail.Read'];
$authProvider = new PhpLeagueAuthenticationProvider($tokenRequestContext, $scopes);
$messages = $graphServiceClient->usersById(USER_ID)->messages()->get()->wait();
More details in the Upgrade Guide and README
For more info on the breaking change, please see the upgrade guide
For more info on the breaking change, please see the upgrade guide
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC3...2.0.0-RC4
Ediscovery models for v1 have been removed. They were accidentally added to v1 early. Removing them is not considered a breaking change since the APIs…
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC2...2.0.0-RC3
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1360
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC26...2.0.0-RC27
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1356
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC25...2.0.0-RC26
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1345
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC24...2.0.0-RC25
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1338
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC23...2.0.0-RC24
adding note by @isvargasmsft in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1312
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC22...2.0.0-RC23
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1321
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC21...2.0.0-RC22
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1315
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC20...2.0.0-RC21
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1311
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC19...2.0.0-RC20
Support phpstan 1.0 & configure dependabot to update feat/2.0.0 branch by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/689
phpstan 1.0 & configure dependabot to update feat/2.0.0 branch by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/689Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC1...2.0.0-RC2
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1306
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC18...2.0.0-RC19
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1292
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC17...2.0.0-RC18
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1277
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC16...2.0.0-RC17
Add National Cloud customization sample by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1261
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC15...2.0.0-RC16
Simplified GraphServiceClient instantiation experience ```php // Default client using the global endpoint (https://graph.microsoft.com) and default sc
GraphServiceClient instantiation experience// Default client using the global endpoint (https://graph.microsoft.com) and default scopes
$graphServiceClient = new GraphServiceClient($tokenRequestContext);
// With custom scopes and custom National Cloud endpoint
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes, NationalCloud::CHINA);
// With a custom request adapter
$graphServiceClient = GraphServiceClient::createWithRequestAdapter($requestAdapter);
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC14...2.0.0-RC15
Fluent request builder pattern has changed where you'll need to access the resource first then filter it e.g. `php // previously $message = $graphServ
// previously
$message = $graphServiceClient->usersById('userId')->messagesById('messageId')->get()->wait();
// now
$message = $graphServiceClient->users()->byUserId('userId')->messages()->byMessageId('messageId')->get()->wait();
ResponseHandlerOptionBatchRequestBuilder has now changed namespaces from Microsoft\Graph\Core\Requests\BatchRequestBuilder to Microsoft\Graph\Beta\BatchRequestBuilder to allow deserialization of errors during batch requests. See how to make batch requests using the SDK.ApiException thrown during failed requests no longer contains the raw HTTP/PSR response. Only the response status code and headers are available.LargeFileUpload task which automatically uploads files larger than 3MB in chunks using an upload session.GraphPhpLeagueAuthenticationProvider which by default requests https://graph.microsoft.com/.default scopes. This decouples the Kiota PhpLeagueAuthenticationProvider from Graph-specific defaults.PageIterator task which enables you to page through a collection while applying a callback that is executed against each item in the collection.PATCH requests for /content endpoints now return the expected object. Previously the request succeeded but response body would not be deserialized.BatchRequest task have been fixed.Request builder methods returning the request information object have been renamed i.e. create[Get|Post|Patch|Put|Delete]RequestInformation() => to[Ge
create[Get|Post|Patch|Put|Delete]RequestInformation() => to[Get|Post|Patch|Put|Delete]RequestInformation()Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC12...2.0.0-RC13
Bump graph core version by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1058
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC11...2.0.0-RC12
Generated models and request builders using Kiota by @github-actions in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1051
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC10...2.0.0-RC11
Generated models and request builders using Kiota by @github-actions in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1020
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/2.0.0-RC9...2.0.0-RC10
This SDK contains new features, bug fixes and breaking changes from v1 of the Microsoft Graph SDK.
This SDK contains Microsoft Graph v1 API models and a client to make requests to the Microsoft Graph v1 API.
Previously, Beta models were provided in he Microsoft Graph SDK. They have now been moved to Microsoft Graph Beta SDK
This SDK contains new features, bug fixes and breaking changes from v1 of the Microsoft Graph SDK.
Please see our Upgrade Guide for more details.
We'd really appreciate your feedback! Feel free to create GitHub issues on this repo and contribute off the feat/2.0.0 branch.
Release 1.110.0: Bump min guzzle versions to secure versions by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1446
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.109.2...1.110.0
Merge php info hotfix to long term support branch by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1418
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.109.1...1.109.2
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.109.0...1.109.1
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.109.0...1.109.1
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1364
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.108.0...1.109.0
Generated models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1354
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.107.0...1.108.0
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1344
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.106.0...1.107.0
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1329
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.105.0...1.106.0
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1320
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.104.0...1.105.0
Merge pull request #1296 from microsoftgraph/dev by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1301
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.103.0...1.104.0
Merge pull request #1286 from microsoftgraph/dev by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1287
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.102.0...1.103.0
Merge pull request #1278 from microsoftgraph/dev by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1280
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.101.0...1.102.0
Main by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1271
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.100.0...1.101.0
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1266
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.99.0...1.100.0
Replace deprecated unwrap method in promises namespace by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1248
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.98.0...1.99.0
Merge pull request #1230 from microsoftgraph/dev by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1231
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.97.0...1.98.0
Main by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1223
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.96.0...1.97.0
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1220
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.95.0...1.96.0
Merge pull request #1201 from microsoftgraph/dev by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1202
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.94.0...1.95.0
Main by @SilasKenneth in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1195
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.93.0...1.94.0
Generated beta models and request builders by @andrueastman in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1188
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.92.0...1.93.0
Merge pull request #1178 from microsoftgraph/dev by @SilasKenneth in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1179
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.91.0...1.92.0
Main by @SilasKenneth in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1174
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.90.0...1.91.0
Bump SDK version in generated code PRs by @Ndiritu in https://github.com/microsoftgraph/msgraph-sdk-php/pull/1160
Full Changelog: https://github.com/microsoftgraph/msgraph-sdk-php/compare/1.89.0...1.90.0
One column per quarter.