(PHP ActiveX) Azure Blob - Get Tags (Check if Blob Exists)

See more Azure Cloud Storage Examples

Gets the user-defined tags for a specified blob. This can also be used as a way to check to see if a blob exists.

For more information, see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob-tags

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows Note: The php_com_dotnet.dll may need to be enabled inside of php.ini.

<?php

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

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Rest')
$rest = new COM("Chilkat.Rest");

// Connect to the Azure Storage Blob Service
$bTls = 1;
$port = 443;
$bAutoReconnect = 1;
// In this example, the storage account name is "chilkat".
$success = $rest->Connect('chilkat.blob.core.windows.net',$port,$bTls,$bAutoReconnect);
if ($success != 1) {
    print $rest->LastErrorText . "\n";
    exit;
}

// Provide Azure Cloud credentials for the REST call.
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.AuthAzureStorage')
$azAuth = new COM("Chilkat.AuthAzureStorage");
$azAuth->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->Account = 'chilkat';
$azAuth->Scheme = 'SharedKey';
$azAuth->Service = 'Blob';
// This causes the "x-ms-version: 2021-08-06" header to be automatically added.
$azAuth->XMsVersion = '2021-08-06';
$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.

// The Azure blob container is "test", the file is "helloWorld.txt"
// Add "?comp=tags" to get the user-defined tags instead of the actual blob content.
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sb = new COM("Chilkat.StringBuilder");
$success = $rest->FullRequestNoBodySb('GET','/test/helloWorldajdfadf.txt?comp=tags',$sb);
if ($success == 0) {
    // Examine the request/response to see what happened.
    print 'response status code = ' . $rest->ResponseStatusCode . "\n";
    print 'response status text = ' . $rest->ResponseStatusText . "\n";
    print 'response header: ' . $rest->ResponseHeader . "\n";
    print '---' . "\n";
    print 'LastRequestStartLine: ' . $rest->LastRequestStartLine . "\n";
    print 'LastRequestHeader: ' . $rest->LastRequestHeader . "\n";
    exit;
}

// A typical blob with no tags will return this:

// <?xml version="1.0" encoding="utf-8"?>
// <Tags><TagSet/></Tags>

// If the blob does not exist, you get this:

// <?xml version="1.0" encoding="utf-8"?>
// <Error>
//     <Code>BlobNotFound</Code>
//     <Message>The specified blob does not exist.
// 	RequestId:fcfefdd9-301e-001a-2135-3a23d2000000
// 	Time:2023-02-06T14:17:00.7805577Z
//     </Message>
// </Error>

print $sb->getAsString() . "\n";

// To see if we got Tags or an Error, then examine the XML.
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Xml')
$xml = new COM("Chilkat.Xml");
$xml->LoadSb($sb,1);

// Examine the tag..
if ($xml->TagEquals('Tags') == 1) {
    print 'Blob exists!' . "\n";
}
else {

    if ($xml->ChildContentMatches('Code','BlobNotFound',1) == 1) {
        print 'Blob does not exist.' . "\n";
    }
    else {
        print 'Some other error...' . "\n";
    }

}

print 'Success.' . "\n";

?>