Update Composer install section in README.md

README.md

@@ -37,7 +37,7 @@ Microsoft Azure tables, blobs, queues, service bus (queues and topics), service
   * deployment: create, get, delete, swap, change configuration, update status, upgrade, rollback
   * role instance: reboot, reimage
   * REST API Version: 2011-10-01
-* Media Services 
+* Media Services
   * Connection
   * Ingest asset, upload files
   * Encoding / process asset, create job, job templates
@@ -47,7 +47,7 @@ Microsoft Azure tables, blobs, queues, service bus (queues and topics), service
   * Scale encoding reserved unit type
   * REST API Version: 2.11
 
-  
+
 # Getting Started
 ## Download Source Code
 
@@ -57,26 +57,33 @@ To get the source code from GitHub, type
     cd ./azure-sdk-for-php
 
 > **Note**
-> 
+>
 > The PHP Client Libraries for Microsoft Azure have a dependency on the [HTTP_Request2](http://pear.php.net/package/HTTP_Request2), [Mail_mime](http://pear.php.net/package/Mail_mime), and [Mail_mimeDecode](http://pear.php.net/package/Mail_mimeDecode) PEAR packages. The recommended way to resolve these dependencies is to install them using the [Composer package manager](http://getcomposer.org).
 
-
 ##Install via Composer
+1. Make sure you have installed **[Compoeser](https://getcomposer.org/doc/00-intro.md#introduction)** in your system.
+It can be installed locally or globally depending on your own needs.
+
+2. You can edit your `composer.json` file manually or directly add the requirement via CLI:
 
-* Create a file named **composer.json** in the root of your project and add the following code to it:
+###Manually edit
+Create or edit your **composer.json** in the root of your project and add the following code to it:
 ```json
-    {
-        "require": {        
-            "microsoft/windowsazure": "^0.4"
-        }  
+{
+    "require": {
+        "microsoft/windowsazure": "^0.4"
     }
+}
 ```
 
-* Download **[composer.phar](http://getcomposer.org/composer.phar)** in your project root.
-
 * Open a command prompt and execute this in your project root
 
-    php composer.phar install
+    php composer install
+
+###Add requirement and install with one command
+Execute the following command in order to get this package:
+
+    php composer create-project microsoft/windowsazure /path/to/install/dir ^0.4
 
   > **Note**
   >
@@ -86,12 +93,12 @@ To get the source code from GitHub, type
 
 ## Getting Started
 
-There are four basic steps that have to be performed before you can make a call to any Microsoft Azure API when using the libraries. 
+There are four basic steps that have to be performed before you can make a call to any Microsoft Azure API when using the libraries.
 
 * First, include the autoloader script:
 
-    require_once "vendor/autoload.php"; 
-  
+    require_once "vendor/autoload.php";
+
 * Include the namespaces you are going to use.
 
   To create any Microsoft Azure service client you need to use the **ServicesBuilder** class:
@@ -102,15 +109,15 @@ There are four basic steps that have to be performed before you can make a call
 
     use WindowsAzure\Common\ServiceException;
 
-  
-* To instantiate the service client you will also need a valid connection string. The format is: 
+
+* To instantiate the service client you will also need a valid connection string. The format is:
 
   * For accessing a live storage service (tables, blobs, queues):
-  
+
       DefaultEndpointsProtocol=[http|https];AccountName=[yourAccount];AccountKey=[yourKey]
-  
+
   * For accessing the emulator storage:
-  
+
       UseDevelopmentStorage=true
 
   * For accessing the Service Bus:
@@ -221,9 +228,9 @@ The following are examples of common operations performed with the Blob serivce.
 ```PHP
 // OPTIONAL: Set public access policy and metadata.
 // Create container options object.
-$createContainerOptions = new CreateContainerOptions(); 
+$createContainerOptions = new CreateContainerOptions();
 
-// Set public access policy. Possible values are 
+// Set public access policy. Possible values are
 // PublicAccessType::CONTAINER_AND_BLOBS and PublicAccessType::BLOBS_ONLY.
 // CONTAINER_AND_BLOBS: full public read access for container and blob data.
 // BLOBS_ONLY: public read access for blobs. Container data not available.
@@ -277,7 +284,7 @@ try {
   // List blobs.
   $blob_list = $blobRestProxy->listBlobs("mycontainer");
   $blobs = $blob_list->getBlobs();
-  
+
   foreach($blobs as $blob)
   {
     echo $blob->getName().": ".$blob->getUrl()."<br />";
@@ -317,7 +324,7 @@ try {
 ```
 
 [Error Codes and Messages for Queues](http://msdn.microsoft.com/en-us/library/windowsazure/dd179446.aspx)
-  
+
 
 ### Add a message to a queue
 
@@ -398,20 +405,20 @@ try {
 ```
 
 ## Service Bus Queues
-The current PHP Service Bus APIs only support ACS connection strings. You need to use PowerShell to create a new ACS Service Bus namespace at the present time.  
-First, make sure you have Azure PowerShell installed, then in a PowerShell command prompt, run 
+The current PHP Service Bus APIs only support ACS connection strings. You need to use PowerShell to create a new ACS Service Bus namespace at the present time.
+First, make sure you have Azure PowerShell installed, then in a PowerShell command prompt, run
 ```
 Add-AzureAccount # this will sign you in
 New-AzureSBNamespace -CreateACSNamespace $true -Name 'mytestbusname' -Location 'West US' -NamespaceType 'Messaging'
 ```
 If it is sucessful, you will get the connection string in the PowerShell output. If you get connection errors with it and the conection string looks like Endpoint=sb://..., change it to **Endpoint=https://...**
- 
+
 ### Create a Queue
 
 ```PHP
 try {
   $queueInfo = new QueueInfo("myqueue");
-  
+
   // Create queue.
   $serviceBusRestProxy->createQueue($queueInfo);
 } catch(ServiceException $e){
@@ -454,14 +461,14 @@ try {
   // Set the receive mode to PeekLock (default is ReceiveAndDelete).
   $options = new ReceiveMessageOptions();
   $options->setPeekLock(true);
-  
+
   // Receive message.
   $message = $serviceBusRestProxy->receiveQueueMessage("myqueue", $options);
   echo "Body: ".$message->getBody()."<br />";
   echo "MessageID: ".$message->getMessageId()."<br />";
-  
+
   // *** Process message here ***
-  
+
   // Delete message.
   $serviceBusRestProxy->deleteMessage($message);
 } catch(ServiceException $e){
@@ -476,7 +483,7 @@ try {
 ### Create a Topic
 
 ```PHP
-try {   
+try {
   // Create topic.
   $topicInfo = new TopicInfo("mytopic");
   $serviceBusRestProxy->createTopic($topicInfo);
@@ -524,7 +531,7 @@ try {
 
 The primary way to receive messages from a subscription is to use a **ServiceBusRestProxy->receiveSubscriptionMessage** method. Received messages can work in two different modes: **ReceiveAndDelete** (the default) and **PeekLock** similarly to Service Bus Queues.
 
-The example below demonstrates how a message can be received and processed using **ReceiveAndDelete** mode (the default mode). 
+The example below demonstrates how a message can be received and processed using **ReceiveAndDelete** mode (the default mode).
 
 ```PHP
 try {
@@ -533,8 +540,8 @@ try {
   $options->setReceiveAndDelete();
 
   // Get message.
-  $message = $serviceBusRestProxy->receiveSubscriptionMessage("mytopic", 
-                                "mysubscription", 
+  $message = $serviceBusRestProxy->receiveSubscriptionMessage("mytopic",
+                                "mysubscription",
                                 $options);
   echo "Body: ".$message->getBody()."<br />";
   echo "MessageID: ".$message->getMessageId()."<br />";
@@ -549,17 +556,17 @@ try {
 
 ### Set-up certificates
 
-You  need to create two certificates, one for the server (a .cer file) and one for the client (a .pem file). To create the .pem file using [OpenSSL](http://www.openssl.org), execute this: 
+You  need to create two certificates, one for the server (a .cer file) and one for the client (a .pem file). To create the .pem file using [OpenSSL](http://www.openssl.org), execute this:
 
   openssl req -x509 -nodes -days 365 -newkey rsa:1024 -keyout mycert.pem -out mycert.pem
 
-To create the .cer certificate, execute this: 
+To create the .cer certificate, execute this:
 
   openssl x509 -inform pem -in mycert.pem -outform der -out mycert.cer
 
 ### List Available Locations
 
-```PHP  
+```PHP
 $serviceManagementRestProxy->listLocations();
 $locations = $result->getLocations();
 foreach($locations as $location){
@@ -579,11 +586,11 @@ $options->setLocation('West US');
 
 $result = $serviceManagementRestProxy->createStorageService($name, $label, $options);
 ```
-  
-  
+
+
 ### Create a Cloud Service
 
-A cloud service is also known as a hosted service (from earlier versions of Microsoft Azure).  The **createHostedServices** method allows you to create a new hosted service by providing a hosted service name (which must be unique in Microsoft Azure), a label (the base 64-endcoded hosted service name), and a **CreateServiceOptions** object which allows you to set the location *or* the affinity group for your service. 
+A cloud service is also known as a hosted service (from earlier versions of Microsoft Azure).  The **createHostedServices** method allows you to create a new hosted service by providing a hosted service name (which must be unique in Microsoft Azure), a label (the base 64-endcoded hosted service name), and a **CreateServiceOptions** object which allows you to set the location *or* the affinity group for your service.
 
 ```PHP
 $name = "myhostedservice";
@@ -684,11 +691,11 @@ $streamingUrl = $originLocator->getPath() . '[Manifest file name]' . "/manifest"
 
 ###Manage media services entities
 
-Media services CRUD operations are performed through media services rest proxy class. It has methods like “createAsset”, “createLocator”, “createJob” and etc. for entities creations. 
+Media services CRUD operations are performed through media services rest proxy class. It has methods like “createAsset”, “createLocator”, “createJob” and etc. for entities creations.
 
-To retrieve all entities list you may use methods “getAssetList”, “getAccessPolicyList”, “getLocatorList”, “getJobList” and etc. For getting single entity data use methods “getAsset”, “getJob”, “getTask” and etc. passing the entity identifier or entity data model object with non-empty identifier as a parameter. 
+To retrieve all entities list you may use methods “getAssetList”, “getAccessPolicyList”, “getLocatorList”, “getJobList” and etc. For getting single entity data use methods “getAsset”, “getJob”, “getTask” and etc. passing the entity identifier or entity data model object with non-empty identifier as a parameter.
 
-Update entities with methods like “updateLocator”, “updateAsset”, “updateAssetFile” and etc. passing the entity data model object as a parameter. It is important to have valid entity identifier specified in data model object. 
+Update entities with methods like “updateLocator”, “updateAsset”, “updateAssetFile” and etc. passing the entity data model object as a parameter. It is important to have valid entity identifier specified in data model object.
 
 Erase entities with methods like “deleteAsset”, “deleteAccessPolicy”, “deleteJob” and etc. passing the entity identifier or entity data model object with non-empty identifier as a parameter.