PHPAzure Wiki & Documentation Rss Feed

Updated Wiki: Home

maartenba — Wed, 06 Jun 2012 06:20:19 GMT

Windows Azure SDK for PHP

Deprecated in favor of the new SDK on GitHub

The Microsoft Windows Azure team has released a new Windows Azure SDK for PHP. This release is part of an effort to keep PHP client libraries up to date with new Windows Azure features and to make PHP a first-class citizen in Windows Azure. The latest client libraries are on GitHub. While the SDK hosted on here will continue to work for the foreseeable future, it is strongly recommended that new PHP/Windows Azure applications use the SDK hosted on GitHub.

1. What is Windows Azure SDK for PHP?

As part of Microsoft’s commitment to Interoperability, this open source project is an effort bridge PHP developers to Windows Azure. The Windows Azure SDK for PHP is an open source project to provide a software development kit for Windows Azure and Windows Azure Storage.

Overview
- Enables PHP developers to take advantage of the Microsoft Cloud Services Platform – Windows Azure.
- Provides consistent programming model for Windows Azure Storage (Blobs, Tables & Queues)
Features
- PHP classes for Windows Azure Blobs, Tables & Queues (for CRUD operations)
- Helper Classes for HTTP transport, AuthN/AuthZ, REST & Error Management
- Manageability, Instrumentation & Logging support
- Support for storing PHP sessions in Azure Table Storage
- Management API client
- Diagnostics client
- Command line tools set for
  - Packaging
  - Management
  - Diagnostics
  - Deployment

View the Documentation page of this project or the Windows Azure PHP website maintained by the Microsoft Interoperability Team.

2. Project contributors

Windows Azure SDK for PHP is an open source collaboration project driven by RealDolmen and Microsoft

The RealDolmen Microsoft Competence Centre is occupied with the supply of made-to-measure professional Microsoft solutions to customers and is the largest Microsoft integrator in Belgium. RealDolmen has over 10 years of experience of complete implementation of Microsoft projects in terms of strategy, architecture, implementation, integration of systems, maintenance, training as well as support.

Microsoft is the project sponsor and provides Architectural & Technical Guidance on its Windows Azure platform.

Thanks to

RealDolmen, contributor
Microsoft, sponsor
Zitec, feedback and testing

Updated Wiki: Home

maartenba — Wed, 06 Jun 2012 06:19:19 GMT

Windows Azure SDK for PHP TL;DR; Deprecated in favor of the new SDK on GitHub

1. What is Windows Azure SDK for PHP?

Overview
- Enables PHP developers to take advantage of the Microsoft Cloud Services Platform – Windows Azure.
- Provides consistent programming model for Windows Azure Storage (Blobs, Tables & Queues)
Features
- PHP classes for Windows Azure Blobs, Tables & Queues (for CRUD operations)
- Helper Classes for HTTP transport, AuthN/AuthZ, REST & Error Management
- Manageability, Instrumentation & Logging support
- Support for storing PHP sessions in Azure Table Storage
- Management API client
- Diagnostics client
- Command line tools set for
  - Packaging
  - Management
  - Diagnostics
  - Deployment

View the Documentation page of this project or the Windows Azure PHP website maintained by the Microsoft Interoperability Team.

2. Project contributors

Thanks to

RealDolmen, contributor
Microsoft, sponsor
Zitec, feedback and testing

New Comment on "Diagnostics"

aurelious — Tue, 24 Jan 2012 12:06:02 GMT

$_SERVER['RdRoleId'] does not exist (s. http://phpazure.codeplex.com/workitem/6650)

New Comment on "Table storage session handler"

aurelious — Wed, 21 Dec 2011 17:03:04 GMT

Hi, do you have an idea why my application is 10 times slower (~400ms) with the TableSessionHandler than without it (~40ms)? (session_start is called after the handler registration)

Updated Wiki: Documentation

blobaugh — Tue, 22 Nov 2011 16:32:42 GMT

Updated Wiki: Home

blobaugh — Tue, 13 Sep 2011 22:01:01 GMT

Windows Azure SDK for PHP

1. What is Windows Azure SDK for PHP?

Overview
- Enables PHP developers to take advantage of the Microsoft Cloud Services Platform – Windows Azure.
- Provides consistent programming model for Windows Azure Storage (Blobs, Tables & Queues)
Features
- PHP classes for Windows Azure Blobs, Tables & Queues (for CRUD operations)
- Helper Classes for HTTP transport, AuthN/AuthZ, REST & Error Management
- Manageability, Instrumentation & Logging support
- Support for storing PHP sessions in Azure Table Storage
- Management API client
- Diagnostics client
- Command line tools set for
  - Packaging
  - Management
  - Diagnostics
  - Deployment

View the Documentation page of this project or the Windows Azure PHP website maintained by the Microsoft Interoperability Team.

2. Project contributors

Thanks to

RealDolmen, contributor
Microsoft, sponsor
Zitec, feedback and testing

New Comment on "Documentation"

blobaugh — Tue, 13 Sep 2011 21:53:21 GMT

Please see http://azurephp.interoperabilitybridges.com/tutorials for tutorials on deploying WordPress, Drupal and other PHP CMS on Windows Azure

Updated Wiki: Documentation

blobaugh — Tue, 13 Sep 2011 21:52:07 GMT

New Comment on "Documentation"

ajaleelka — Sat, 16 Apr 2011 16:07:34 GMT

Here is a full detailed presentation on how to setup wordpress on azure. http://cloudgeist.blogspot.com/2011/04/guide-on-hosting-wordpress-on-windows.html

Updated Wiki: Table storage session handler

maartenba — Fri, 08 Apr 2011 10:41:01 GMT

Getting Started

Back to Getting Started.
Back to Table storage.

Table storage session handler

When running a PHP application on the Windows Azure platform in a load-balanced mode (running 2 Web Role instances or more), it is important that PHP session data can be shared between multiple Web Role instances. The Windows Azure SDK for PHP provides the Microsoft_WindowsAzure_SessionHandler class, which uses Windows Azure Table Storage or Blob Storage as a session handler for PHP applications.

To use the Microsoft_WindowsAzure_SessionHandler session handler, it should be registered as the default session handler for your PHP application:

/** Microsoft_WindowsAzure_Storage_Table */
require_once 'Microsoft/WindowsAzure/Storage/Table.php'; // note you can also use blob storage for larger sessions

/** Microsoft_WindowsAzure_SessionHandler */
require_once 'Microsoft/WindowsAzure/SessionHandler.php';

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

$sessionHandler = new Microsoft_WindowsAzure_SessionHandler($storageClient , 'sessionstable');
$sessionHandler->register();

The above code registers the Microsoft_WindowsAzure_SessionHandler session handler and will store sessions in a table called "sessionstable".

After registration of the Microsoft_WindowsAzure_SessionHandler session handler, sessions can be started and used in the same way as a normal PHP session:

/** Microsoft_WindowsAzure_Storage_Table */
require_once 'Microsoft/WindowsAzure/Storage/Table.php';

/** Microsoft_WindowsAzure_SessionHandler */
require_once 'Microsoft/WindowsAzure/SessionHandler.php';

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

$sessionHandler = new Microsoft_WindowsAzure_SessionHandler($storageClient , 'sessionstable');
$sessionHandler->register();

session_start();

if (!isset($_SESSION['firstVisit']))
{
    $_SESSION['firstVisit'] = time();
}

// ...

WARNING: The Microsoft_WindowsAzure_SessionHandler session handler should be registered before a call to session_start() is made!

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 11:22:37 GMT

Management

Back to Getting Started.

Introduction

The Service Management API provides programmatic access to much of the functionality available through the Management Portal. Using the Service Management API, you can manage your storage accounts and hosted services, your service deployments, and your affinity groups.

The Service Management API is a REST API. All API operations are performed over SSL and mutually authenticated using X.509 v3 certificates. The management service may be accessed from within a service running in Windows Azure, or directly over the Internet from any application that can send an HTTPS request and receive an HTTPS response. For more background and in-depth information about the management API's, refer to the MSDN documentation.

The Windows Azure SDK for PHP provides a wrapper for the REST API calls, providing native PHP access to all the functionality exposed by this service.

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Any X.509 v3 certificate can be used for authentication against the Service Management API. You can use a self-signed certificate or one signed by a certificate authority. The length of the certificate's key must be at least 2048 bits. Windows Azure will reject any certificate that does not meet this requirement.

A pair of PFX and CER (private and public) certificates should be generated. Also, a PEM certificate will be required for connecting to the management API from PHP. Generating the required certificates can be done as follows:

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

In order for the Windows Azure SDK to be able to connect to the Windows Azure Service Management API, a certificate file should be uploaded to the Windows Azure management portal. This can be done through http://windows.azure.com.

Under Hosted Services, Storage Accounts & CDN, upload the CER file created previously.

API examples

This topic lists some examples of using the Windows Azure SDK for PHP. Other features are available in the download package, as well as a detailed API documentation of those features.

Creating a management client instance

All service management requests are done through the Microsoft_WindowsAzure_Management_Client class.

1 // Certificate
2 $certificate = '<path-to-certificate.pem>';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     '<subscription id', $certificate, '<optional certificate password>');

A real example of this can be the following:

1 // Certificate
2 $certificate = 'C:\Projects\Workspaces\Default\Azure\management.pem';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     'xxxxxxxx-xxxx-xxxx-xxxx-xxxx', $certificate, 'c00lP@ssw0rd');

Creating a hosted service programmatically

A hosted service can be created programmatically. The following code creates a new hosted service located in West Europe named wazsdk-sample with a label wazsdk-sample. A description is also given to the hosted service.

1 $client->createHostedService('wazsdk-sample', 'wazsdk-sample', 'Sample using Windows Azure SDK for PHP', 'West Europe');

Creating a deployment programmatically

First of all, a valid .cspkg Windows Azure deployment package should be created and uploaded to a blob storage account in the same subscription as your hosted service. This can be done using any blob storage client, for example the Windows Azure SDK blob client, which can be created through the management API. The following code block uploads a file WindowsAzureProject1.cspkg to a blob storage account sdksamplestorage.

1 $blobClient = $client->createBlobClientForService('sdksamplestorage');
2 $blobClient->createContainerIfNotExists('deployments');
3 $blobClient->putBlob('deployments', 'WindowsAzureProject1.cspkg', 'c:\temp\WindowsAzureProject1.cspkg');
4 
5 $packageUrl = 'http://sdksamplestorage.blob.core.windows.net/deployments/WindowsAzureProject1.cspkg';

Next, the actual deployment to a staging or production slot can be performed. The following statement creates a production deployment named mydeployment1 in the hosted service labeled wazsdk-sample. Also, a configuration file should be specified. This can be a path to a ServiceConfiguration.cscfg file on the file system or the actual XML contents of that file. For you to decide.

1 $client->createDeployment('wazsdk-sample', 'production', 'mydeployment1', 'mydeployment1', $packageUrl, 'c:\temp\ServiceConfiguration.cscfg', true);

This will trigger the deployment process on Windows Azure. If needed, a “waiting loop” can be created to continue other code only after the deployment is finished. Note that this is optional.

1 $client->waitForOperation();

Other supported actions

The following actions are currently possible using the Windows Azure for SDK management client:

Tracking Asynchronous Service Management Requests
- Get Operation Status
Operations on Storage Accounts
- List Storage Accounts
- Get Storage Account Properties
- Get Storage Account Keys
- Regenerate Storage Account Keys
Operations on Hosted Services
- List Hosted Services
- Create Hosted Service
- Update Hosted Service
- Delete Hosted Service
- Get Hosted Service Properties
- Create Deployment
- Get Deployment
- Swap Deployment
- Delete Deployment
- Change Deployment Configuration
- Update Deployment Status
- Upgrade Deployment
- Walk Upgrade Domain
- Reboot Role Instance
- Reimage Role Instance
Operations on Certificates
- List Certificates
- Get Certificate
- Add Certificate
- Delete Certificate
Operations on Affinity Groups
- List Affinity Groups
- Create Affinity Group
- Delete Affinity Group
- Update Affinity Group
- Get Affinity Group Properties
Operations on Locations
- List Locations
Operations for Tracking Asynchronous Requests
- List Operating Systems
- List Operating System Families
Operations for Retrieving Operating System Information
- List Operating Systems
- List Operating System Families
List Subscription Operations

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 09:10:41 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

Under Hosted Services, Storage Accounts & CDN, upload the CER file created previously.

API examples

This topic lists some examples of using the Windows Azure SDK for PHP. Other features are available in the download package, as well as a detailed API documentation of those features.

Creating a management client instance

All service management requests are done through the Microsoft_WindowsAzure_Management_Client class.

1 // Certificate
2 $certificate = '<path-to-certificate.pem>';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     '<subscription id', $certificate, '<optional certificate password>');

A real example of this can be the following:

1 // Certificate
2 $certificate = 'C:\Projects\Workspaces\Default\Azure\management.pem';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     'xxxxxxxx-xxxx-xxxx-xxxx-xxxx', $certificate, 'c00lP@ssw0rd');

Creating a hosted service programmatically

1 $client->createHostedService('wazsdk-sample', 'wazsdk-sample', 'Sample using Windows Azure SDK for PHP', 'West Europe');

Creating a deployment programmatically

1 $blobClient = $client->createBlobClientForService('sdksamplestorage');
2 $blobClient->createContainerIfNotExists('deployments');
3 $blobClient->putBlob('deployments', 'WindowsAzureProject1.cspkg', 'c:\temp\WindowsAzureProject1.cspkg');
4 
5 $packageUrl = 'http://sdksamplestorage.blob.core.windows.net/deployments/WindowsAzureProject1.cspkg';

1 $client->createDeployment('wazsdk-sample', 'production', 'mydeployment1', 'mydeployment1', $packageUrl, 'c:\temp\ServiceConfiguration.cscfg', true);

This will trigger the deployment process on Windows Azure. If needed, a “waiting loop” can be created to continue other code only after the deployment is finished. Note that this is optional.

1 $client->waitForOperation();

Other supported actions

The following actions are currently possible using the Windows Azure for SDK management client:

Tracking Asynchronous Service Management Requests
- Get Operation Status
Operations on Storage Accounts
- List Storage Accounts
- Get Storage Account Properties
- Get Storage Account Keys
- Regenerate Storage Account Keys
Operations on Hosted Services
- List Hosted Services
- Create Hosted Service
- Update Hosted Service
- Delete Hosted Service
- Get Hosted Service Properties
- Create Deployment
- Get Deployment
- Swap Deployment
- Delete Deployment
- Change Deployment Configuration
- Update Deployment Status
- Upgrade Deployment
- Walk Upgrade Domain
- Reboot Role Instance
- Reimage Role Instance
Operations on Certificates
- List Certificates
- Get Certificate
- Add Certificate
- Delete Certificate
Operations on Affinity Groups
- List Affinity Groups
- Create Affinity Group
- Delete Affinity Group
- Update Affinity Group
- Get Affinity Group Properties
Operations on Locations
- List Locations
Operations for Tracking Asynchronous Requests
- List Operating Systems
- List Operating System Families
Operations for Retrieving Operating System Information
- List Operating Systems
- List Operating System Families
List Subscription Operations

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 09:06:03 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

Under Hosted Services, Storage Accounts & CDN, upload the CER file created previously.

API examples

This topic lists some examples of using the Windows Azure SDK for PHP. Other features are available in the download package, as well as a detailed API documentation of those features.

Creating a management client instance

All service management requests are done through the Microsoft_WindowsAzure_Management_Client class.

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 // Certificate
2 $certificate = '<path-to-certificate.pem>';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     '<subscription id', $certificate, '<optional certificate password>');

A real example of this can be the following:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 // Certificate
2 $certificate = 'C:\Projects\Workspaces\Default\Azure\management.pem';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     'xxxxxxxx-xxxx-xxxx-xxxx-xxxx', $certificate, 'c00lP@ssw0rd');

Creating a hosted service programmatically

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 $client->createHostedService('wazsdk-sample', 'wazsdk-sample', 'Sample using Windows Azure SDK for PHP', 'West Europe');

Creating a deployment programmatically

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 $blobClient = $client->createBlobClientForService('sdksamplestorage');
2 $blobClient->createContainerIfNotExists('deployments');
3 $blobClient->putBlob('deployments', 'WindowsAzureProject1.cspkg', 'c:\temp\WindowsAzureProject1.cspkg');
4 
5 $packageUrl = 'http://sdksamplestorage.blob.core.windows.net/deployments/WindowsAzureProject1.cspkg';

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 $client->createDeployment('wazsdk-sample', 'production', 'mydeployment1', 'mydeployment1', $packageUrl, 'c:\temp\ServiceConfiguration.cscfg', true);

This will trigger the deployment process on Windows Azure. If needed, a “waiting loop” can be created to continue other code only after the deployment is finished. Note that this is optional.

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 $client->waitForOperation();

Other supported actions

The following actions are currently possible using the Windows Azure for SDK management client:

Tracking Asynchronous Service Management Requests

Get Operation Status

Operations on Storage Accounts

List Storage Accounts
Get Storage Account Properties
Get Storage Account Keys
Regenerate Storage Account Keys

Operations on Hosted Services

List Hosted Services
Create Hosted Service
Update Hosted Service
Delete Hosted Service
Get Hosted Service Properties
Create Deployment
Get Deployment
Swap Deployment
Delete Deployment
Change Deployment Configuration
Update Deployment Status
Upgrade Deployment
Walk Upgrade Domain
Reboot Role Instance
Reimage Role Instance

Operations on Certificates

List Certificates
Get Certificate
Add Certificate
Delete Certificate

Operations on Affinity Groups

List Affinity Groups
Create Affinity Group
Delete Affinity Group
Update Affinity Group
Get Affinity Group Properties

Operations on Locations

List Locations

Operations for Tracking Asynchronous Requests

List Operating Systems
List Operating System Families

Operations for Retrieving Operating System Information

List Operating Systems
List Operating System Families

List Subscription Operations

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 08:58:02 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

Under Hosted Services, Storage Accounts & CDN, upload the CER file created previously.

API examples

This topic lists some examples of using the Windows Azure SDK for PHP. Other features are available in the download package, as well as a detailed API documentation of those features.

Creating a management client instance

All service management requests are done through the Microsoft_WindowsAzure_Management_Client class.

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 // Certificate
2 $certificate = '<path-to-certificate.pem>';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     '<subscription id', $certificate, '<optional certificate password>');

A real example of this can be the following:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 // Certificate
2 $certificate = 'C:\Projects\Workspaces\Default\Azure\management.pem';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     'xxxxxxxx-xxxx-xxxx-xxxx-xxxx', $certificate, 'c00lP@ssw0rd');

Creating a hosted service programmatically

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 $client->createHostedService('wazsdk-sample', 'wazsdk-sample', 'Sample using Windows Azure SDK for PHP', 'West Europe');

Creating a deployment programmatically

TODO

Other supported actions

The following actions are currently possible using the Windows Azure for SDK management client:

Tracking Asynchronous Service Management Requests

Get Operation Status

Operations on Storage Accounts

List Storage Accounts
Get Storage Account Properties
Get Storage Account Keys
Regenerate Storage Account Keys

Operations on Hosted Services

Operations on Certificates

List Certificates
Get Certificate
Add Certificate
Delete Certificate

Operations on Affinity Groups

List Affinity Groups
Create Affinity Group
Delete Affinity Group
Update Affinity Group
Get Affinity Group Properties

Operations on Locations

List Locations

Operations for Tracking Asynchronous Requests

List Operating Systems
List Operating System Families

Operations for Retrieving Operating System Information

List Operating Systems
List Operating System Families

List Subscription Operations

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 08:50:02 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

Under Hosted Services, Storage Accounts & CDN, upload the CER file created previously.

API examples

This topic lists some examples of using the Windows Azure SDK for PHP. Other features are available in the download package, as well as a detailed API documentation of those features.

Creating a management client instance

All service management requests are done through the class.

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 // Certificate
2 $certificate = '<path-to-certificate.pem>';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     '<subscription id', $certificate, '<optional certificate password>');

A real example of this can be the following:

<!--

Code highlighting produced by Actipro CodeHighlighter (freeware)
http://www.CodeHighlighter.com/

-->1 // Certificate
2 $certificate = 'C:\Projects\Workspaces\Default\Azure\management.pem';
3 
4 // Require client
5 require 'Microsoft/WindowsAzure/Management/Client.php';
6 
7 $client = new Microsoft_WindowsAzure_Management_Client(
8     'xxxxxxxx-xxxx-xxxx-xxxx-xxxx', $certificate, 'c00lP@ssw0rd');

Creating a hosted service programmatically

TODO

Creating a deployment programmatically

TODO

Other supported actions

TODO

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 08:44:41 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

Under Hosted Services, Storage Accounts & CDN, upload the CER file created previously.

Example usage

TODO

Creating a hosted service programmatically

TODO

Creating a deployment programmatically

TODO

Other supported actions

TODO

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 08:36:30 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

TODO

Example usage

TODO

Creating a hosted service programmatically

TODO

Creating a deployment programmatically

TODO

Other supported actions

TODO

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 08:35:26 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.

openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
Issue the following command to convert the PEM certificate to a PFX certificate.

openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
Issue the following command to convert the PEM cetificate to a CER certificate.

openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

TODO

Example usage

TODO

Creating a hosted service programmatically

TODO

Creating a deployment programmatically

TODO

Other supported actions

TODO

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 08:34:48 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

The Service Management API requires mutual authentication of certificates over SSL to ensure that a request made to the management service is secure.

To make a request against the Service Management API, you must first associate a certificate with your subscription, then send the certificate's private key with the request.

Generating a management certificate

Download OpenSSL from http://www.openssl.org/related/binaries.html.
Start a command prompt and navigate to the folder where OpenSSL.exe is installed
Issue the following statement to generate a PEM certificate. This certificate will be the base certificate used by PHP to connect to the management service API.
{code}
openssl req -x509 -nodes -days 9999 -newkey rsa:2048 -keyout mycert.pem -out mycert.pem
{code}
Issue the following command to convert the PEM certificate to a PFX certificate.
{code}
openssl pkcs12 -export -out mycert.pfx -in mycert.pem -name "My Certificate"
{code}
Issue the following command to convert the PEM cetificate to a CER certificate.
{code}
openssl x509 -in mycert.pem -inform PEM -out mycert.cer -outform DER
{code}

The folder where OpenSSL.exe is installed will now contain 3 files: mycert.pem, mycert.pfx and mycert.cer. These files can be used for connecting to the management API from PHP.

Preparing your subscription to use the Management API

TODO

Example usage

TODO

Creating a hosted service programmatically

TODO

Creating a deployment programmatically

TODO

Other supported actions

TODO

Updated Wiki: Management

maartenba — Fri, 01 Apr 2011 07:27:09 GMT

Management

Back to Getting Started.

Introduction

Prerequisites

Generating a management certificate

TODO

Preparing your subscription to use the Management API

TODO

Example usage

TODO

Creating a hosted service programmatically

TODO

Creating a deployment programmatically

TODO

Other supported actions

TODO