PHP Extension

SharePoint -- Update the Contents of a File (PUT)

Demonstrates how to update the contents of a SharePoint file. PHP Extension

<?php

include("chilkat.php");

$success = false;

// This requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

$http = new CkHttp();

// If SharePoint Windows classic authentication is used, then set the 
// Login, Password, LoginDomain, and NtlmAuth properties.
$http->put_Login('SHAREPOINT_USERNAME');
$http->put_Password('SHAREPOINT_PASSWORD');
$http->put_LoginDomain('SHAREPOINT_NTLM_DOMAIN');
$http->put_NtlmAuth(true);

// The more common case is to use SharePoint Online authentication (via the SPOIDCRL cookie).
// If so, do not set Login, Password, LoginDomain, and NtlmAuth, and instead
// establish the cookie as shown at SharePoint Online Authentication

// Indicate that we want a JSON reply
$http->put_Accept('application/json;odata=verbose');

// Update /Documents/ChilkatTest/sample.docx with new content...
$req = new CkHttpRequest();
$req->put_HttpVerb('POST');
$req->put_Path('/_api/web/GetFileByServerRelativeUrl('/Documents/ChilkatTest/sample.docx')/$value');
// Give the location of the file to be uploaded.  
// Note: The file is not loaded into memory at this point.  It is never fully loaded
// into memory.  Instead, the file data is streamed directly from the file when
// when the upload occurs.
$req->StreamBodyFromFile('qa_data/msword/sample.docx');

// We need to add a form digest value in the X-RequestDigest header field.
// See this example for details on
// how to get (and cache) a form digest value
$req->AddHeader('X-RequestDigest','SHAREPOINT_FORM_DIGEST');

// Also need to add this header..
$req->AddHeader('X-HTTP-Method','PUT');

// Upload..
$bUseTls = true;
$resp = new CkHttpResponse();
$success = $http->HttpSReq('SHAREPOINT_HTTPS_DOMAIN',443,$bUseTls,$req,$resp);
if ($success == false) {
    print $http->lastErrorText() . "\n";
    exit;
}

// A successful update will return a 204 status code with an empty body.
// A non-successful update will return a JSON response body..
if ($resp->get_StatusCode() != 204) {
    print 'Response status code = ' . $resp->get_StatusCode() . "\n";
    $json = new CkJsonObject();
    $json->Load($resp->bodyStr());
    $json->put_EmitCompact(false);
    print $json->emit() . "\n";
    print 'Failed' . "\n";
    exit;
}

print 'Success.' . "\n";

?>