Zend Framework 1.10.9 Manual

Bei Verwendung des folgenden Codes kann ein Speicher Container auf dem Development Speicher erstellt werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob();
$result = $storageClient->createContainer('testcontainer');

echo 'Der Name des Containers ist: ' . $result->Name;

Bei Verwendung des folgenden Codes kann ein Blob Speicher Container vom Development Speicher entfernt werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob();
$storageClient->deleteContainer('testcontainer');

Bei Verwendung des folgenden Codes kann ein Blob zu einem Blog Speicher Container auf dem Development Speichers hochgeladen werden. Es ist zu beachten das der Container hierfür bereits vorher erstellt worden sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob();

// /home/maarten/example.txt auf Azure hochladen
$result = $storageClient->putBlob(
    'testcontainer', 'example.txt', '/home/maarten/example.txt'
);

echo 'Der Name des Blobs ist: ' . $result->Name;

Bei Verwendung des folgenden Codes kann ein Blob von innerhalb des Speicher Accounts kopiert werden. Der Vorteil der Verwendung dieser Methode besteht darin das die Kopieroperation in der Azure Wolke stattfindet und kein Downloaden vom Blob stattfinden muss. Es ist zu beachten das in diesem Fall der Container bereits vorher erstellt worden sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob();

// Kopiert example.txt auf example2.txt
$result = $storageClient->copyBlob(
    'testcontainer', 'example.txt', 'testcontainer', 'example2.txt'
);

echo 'Der Name des kopierten Blobs ist: ' . $result->Name;

Bei Verwendung des folgenden Codes kann ein Blob von einem Blob Speicher Container auf den Development Speicher heruntergeladen werden. Es ist zu beachten das der Container hierfür bereits vorher erstellt wurden sein und ein Blob darauf hochgeladen sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob();

// Lädt die Datei /home/maarten/example.txt herunter
$storageClient->getBlob(
    'testcontainer', 'example.txt', '/home/maarten/example.txt'
);

Standardmäßig sind Blob Speicher Container in Windows Azure geschützt vor öffentlichem Zugriff. Wenn ein Benutzer im Internet Zugriff auf einen Blob Container haben soll, kann seine ACL auf öffentlich (public) gesetzt werden. Es ist zu beachten dass das auf den kompletten Container angewendet wird, und nicht auf einen einzelnen Blob!

Bei Verwendung des folgenden Codes kann die ACL eines Blob Speicher Containers auf den Development Speicher gesetzt werden. Es ist zu beachten das der Container hierfür bereits vorher erstellt worden sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob();

// Den Container öffentlich zugänglich machen
$storageClient->setContainerAcl(
    'testcontainer',
    Zend_Service_WindowsAzure_Storage_Blob::ACL_PUBLIC
);

Wenn man Eigentümer eines Windows Azure Blob Speicher Accounts ist kann man einen geteilten Zugriffsschlüssel für jeden Typ einer Ressource im eigenen Account erstellen und teilen. Um das zu tun kann die Methode generateSharedAccessUrl() des Zend_Service_WindowsAzure_Storage_Blob Speicher Clients verwendet werden.

Der folgende Beispielcode erzeugt eine Shared Access Signatur für den Schreibzugriff in einem Container der "container1" heißt, in einem Zeitrahmen von 3000 Sekunden.

$storageClient   = new Zend_Service_WindowsAzure_Storage_Blob();
$sharedAccessUrl = $storageClient->generateSharedAccessUrl(
    'container1',
    '',
    'c',
    'w',
    $storageClient ->isoDate(time() - 500),
    $storageClient ->isoDate(time() + 3000)
);

Der folgende Beispielcode erzeugt eine Shared Access Signatur für den Lesezugriff in einem Blob der test.txt heißt und einem Container der "container1" heißt, in einem Zeitrahmen von 3000 Sekunden.

$storageClient   = new Zend_Service_WindowsAzure_Storage_Blob();
$sharedAccessUrl = $storageClient->generateSharedAccessUrl(
    'container1',
    'test.txt',
    'b',
    'r',
    $storageClient ->isoDate(time() - 500),
    $storageClient ->isoDate(time() + 3000)
);

Wenn man eine Shared Access Signatur von jemandem anderen erhält kann man die Windows Azure SDK für PHP verwenden um mit der adressierten Ressource zu arbeiten. Zum Beispiel kann man die folgende Signatur vom Eigentümer eines Speicher Accounts erhalten:

http://phpstorage.blob.core.windows.net/phpazuretestshared1?st=2009-08-17T09%3A06%3A17Z&se=2009-08-17T09%3A56%3A17Z&sr=c&sp=w&sig=hscQ7Su1nqd91OfMTwTkxabhJSaspx%2BD%2Fz8UqZAgn9s%3D
            

Die obige Signatur gibt Schreibzugriff auf "phpazuretestshared1" "container" des PhpSpeicher Accounts. Da der geteilte Schlüssel für den Account nicht bekannt ist, kann die Shared Access Signatur verwendet werden um mit der authorisierten Ressource zu arbeiten.

$storageClient = new Zend_Service_WindowsAzure_Storage_Blob(
    'blob.core.windows.net', 'phpstorage', ''
);
$storageClient->setCredentials(
    new Zend_Service_WindowsAzure_Credentials_SharedAccessSignature()
);
$storageClient->getCredentials()->setPermissionSet(array(
    'http://phpstorage.blob.core.windows.net/phpazuretestshared1?st=2009-08-17T09%3A06%3A17Z&se=2009-08-17T09%3A56%3A17Z&sr=c&sp=w&sig=hscQ7Su1nqd91OfMTwTkxabhJSaspx%2BD%2Fz8UqZAgn9s%3D'
));
$storageClient->putBlob(
    'phpazuretestshared1', 'NewBlob.txt', 'C:\Files\dataforazure.txt'
);

Es ist zu beachten das es keine explizite Erlaubnis für das Schreiben eines spezifischen Blobs gab. Stattdessen hat die Windows Azure SDK für PHP festgestellt das eine Erlaubnis benötigt wurde um entweder an den spezifischen Blob zu schreiben, oder an seinen Container zu schreiben. Da nur eine Signatur für das letztere vorhanden war, hat die Windows Azure SDK für PHP diese Zugriffsrechte ausgewählt um die Anfrage auf den Windows Azure Blob Speicher durchzuführen.

Bei Verwendung des folgenden Codes, kann eine Tabelle auf dem Windows Azure Produktions Tabellen Speicher erstellt werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$result = $storageClient->createTable('testtable');

echo 'Der neue Name der Tabelle ist: ' . $result->Name;

Bei Verwendung des folgendes Codes, kann eine Liste alle Tabellen im Windows Azure Produktions Tabellen Speicher abgefragt werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$result = $storageClient->listTables();
foreach ($result as $table) {
    echo 'Der Name der Tabelle ist: ' . $table->Name . "\r\n";
}

Um ein Schema auf der Seite des Clients bei Verwendung der Klasse Zend_Service_WindowsAzure_Storage_Table zu erzwingen muss eine Klasse erstellt werden welche sich von Zend_Service_WindowsAzure_Storage_TableEntity ableitet. Diese Klasse bietet einige grundsätzliche Funktionalitäten damit die Klasse Zend_Service_WindowsAzure_Storage_Table mit einem client-seitigen Schema arbeitet.

Grundsätzliche Eigenschaften welche von Zend_Service_WindowsAzure_Storage_TableEntity angeboten werden sind:

• PartitionKey (durch getPartitionKey() und setPartitionKey() bekanntgemacht)

• RowKey (durch getRowKey() und setRowKey() bekanntgemacht)

• Timestamp (durch getTimestamp() und setTimestamp() bekantgemacht)

• Etag Wert (durch getEtag() und setEtag() bekanntgemacht)

Hier ist eine Beispielklasse welche sich von Zend_Service_WindowsAzure_Storage_TableEntity ableitet:

class SampleEntity extends Zend_Service_WindowsAzure_Storage_TableEntity
{
    /**
     * @azure Name
     */
    public $Name;

    /**
     * @azure Age Edm.Int64
     */
    public $Age;

    /**
     * @azure Visible Edm.Boolean
     */
    public $Visible = false;
}

Die Klasse Zend_Service_WindowsAzure_Storage_Table mappt jede Klasse welche sich von Zend_Service_WindowsAzure_Storage_TableEntity ableitet auf Windows Azure Tabellen Speicher Entitäten mit dem richtigen Datentyp und dem Namen der Eigenschaft. Alles dort dient dem Speichern einer Eigenschaft in Windows Azure indem ein Docblock Kommentar zu einer öffentlichen Eigenschaft oder einem öffentlichen Getter oder Setter, im folgenden Format hinzugefügt wird:

/**
 * @azure  
 */
public $;

Sehen wir uns an wie eine Eigenschaft "Ago" als Integerwert eines Windows Azure Tabellen Speichers definiert wird:

/**
 * @azure Age Edm.Int64
 */
public $Age;

Es ist zu beachten das die Eigenschaft im Windows Azure Tabellen Speicher nicht notwendigerweise gleich benannt werden muss. Der Name der Windows Azure Tabellen Speicher Eigenschaft kann genauso definiert werden wie der Typ.

Die folgenden Datentypen werden unterstützt:

• Edm.Binary - Ein Array von Types welche bis zu 64 KB Größe.

• Edm.Boolean - Ein boolscher Wert.

• Edm.DateTime - Ein 64-bit Wert welcher als koordinierte universelle Zeit (UTC) ausgedrückt wird. Der unterstützte DateTime Bereich beginnt an 1. Jänner 1601 A.D. (C.E.), koordinierter Universeller Zeit (UTC). Der Bereich endet am 31. Dezember 9999.

• Edm.Double - Eine 64-bit Gleitkommazahl.

• Edm.Guid - Ein 128-bit großer globaler eindeutiger Identifikator.

• Edm.Int32 - Ein 32-bit Integerwert.

• Edm.Int64 - Ein 64-bit Integerwert.

• Edm.String - Ein UTF-16-kodierter Wert. Stringwerte können bis zu 64 KB groß sein.

Um die Klasse Zend_Service_WindowsAzure_Storage_Table ohne Definition eines Schemas zu verwenden kann die Klasse Zend_Service_WindowsAzure_Storage_DynamicTableEntity verwendet werden. Diese Klasse erweitert Zend_Service_WindowsAzure_Storage_TableEntity wie es eine Klasse für ein erzwungenes Schema machen würde, enthält aber zusätzliche Logik um Sie dynamisch zu machen und nicht an ein Schema zu binden.

Die grundsätzlichen Eigenschaften welche von Zend_Service_WindowsAzure_Storage_DynamicTableEntity angeboten werden sind:

• PartitionKey (durch getPartitionKey() und setPartitionKey() bekanntgemacht)

• RowKey (durch getRowKey() und setRowKey() bekanntgemacht)

• Timestamp (durch getTimestamp() und setTimestamp() bekanntgemacht)

• Etag Wert (durch getEtag() und setEtag() bekanntgemacht)

Andere Eigenschaften können on the Fly hinzugefügt werden. Ihre Windows Azure Tabellen Speicher Typen werden auch on the Fly ermittelt:

$target = new Zend_Service_WindowsAzure_Storage_DynamicTableEntity(
    'partition1', '000001'
);
$target->Name = 'Name'; // Fügt die Eigenschaft "Name" vom Typ "Edm.String" hinzu
$target->Age  = 25;     // Fügt die Eigenschaft "Age" vom Typ "Edm.Int32" hinzu

Optional kann der Typ einer Eigenschaft erzwungen werden:

$target = new Zend_Service_WindowsAzure_Storage_DynamicTableEntity(
    'partition1', '000001'
);
$target->Name = 'Name'; // Fügt die Eigenschaft "Name" vom Typ "Edm.String" hinzu
$target->Age  = 25;     // Fügt die Eigenschaft "Age" vom Typ "Edm.Int32" hinzu

// Ändert den Typ der Eigenschaft "Age" auf "Edm.Int32":
$target->setAzurePropertyType('Age', 'Edm.Int64');

Die Klasse Zend_Service_WindowsAzure_Storage_Table arbeitet automatisch mit Zend_Service_WindowsAzure_Storage_TableEntity wenn an die Tabellen Speicher Methoden keine spezielle Klasse übergeben wurde.

Abfragen im Zend_Service_WindowsAzure_Storage_Table Tabellen Speicher können auf zwei Wegen durchgeführt werden:

• Durch manuelles Erstellen einer Filter Kondition (was das Lernen einer neuen Abfrage Sprache beinhaltet)

• Durch Verwendung des fluent Interfaces welches von Zend_Service_WindowsAzure_Storage_Table angeboten wird.

Bei Verwendung des folgenden Codes kann eine Tabelle abgefragt werden indem eine Filter Kondition verwendet wird. Es ist zu beachten das die Tabelle und die Entitäten hierfür vorher bereits erstellt worden sein müssen.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$entities = $storageClient->storageClient->retrieveEntities(
    'testtable',
    'Name eq \'Maarten\' and PartitionKey eq \'partition1\'',
    'SampleEntity'
);

foreach ($entities as $entity) {
    echo 'Name: ' . $entity->Name . "\n";
}

Durch Verwendung des folgenden Codes kann eine tabelle abgefragt werden indem ein fluid Interface verwendet wird. Es ist zu beachten das die Tabelle und die Entität hierfür bereits vorher erstellt worden sein müssen.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$entities = $storageClient->storageClient->retrieveEntities(
    'testtable',
    $storageClient->select()
                  ->from($tableName)
                  ->where('Name eq ?', 'Maarten')
                  ->andWhere('PartitionKey eq ?', 'partition1'),
    'SampleEntity'
);

foreach ($entities as $entity) {
    echo 'Name: ' . $entity->Name . "\n";
}

Dieser Abschnitt demonstriert wie die Tabellen Entitäts Gruppen Transaktions Features verwendet werden können welche vom Windows Azure Tabellen Speicher angeboten werden. Der Windows Azure Tabellen Speicher unterstützt Batch Transaktionen auf Entitäten welche in der gleichen Tabelle sind und der gleichen Partitionsgruppe angehören. Eine Transaktion kann bis zu 100 Entitäten enthalten.

Das folgende Beispiel verwendet eine Batch Operation (Transaktion) um ein Set von Entitäten in die Tabelle "testtable" einzufügen. Es ist zu beachten das die Tabelle hierfür bereits vorher erstellt worden sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);

// Batch starten
$batch = $storageClient->startBatch();

// Entitäten mit Batch einfügen
$entities = generateEntities();
foreach ($entities as $entity) {
    $storageClient->insertEntity($tableName, $entity);
}

// Übermitteln
$batch->commit();

Bei Verwendung des folgenden Codes kann eine Queue auf dem Development Speicher erstellt werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Queue();
$result = $storageClient->createQueue('testqueue');

echo 'Der Name der Queue ist: ' . $result->Name;

Bei Verwendung des folgenden Codes kann eine Queue vom Development Speicher entfernt werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Queue();
$storageClient->deleteQueue('testqueue');

Bei Verwendung des folgenden Codes kann eine Nachricht zu einer Queue im Development Speicher hinzugefügt werden. Es ist zu beachten das die Queue hierfür bereits erstellt worden sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Queue();

// 3600 = Lebenszeit der Nachricht,
// wenn nicht angegeben ist der Standardwert 7 Tage
$storageClient->putMessage('testqueue', 'Das ist eine Testnachricht', 3600);

Bei Verwendung des folgenden Codes kann eine Nachricht von einer Queue im Development Speicher gelesen werden. Es ist zu beachten das die Queue und die Nachricht hierfür bereits erstellt worden sein muss.

$storageClient = new Zend_Service_WindowsAzure_Storage_Queue();

// 10 Nachrichten auf einmal empfangen
$messages = $storageClient->getMessages('testqueue', 10);

foreach ($messages as $message) {
    echo $message->MessageText . "\r\n";
}

Die Nachrichten welche mit getMessages() gelesen werden, werden in der Queue für 30 Sekunden unsichtbar, und danach werden die Nachrichten in der Queue wieder erscheinen. Um eine Nachricht als bearbeitet zu markieren und Sie von der Queue zu entfernen, kann die Methode deleteMessage() verwendet werden.

$storageClient = new Zend_Service_WindowsAzure_Storage_Queue();

// 10 Nachrichten auf einmal empfangen
$messages = $storageClient->getMessages('testqueue', 10);

foreach ($messages as $message) {
    echo $message . "\r\n";

    // Die Nachricht als bearbeitet markieren
    $storageClient->deleteMessage('testqueue', $message);
}

Bei Verwendung des folgenden Codes kann eine Queue auf neue Nachrichten geprüft werden. Es ist zu beachten das die Queue und die Nachricht hierfür bereits erstellt worden sein müssen.

$storageClient = new Zend_Service_WindowsAzure_Storage_Queue();

// 10 Nachrichten auf einmal empfangen
$messages = $storageClient->peekMessages('testqueue', 10);

foreach ($messages as $message) {
    echo $message->MessageText . "\r\n";
}

Es ist zu beachten das Nachrichten welche mit Hilfe von peekMessages() gelesen werden in der Queue nicht unsichtbar, und durch Verwendung der Methode deleteMessage() auch nicht als bearbeitet markiert werden können. Um das zu tun sollte stattdessen getMessages() verwendet werden.