(PHP Extension) Azure Table Insert Entity

See more Azure Table Service Examples

Insert an entity into an Azure table.

For more information, see https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity

Chilkat PHP Downloads PHP Extension for Windows, Linux, MacOS, Alpine Linux, Solaris

<?php

// The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number.
// For example, if using Chilkat v9.5.0.48, then include as shown here:
include("chilkat_9_5_0.php");

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

$rest = new CkRest();

// IMPORTANT: Make sure to change "myaccount" to your actual Azure Storage Account name.
// IMPORTANT: Also change "mytable" to the name of your Azure table.
// We're going to POST to this URL:  https://myaccount.table.core.windows.net/mytable
$bTls = true;
$port = 443;
$bAutoReconnect = true;
$success = $rest->Connect('myaccount.table.core.windows.net',$port,$bTls,$bAutoReconnect);
if ($success != true) {
    print 'ConnectFailReason: ' . $rest->get_ConnectFailReason() . "\n";
    print $rest->lastErrorText() . "\n";
    exit;
}

// Provide Azure Cloud credentials for the REST call.
$azAuth = new CkAuthAzureStorage();
$azAuth->put_AccessKey('AZURE_ACCESS_KEY');
// The account name used here should match the 1st part of the domain passed in the call to Connect (above).
$azAuth->put_Account('myaccount');
$azAuth->put_Scheme('SharedKey');
$azAuth->put_Service('Table');

// This causes the "x-ms-version: 2019-07-07" header to be automatically added.
$azAuth->put_XMsVersion('2019-07-07');
$success = $rest->SetAuthAzureStorage($azAuth);

// Note: The application does not need to explicitly set the following
// headers: Content-Length, x-ms-date, Authorization.  These headers
// are automatically set by Chilkat.

// Note: The above code does not need to be repeatedly called for each REST request.
// The rest object can be setup once, and then many requests can be sent.  Chilkat will automatically
// reconnect within a FullRequest* method as needed.  It is only the very first connection that is explicitly
// made via the Connect method.

// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON

// The following JSON is sent in the request body.

// {  
//    "PartitionKey":"mypartitionkey",  
//    "RowKey":"myrowkey",  
//    "Timestamp":"2013-08-22T01:12:06.2608595Z",  
//    "Address":"Mountain View",  
//    "Age":23,  
//    "AmountDue":200.23,  
//    "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
//    "CustomerSince":"2008-07-10T00:00:00",  
//    "IsActive":true,  
//    "NumberOfOrders":"255"  
// }  

$json = new CkJsonObject();
$json->UpdateString('PartitionKey','mypartitionkey');
$json->UpdateString('RowKey','myrowkey');
$json->UpdateString('Timestamp','2013-08-22T01:12:06.2608595Z');
$json->UpdateString('Address','Mountain View');
$json->UpdateInt('Age',23);
$json->UpdateNumber('AmountDue','200.23');
$json->UpdateString('CustomerCode','c9da6455-213d-42c9-9a79-3e9149a57833');
$json->UpdateString('CustomerSince','2008-07-10T00:00:00');
$json->UpdateBool('IsActive',true);
$json->UpdateString('NumberOfOrders','255');

// IMPORTANT: Pay attention to the options for nometadata, minimalmetadata, or fullmetadata.
// See the Azure table service API documentation at https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity
$rest->AddHeader('Accept','application/json;odata=nometadata');
$rest->AddHeader('Prefer','return-no-content');
$rest->AddHeader('Content-Type','application/json');

$sbRequestBody = new CkStringBuilder();
$json->EmitSb($sbRequestBody);
$sbResponseBody = new CkStringBuilder();
// IMPORTANT: Change "mytable" to the name of your actual table.
$success = $rest->FullRequestSb('POST','/mytable',$sbRequestBody,$sbResponseBody);
if ($success != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

// A status code of 204 is a success response for the case where Prefer=return-no-content.
$respStatusCode = $rest->get_ResponseStatusCode();
print 'Response Status Code = ' . $respStatusCode . "\n";
if ($respStatusCode >= 400) {
    print 'Response Header:' . "\n";
    print $rest->responseHeader() . "\n";
    print 'Response Body:' . "\n";
    print $sbResponseBody->getAsString() . "\n";
    exit;
}

print 'Success.' . "\n";

?>