yii-aws Follow @yiiframework

Amazon Web Services SDK PHP 2 Wrapper

Yii-AWS

Provides a simple way to configure and use Amazon AWS SDK PHP 2. For more information regarding its services, please go to http://docs.aws.amazon.com/aws-sdk-php-2/latest/namespace-Aws.html.

Before you start ¶

The wrapper is in "alpha" version. Obviously, I couldn't test all the possibilities of Amazon SDK, I have tested just a couple. But being just a wrapper, it should not have any issues whatsoever but those related to the SDK itself.

I published, in order to get good feedback from you guys and again, provide another utility to the Yii framework. If you wish to collaborate, comment, whatever, please, do not hesitate to add your two cents via its github repository. Everybody welcome.

Overview ¶

The main purpose of this extension was to be able to configure the sdk in a very easy way, and then be able to make use of its classes with an easy and configurable import at my main config file.

Install ¶

I assume that if you wish to use this extension, you already have your AWS credentials.

Since schmunk convinced me about composer wonders. From now on, you will be able to install my extensions using composer (https://packagist.org/packages/2amigos/).

Via Composer

Add 2amigos/yii-aws as a dependency in your project's composer.json file.

{
   "require": {
      "2amigos/yii-aws": "dev-master"
   }
}

Download and install Composer.

curl -s "http://getcomposer.org/installer" | php

Install your dependencies.

php composer.phar install

Require Composer's autoloader. Composer also prepares an autoload file that's capable of autoloading all of the classes in any of the libraries that it downloads. To use it, just add the following line to your code's bootstrap process.

require '/path/to/vendor/autoload.php';

You can find out more on how to install Composer, configure autoloading, and other best-practices for defining dependencies at getcomposer.org.

The Old Fashion Way

If you do not work with composer, then simply download or clone from its repository and place it wherever you wish.

After you do that, make sure you "import" on your main.php config file, the classes within the yii-aws/components/* folder.

Configuration

The library has a config folder where you will find a file named "aws-config" to setup the configuration options for the services. For more information about configuring your services, please have a look at http://docs.aws.amazon.com/awssdkdocsphp2/latest/gettingstartedguide/sdk-php2-using-the-sdk.html

note do not forget to add your AWS credentials there :)

How to use it ¶

// This import is better to be included in your main
// config file. For those newbies to the framework, 
// please recall that this is a path alias, you should 
// write exactly where it is
Yii::import('path.to.amazon.components.*');
 
$s3 = new A2S3();
$response = $s3->listBuckets(); // we are going to list the buckets
 
// just for the sake of the example
print_r($response);

Requirements ¶

Fulfill the requirements of the new SDK
aws.phar file (already included)

Resources ¶

web development has never been so fun
www.2amigos.us

Total 5 comments

#13035

kunalroy85 at 2013/04/30 02:53am

Arguments become false

@canreo

current($args) returns false when it is called with an empty array as an argument. Whereas the argument 2 of getCommand expects array. http://php.net/manual/en/function.current.php

What I tried to fix this was adding the below code just above the try block, after calling current()

if($args == false){
                   $args = array();
               }

Though not the best of solutions, it helped me overcome this problem.

#13034

canreo at 2013/04/29 06:50pm

Demo returns error

I'm getting this error when I run sample code:

Argument 2 passed to Guzzle\Service\Client::getCommand() must be of the type array, boolean given, called in \protected\vendors\2amigos\yii-aws\components\A2Base.php on line 80 and defined

Any ideas?

#12987

kunalroy85 at 2013/04/25 06:37am

Using the code gives blank page

Hey All I am trying to use this extension in my web app. Am using AWS for the first time. In this app, when the user saves the form I make a call to the aws to put an object and then redirect the user to some page. Here is the code for putting the object to AWS S3. It appears that just instantiating A2S3 causes this.

$s3 = new A2S3();
 
$result = $s3->putObject(array(
            'Bucket' => 'bartastico',
            'Key'    => $name,
            'Body'   => $text,
            'ACL'    => 'public-read'
        )); 
 
$this->redirect(array('update','id'=>$model->id));//this does not do what I think it should do

I have verified that the object is saved in S3, the form model is saved in the database, it all works, but when I redirect the user to the page, it throws up with no error.

Unable to load the webpage because the server sent no data.

I thought that it might be a problem with phar file, but not really sure. Not using Suhosin as well. Using MAC MAMP server. PHP 5.3.6.

Thanks! Kunal

#12955

Antonio Ramirez at 2013/04/23 07:24am

@venuk

This is a wrapper to the latest library AWS PHP SDK 2 and some of the documentation is not yet completed.

I think that is best to go to the latest as it will replace in the future version one.

#12541

venuk at 2013/03/27 08:21pm

Thank you

Antonio, First of all thanks a lot for the AWS wrapper.

I have developed a website using Yii and found recently about Amazon AWS. So now I am thinking to host with Amazon AWS. Do I need to rewrite the entire code to use AWS(of course with this wrapper)? Can we expect a Wiki article like your other extensions? I am completely new to AWS.. Started reading ... Please can you suggest?

Please login to leave your comment.