Changelog

New Features

• Planner API: Enhanced support for Microsoft Graph Planner API

Fixes & Improvements

• PR #352: Fix OneDrive file upload session retry logic (by @it-can)
• PR #350: Improve error handling for SharePoint API requests (by @VincentFoulon80)
• PR #348: Fix metadata handling in file uploads (by @JensDeMuynck)
• PR #129: Fix OneDrive large file upload session

Added

• Planner API: Enhanced support for Microsoft Graph Planner API

Fixed

• #352: Fix OneDrive file upload session retry logic (by @it-can)
• #350: Improve error handling for SharePoint API requests (by @VincentFoulon80)
• PR #348: Fix metadata handling in file uploads (by @JensDeMuynck)
• PR #129: Fix OneDrive large file upload session

Added

• GraphServiceClient::withUserCredentials and GraphServiceClient::withClientSecret methods introduced

Fixed

• #337: Don't try to retrieve next set of items when using an iterator, if no next items are expected to exist

Added

• GraphServiceClient::withUserCredentials and GraphServiceClient::withClientSecret methods introduced

Fixed

• #337: Don't try to retrieve next set of items when using an iterator, if no next items are expected to exist

Changelog

• SharePoint model updated to 16.0.24106.12014 version
• import fixes (patches for 3.1.0 version)

Changelog

• support for authenticate SharePoint API via client certificate flow
• validate access token response in GraphServiceClient

Example: how to authenticate SharePoint API via client certificate flow

$siteUrl = "https://contoso.sharepoint.com";  //site or web absolute url 
$tenant = "contoso.onmicrosoft.com"; //tenant id or name
$thumbprint = "--thumbprint goes here--";
$clientId = "--client app id goes here--";
$privateKetPath = "-- path to private.key file--"
$privateKey = file_get_contents($privateKetPath);

$ctx = (new ClientContext($siteUrl))->withClientCertificate(
    $tenant, $clientId, $privateKey, $thumbprint);

$whoami = $ctx->getWeb()->getCurrentUser()->get()->executeQuery();
print $whoami->getLoginName();

Changelog

• support for document sets in SharePoint API
• fix addering issue with web resource

Example: create a Document Set

$credentials = new ClientCredential($clientId, $clientSecret);
$client = (new ClientContext($siteUrl))->withCredentials($credentials);

$docSetName = "Orders"; 
$lib = $client->getWeb()->defaultDocumentLibrary();
$docSet = DocumentSet::create($client, $lib->getRootFolder(), $docSetName)->executeQuery();
print($docSet->getProperty("ServerRelativeUrl"));

Added

• SharePoint document set support

Fixed

• Fix SharePoint upload with small files (#328)
• SharePoint web resource URL computation

Changelog

• #325 PR: fix composer autoload issue by @menegain-mathieu

Fixed

• Autoloading for SharePoint/Publishing/ classes
• Fix OneDrive createFolder()

Changelog

• #300: add CcRecipients property to Message class by @DavidBrogli
• #304: Http Response improvements by @lbuchs
• #307 add example to obtain available fields of a list by @cweiske
• #318 Support for custom curl options by @drml
• ClientObjectCollection class enhancements, introduced getAll method by @vgrem

Example: read list items in a large list via getAll method:

$ctx = (new ClientContext($siteUrl))->withCredentials($credentials);
$list = $ctx->getWeb()->getLists()->getByTitle("--large list title--");

$allItems = $list->getItems()->getAll(5000, function ($returnType){
    print("{$returnType->getPageInfo()} items loaded...\n");
})->executeQuery();

Breaking

• ClientObjectCollection::get() only returns a limited set of data. Use getAll() now instead.

Added

• Update SharePoint models to version 16.0.22921.12007
• Update SharePoint models to version 16.0.23207.12005
• Add CC recipients in outlook messages (#300)
• New functions in Http\Response (#304)
• SharePoint/Field::enableIndex() method
• SharePoint/ClientContext::getGroupSiteManager(), ::getPeopleManager(), ::getSiteManager(), ::getSearch() and getTaxonomy()
• SharePoint/Search/SearchService::export()
• Example for obtaining fields of a list (#307)
• Example to list all lists (#316)
• Examples to read large lists, update list items and create indexes

Fixed

• Sending mails with attachments (#301)
• Option merging in Http\Requests::setDefaultOptions (#319)

Removed

• Http\Requests::execute() $headers parameter (#304)
• state from ClientRequest

Changelog

• #283: exception handling enhancements for authentication requests by @SuperDJ
• #286: introduced client secret support for acquireTokenForPassword method in AADTokenProvider class by @R-TECH
• #287 and #288: captures and validates if response failed by @fr3nch13
• #297: remove minimum-stability from composer.json by @cweiske
• #298 and #299: deprecation fixes for PHP 8 and drop PHP 5.5 requirement by @cweiske

Breaking

• Support for PHP version < 7.1.0

Added

• Support for confidential clients (#286)
• Throw exception on outdated client credentials (#283)

Fixed

• Fix deprecations on PHP 8 (#298)
• Validate each individual server response (#287)
• Do not throw exception on all 4xx responses (#288)

Changelog

• SharePoint API File and Folder addressing enhancements, namely supporting % and # in files and folders with the ResourcePath API
• #284: example bug fixed for addressing a file by @la-costa
• #282: improved authorization error handling by @SuperDJ

Changelog

• SharePoint API: improved support for composite field values namely FieldLookupValue/FieldMultiLookupValue, FieldMultiChoiceValue , refer example 1 below ( related issues: #261)
• OData request/response serialization optimizations (namely excluding metadata annotations from response by default)

Example : create list item and specify multi lookup & choice fields values:

$list = $ctx->getWeb()->getLists()->getByTitle("Tasks");

$taskProps = array(
    'Title' => "New task",
    'ParentTask' => new FieldLookupValue($taskLookupId),
    'PrimaryManager' => new FieldUserValue($userId),
    'Managers' => new FieldMultiLookupValue([$userId]),
    'TaskCategories' => new FieldMultiChoiceValue(["Event", "Reminder"])
);
$item = $list->addItem($taskProps)->executeQuery();