Merge pull request #42 from katmsft/dev

0.11.0 release

Author: vinjiang

ChangeLog.md

@@ -1,7 +1,33 @@
-2016.09 - version 0.10.3
+2016.11 - version 0.11.0
 
 ALL
-* Fix error string when an error occurs while parsing a connection string and is passed to _createException in ConnectionStringParser.
+* Fix error string when an error occurs while parsing a connection string and is passed to _createException in `MicrosoftAzure\Storage\Common\Internal\ConnectionStringParser`.
+* Added support to create Guzzle's customizable retry middleware to handle the request after the response is received. Also added a default retry policy in case a retry policy is not specified.
+* Fixed a bug in unit test where getting properties from service failed to match the expected result due to previous settings have not yet taken effect.
+* Fixed some coding style issue. This work will be continued in the following serveral releases, and strictly follows PSR-2 coding style.
+* Updated the documentation of `setMetadata`, now in the comments of the following methods `$metadata` is an array instead of a string.
+```
+MicrosoftAzure\Storage\Blob\Models\Blob.setMetadata
+MicrosoftAzure\Storage\Blob\Models\CommitBlobBlocksOptions.setMetadata
+MicrosoftAzure\Storage\Blob\Models\GetContainerPropertiesResult.setMetadata
+MicrosoftAzure\Storage\Blob\Models\GetBlobResult.setMetadata
+MicrosoftAzure\Storage\Blob\Models\GetBlobPropertiesResult.setMetadata
+MicrosoftAzure\Storage\Blob\Models\GetBlobMetadataResult.setMetadata
+MicrosoftAzure\Storage\Blob\Models\CreateContainerOptions.setMetadata
+MicrosoftAzure\Storage\Blob\Models\CreateBlobSnapshotOptions.setMetadata
+MicrosoftAzure\Storage\Blob\Models\CreateBlobOptions.setMetadata
+MicrosoftAzure\Storage\Blob\Models\CopyBlobOptions.setMetadata
+MicrosoftAzure\Storage\Blob\Models\Container.setMetadata
+MicrosoftAzure\Storage\Queue\Models\CreateQueueOptions.setMetadata
+MicrosoftAzure\Storage\Queue\Models\GetQueueMetadataResult.setMetadata
+MicrosoftAzure\Storage\Queue\Models\Queue.setMetadata
+```
+* Removed test code from composer package.
+
+Blob
+* Added support for user to upload large files with minimum memory usage.
+* Added concurrent upload for Block Blob.
+* Added `MicrosoftAzure\Storage\Blob.saveBlobToFile` for user to download a blob into a file.
 
 2016.08 - version 0.10.2
 

README.md

@@ -25,7 +25,14 @@ This project provides a set of PHP client libraries that make it easy to access
 
 * PHP 5.5 or above
 * See [composer.json](composer.json) for dependencies
-
+* Required extension for PHP:
+  php_fileinfo.dll
+  php_mbstring.dll
+  php_openssl.dll
+  php_xsl.dll
+
+* Recommanded extension for PHP:
+  php_curl.dll
 
 ## Download Source Code
 

build.xml

@@ -31,6 +31,10 @@
          depends="prepare,static-analysis,phpunit,phpdox,-check-failure"
          description="Performs static analysis, runs the tests, and generates project documentation"/>
 
+<target name="full-build-large-scale"
+         depends="prepare,static-analysis,phpunit-large-scale,phpdox,-check-failure"
+         description="Performs static analysis, runs the tests (including large scale tests), and generates project documentation"/>
+
  <target name="full-build-parallel"
          depends="prepare,static-analysis-parallel,phpunit,phpdox,-check-failure"
          description="Performs static analysis (executing the tools in parallel), runs the tests, and generates project documentation"/>
@@ -229,6 +233,19 @@
          unless="phpunit.done"
          depends="prepare"
          description="Run unit tests with PHPUnit">
+  <exec executable="${phpunit}" resultproperty="result.phpunit" taskname="phpunit">
+   <arg value="--configuration"/>
+   <arg path="${basedir}/phpunit.xml.dist"/>
+   <arg value="--exclude-group=large-scale"/>
+  </exec>
+  
+  <property name="phpunit.done" value="true"/>
+ </target>
+
+  <target name="phpunit-large-scale"
+         unless="phpunit.done"
+         depends="prepare"
+         description="Run unit tests with PHPUnit, including the large-scale tests">
   <exec executable="${phpunit}" resultproperty="result.phpunit" taskname="phpunit">
    <arg value="--configuration"/>
    <arg path="${basedir}/phpunit.xml.dist"/>
@@ -244,6 +261,7 @@
   <exec executable="${phpunit}" failonerror="true" taskname="phpunit">
    <arg value="--configuration"/>
    <arg path="${basedir}/phpunit.xml.dist"/>
+   <arg value="--exclude-group=large-scale"/>
    <arg value="--no-coverage"/>
   </exec>
 
@@ -257,6 +275,7 @@
   <exec executable="${phpunit}" resultproperty="result-ft.phpunit" taskname="phpunit">
    <arg value="--configuration"/>
    <arg path="${basedir}/phpunit.functional.xml.dist"/>
+   <arg value="--exclude-group=large-scale"/>
   </exec>
 
   <property name="phpunit-ft.done" value="true"/>

composer.json

@@ -32,6 +32,9 @@
     	"psr-4": {
     	    "MicrosoftAzure\\Storage\\Tests\\": "tests/"
     	}
+    },
+    "archive": {
+        "exclude": ["/tests"]
     },
 	"extra": {
 	    "branch-alias": {

samples/BlobSamples.php

@@ -36,7 +36,7 @@
 createContainerSample($blobClient);
 
 // To upload a file as a blob, use the BlobRestProxy->createBlockBlob method. This operation will
-// create the blob if it doesn¡¯t exist, or overwrite it if it does. The code example below assumes 
+// create the blob if it doesn't exist, or overwrite it if it does. The code example below assumes 
 // that the container has already been created and uses fopen to open the file as a stream.
 uploadBlobSample($blobClient);
 
@@ -68,7 +68,7 @@ function createContainerSample($blobClient)
     try {
         // Create container.
         $blobClient->createContainer("mycontainer", $createContainerOptions);
-    } catch(ServiceException $e){
+    } catch (ServiceException $e) {
         $code = $e->getCode();
         $error_message = $e->getMessage();
         echo $code.": ".$error_message.PHP_EOL;
@@ -83,7 +83,7 @@ function uploadBlobSample($blobClient)
     try {
         //Upload blob
         $blobClient->createBlockBlob("mycontainer", $blob_name, $content);
-    } catch(ServiceException $e){
+    } catch (ServiceException $e) {
         $code = $e->getCode();
         $error_message = $e->getMessage();
         echo $code.": ".$error_message.PHP_EOL;
@@ -110,11 +110,10 @@ function listBlobsSample($blobClient)
         $blob_list = $blobClient->listBlobs("mycontainer");
         $blobs = $blob_list->getBlobs();
 
-        foreach($blobs as $blob)
-        {
+        foreach ($blobs as $blob) {
             echo $blob->getName().": ".$blob->getUrl().PHP_EOL;
         }
-    } catch(ServiceException $e){
+    } catch (ServiceException $e) {
         $code = $e->getCode();
         $error_message = $e->getMessage();
         echo $code.": ".$error_message.PHP_EOL;