Category: Uncategorized

Few days ago I wanted to write a small PHP script to backup (upload) some files in Amazon S3. And because Amazon just released last month a new version of their SDK, AWS SDK for PHP 2 I decided to use this one.
I also choose to use Console component from Symfony2 and Composer to install all the dependencies.

In the root folder of my project I downloaded and installed composer, like this:

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

In composer.json file I added this dependencies:

{
  "require": {
      "aws/aws-sdk-php": "*",
      "monolog/monolog": "1.0.*",
      "symfony/class-loader": "2.1.3",
      "symfony/console": "2.1.3",
      "symfony/yaml": "2.1.3",
      "doctrine/common": "2.3.0",
      "symfony/finder": "2.1.4"
  },
  "autoload": {
      "psr-0": {
          "Razvan": "src/"
      }
  }
}

and after this I ran:

php composer.phar install

After runing this command, you will see in the project folder, a directory called vendor where are installed all the dependencies.

After that I created on the same level with vendor a folder called src and inside this one another folder called Razvan.

mkdir -p src/Razvan

inside the Razvan folder I put my BackupCommand.php

Below is a part of the code:

<?php
 
namespace Razvan;
 
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Input\InputOption;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Yaml\Yaml;
use Symfony\Component\Finder\Finder;
 
use Aws\S3\S3Client;
use Aws\S3\Enum\CannedAcl;
use Aws\S3\Exception\S3Exception;
 
/**
 * BackupCommand
 * eg: usage for upload:
 * php sync.php s3 /path/to/folder/ upload --relative
 *
 * @author razvan tudorica
 */
class BackupCommand extends Command
{
 
  private $s3;
 
  protected function configure()
  {
    //... get the configuration for s3
 
    $this
      ->setName('s3')
      ->setDescription('Syncronize Amazon S3 folder with the local folder')
      ->addArgument('localFolder', InputArgument::REQUIRED, 'Local folder FULL path')
      ->addArgument('action', InputArgument::REQUIRED, 'upload (or download)')
      ->addArgument('bucket', InputArgument::OPTIONAL, 'The bucket name', $this->bucket)
      ->addArgument('s3Folder', InputArgument::OPTIONAL, 'Remote S3 folder path')
      ->addOption('relative', null, InputOption::VALUE_NONE, 'If set, we will use relative path in the bucket')
      ;
 
    $conf = array(
        'key'=>'YOURKEY',
        'secret' => 'YOURSECRET',
        'region' => 'us-east-1' //or your bucket's region
    );
    $this->s3 = S3Client::factory($conf);
  }
 
  protected function execute(InputInterface $input, OutputInterface $output)
  {
    $action = $input->getArgument('action');
    $localFolder = $this->input->getArgument('localFolder');
    $bucket = $this->input->getArgument('bucket');
 
    //check if input the parameters are correct
    //...
 
    $finder = new Finder();
    $finder->files()->in($localFolder);
    $finder->files()->followLinks();
 
    foreach ($finder as $file)
    {
      //some extra logic for setting the key
      //...
      $key = $startFolder . DIRECTORY_SEPARATOR . $file->getRelativePathname();
 
      $this->output->writeln($key);
 
      try
      {
        $this->s3->putObject(array(
            'Bucket' => $bucket,
            'Key'    => $key,
            'Body'   => fopen($file->getRealpath(), 'r'),
            'ACL'    => CannedAcl::PUBLIC_READ
        ));
      }
      catch (S3Exception $e)
      {
        $this->output->writeln("The file was not uploaded: " . $e->getMessage());
      }
 
    }
 
  }

And now we have to call this command. For this, in the root folder of the project I created another small script called backup.php with this content:

#!/usr/bin/env php
<?php
 
require_once __DIR__.'/vendor/autoload.php';
 
use Razvan\BackupCommand;
use Symfony\Component\Console\Application;
 
$command = new BackupCommand();
 
$application = new Application();
 
$application->add($command);
$application->run();

Now, we can run it from the console, with:

php sync.php s3 /home/razvan/mypictures

Based on this skeleton, I’m working for a more complex syncronization script between Amazon S3 and a local folder. You can find the code on GitHub.

Disclaimer:

It is possible the tutorial above to not be very complete and accurate.

The code it’s not optimized at all (eg: if you have a big amount of files or very big files).