Простая система KVP с Amazon S3

 class s3Kvp {

    private $itemName = Null;
    private $awsS3 = Null;

    private $data = Null;                        // We'll store our item data here.
    private $isDirty = false;                    // We'll track whether or not anything changed here.
    private $bucket = 'my-unique-bucket-name';   // This is the "bucket", or domain where your data is stored.

    public function __construct($itemName) {
        $this->itemName = $itemName;
        $this->awsS3 = new AmazonS3();

        // Here we're trying to get an object matching our item name
        // located in the folder 'kvpdata'.
        // Start by Creating a Secure URL to Access Your Data
        $url = $this->awsS3->get_object_url('my-unique-bucket-name', 'kvpdata/'.$this->itemName, '10 Days');

        // Then grab the contents of the URL
        // The @ will allow the script to continue
        // if the URL cannot be reached.
        $responseData = false;
        $responseData = @file_get_contents($url);

        // If we got something back in our response data,
        // load it into the "data" property of this class.
        if ($responseData) {

            // We're going to store our data as an array encoded JSON,
            // so if we get anything we know we can
            // decode it back to an array.
            $responseAsArray = json_decode($responseData, true);

            // Check if the data is valid.
            if (is_array($responseAsArray)) {

                // It's valid! Load it up.
                $this->data = $responseAsArray;

            } else {

                // Not valid! Load an empty array.
                // A good app would do some error handling here.
                $this->data = array();

            }

        } else {

            // If we don't get anything back,
            // it means this item is new so we're just going to
            // load 'data' as an empty array.
            $this->data = array();

        }

    }

}

Перегрузка объекта

Перегрузка в PHP предоставляет средства для динамического «создания» свойств и методов. Это действительно весело, и мы собираемся использовать его для динамического хранения данных элементов.

Мы собираемся создать два новых метода в нашем классе. Один, называемый «__get», позволит нам легко извлекать информацию, хранящуюся в данных нашего предмета. Другой «__set» позволит нам обновлять существующие данные и сохранять новые данные.

Вот как это работает:

Если вы создали новый экземпляр нашего класса s3Kvp с именем $ myKvp и хотите получить доступ к свойству customBackgroundColor (т. Е. $ MyKvp-> customBackgroundColor), вы получите ошибку, потому что это свойство не существует.

Но если мы создадим метод с именем «__get» в нашем классе, PHP запустит эту функцию до получения ошибки. Это позволяет нам динамически получать доступ к данным. То же самое работает с «__set». Если свойство не существует, но вы пытаетесь установить его, будет вызван метод «__set», если он существует.

Вот код:

 class s3Kvp {

    // This function will be called anytime
    // we try to RETRIEVE properties of our class
    // that do not exist.
    public function __get($propertName) {

        // Check to see if we have that property in our
        // data array.
        if (isset($this->data[$propertName])) {

            // If we have it, return it.
            // Simple, right!?
            return $this->data[$propertName];

        } else {

            // If not, return false;
            return false;

        }
    }

    // This function will be called anytime
    // we try to SET properties of our class
    // that do not exist.
    public function __set($propertName, $propertyValue) {

        // Simply set the propertyName submitted
        // in our data array to the value submitted.
        $this->data[$propertName] = $propertyValue;

        // One more thing...
        // We want to know if something is ever "set"
        // so we can mark the data as "dirty".
        // We'll use this later...
        $this->isDirty = true;

    }

    private $itemName = Null;
    private $awsS3 = Null;
    private $data = Null;
    private $isDirty = false;
    private $bucket = 'my-unique-bucket-name';

    public function __construct($itemName) {
        $this->itemName = $itemName;
        $this->awsS3 = new AmazonS3();
        $url = $this->awsS3->get_object_url('my-unique-bucket-name', 'kvpdata/'.$this->itemName, '10 Days');
        $responseData = false;
        $responseData = @file_get_contents($url);
        if ($responseData) {
            $responseAsArray = json_decode($responseData, true);
            if (is_array($responseAsArray)) {
                $this->data = $responseAsArray;

            } else {
                $this->data = array();
            }
        } else {
            $this->data = array();
        }
    }

Спаси этого ребенка

Теперь наш класс начинает обретать форму. Мы можем загрузить данные из S3, и мы можем установить и получить значения данных. Но чего-то все еще не хватает — сохранение данных. Нам нужно отправить его обратно на S3.

Для этого мы будем использовать метод __destruct, встроенный в классы PHP. Этот метод, если он существует, вызывается непосредственно перед тем, как PHP завершает класс. Поэтому, если мы создадим метод, он будет вызываться каждый раз, когда мы используем экземпляр класса, как только PHP узнает, что мы закончили с ним.

В методе __destruct мы собираемся проверить, является ли наш класс isDirty, и если это так, мы сохраним наши изменения до S3. Однако перед сохранением мы собираемся преобразовать наши данные в JSON. Это облегчает хранение и, при необходимости, облегчает доступ к другим системам.

 class s3Kvp {

    // The __destruct is called by PHP as
    // each instance of this class is destroyed.
    public function __destruct() {

        // Check if "isDirty" is true,
        // which tells us that at some point
        // during the script execution
        // data was changed.
        if ($this->isDirty) {

            // Encode our data as JSON.
            $dataToSave = json_encode($this->data);

            // Use "create_object" to upload the data
            // back to S3. If the object already exists,
            // this will simply replace it.
            $options = array('body' => $dataToSave);
            $this->awsS3->create_object('my-unique-bucket-name', 'kvpdata/'.$this->itemName, $options);

        }
    }

    public function __get($propertName) {
        if (isset($this->data[$propertName])) {
            return $this->data[$propertName];
        } else {
            return false;
        }
    }

    public function __set($propertName, $propertyValue) {
        $this->data[$propertName] = $propertyValue;
        $this->isDirty = true;
    }

    private $itemName = Null;
    private $awsS3 = Null;
    private $data = Null;
    private $isDirty = false;
    private $bucket = 'my-unique-bucket-name';

    public function __construct($itemName) {
        $this->itemName = $itemName;
        $this->awsS3 = new AmazonS3();
        $url = $this->awsS3->get_object_url('my-unique-bucket-name', 'kvpdata/'.$this->itemName, '10 Days');
        $responseData = false;
        $responseData = @file_get_contents($url);
        if ($responseData) {
            $responseAsArray = json_decode($responseData, true);
            if (is_array($responseAsArray)) {
                $this->data = $responseAsArray;

            } else {
                $this->data = array();
            }
        } else {
            $this->data = array();
        }
    }

}

Используя класс

Вот последний класс:

 class s3Kvp {

    private $itemName = Null;
    private $awsS3 = Null;
    private $data = Null;
    private $isDirty = false;
    private $bucket = 'my-unique-bucket-name';

    public function __construct($itemName) {
        $this->itemName = $itemName;
        $this->awsS3 = new AmazonS3();
        $url = $this->awsS3->get_object_url('my-unique-bucket-name', 'kvpdata/'.$this->itemName, '10 Days');
        $responseData = false;
        $responseData = @file_get_contents($url);
        if ($responseData) {
            $responseAsArray = json_decode($responseData, true);
            if (is_array($responseAsArray)) {
                $this->data = $responseAsArray;

            } else {
                $this->data = array();
            }
        } else {
            $this->data = array();
        }
    }

    public function __get($propertName) {
        if (isset($this->data[$propertName])) {
            return $this->data[$propertName];
        } else {
            return false;
        }
    }

    public function __set($propertName, $propertyValue) {
        $this->data[$propertName] = $propertyValue;
        $this->isDirty = true;
    }

    public function __destruct() {
        if ($this->isDirty) {
            $dataToSave = json_encode($this->data);
            $options = array('body' => $dataToSave);
            $this->awsS3->create_object('my-unique-bucket-name', 'kvpdata/'.$this->itemName, $options);

        }
    }

}

Конечно, теперь, когда мы сделали всю работу, мы хотим использовать эту вещь! Вот пара примеров:

 // Include the class we just created.
require_once 's3kvp.php';

// Create an instance of s4Kvp
// using the current User's ID;
$userId = 12301; //This might be stored in cookie or session variable.
$userKvp = new s3Kvp('user'.$userId);

// In this example,
// We're setting the "prefsItemsPerPage"
// equal to whatever we received in the
// "prefsItemsPerPage" querystring variable;
$submittedPreference = $_GET['prefsItemsPerPage'];
$userKvp->prefsItemsPerPage = $submittedPreference;
echo 'test';

 // Include the class we just created.
require_once 's3kvp.php';

$userId = 12301;
$userKvp = new s3Kvp('user'.$userId);

echo $userKvp->prefsItemsPerPage;