efureev/laravel-files

<?php
 
namespace Feugene\Files\Entities;
 
 
use Illuminate\Contracts\Support\Arrayable;
use Php\Support\Exceptions\InvalidParamException;
use Php\Support\Exceptions\UnknownPropertyException;
use Php\Support\Helpers\Json;
use Php\Support\Interfaces\Jsonable;
 
/**
 * Class FileParams
 *
 * @package Feugene\Files\Entities
 */
class FileParams implements
    \ArrayAccess,
    \IteratorAggregate,
    \JsonSerializable,
    \Countable,
    Arrayable,
    Jsonable
{
    /** @var array */
    protected $_items = [];
 
 
    /**
     * Params constructor.
     *
     * @param array|null $array
     */
    public function __construct(?array $array = [])
    {
        $this->init();
        $this->fromArray($array ?? []);
    }
 
    /**
     * Initialization component
     */
    public function init()
    {
    }
 
    /**
     * @return array
     */
    public function jsonSerialize(): array
    {
        return array_map(function ($value) {
            if ($value instanceof \JsonSerializable) {
                return $value->jsonSerialize();
            } elseif ($value instanceof Jsonable) {
                return Json::decode($value->toJson(), true);
            } elseif ($value instanceof Arrayable) {
                return $value->toArray();
            }
 
            return $value;
        }, $this->_items);
    }
 
    /**
     * Get items as JSON
     *
     * @param int $options
     *
     * @return string|null
     */
    public function toJson($options = 320): ?string
    {
        return Json::encode($this->jsonSerialize(), $options);
    }
 
    /**
     * @param string $string
     *
     * @return \Php\Support\Interfaces\Jsonable|\Php\Support\Components\Params
     */
    public static function fromJson(string $string): ?Jsonable
    {
        return new static(Json::decode($string));
    }
 
    /**
     * Convert items to its string representation.
     *
     * @return string
     */
    public function __toString()
    {
        return $this->toJson() ?? '[]';
    }
 
 
    /**
     * @return array
     */
    public function toArray(): array
    {
        return Json::dataToArray($this->_items);
    }
 
    /**
     * @param array $array
     *
     * @return $this
     */
    public function fromArray(array $array)
    {
        $this->_items = $array;
 
        return $this;
    }
 
    /**
     * Clear elements
     *
     * @return $this
     */
    public function clear()
    {
        $this->_items = [];
 
        return $this;
    }
 
    /**
     * @return int
     */
    public function count(): int
    {
        return count($this->_items);
    }
 
    /**
     * Checks if the given key or index exists in the array
     *
     * @param mixed $offset
     *
     * @return bool
     */
    public function offsetExists($offset): bool
    {
        return array_key_exists($offset, $this->_items);
    }
 
    /**
     * Offset to retrieve
     *
     * @param mixed $offset
     *
     * @return mixed
     */
    public function offsetGet($offset)
    {
        return $this->_items[ $offset ];
    }
 
    /**
     * Offset to set
     *
     * @param mixed $offset The offset to assign the value to.
     * @param mixed $value  The value to set.
     */
    public function offsetSet($offset, $value)
    {
        if ($offset === null) {
            throw new InvalidParamException('$offset must have not be null');
        } else {
            $this->_items[ $offset ] = $value;
        }
    }
 
    /**
     * Offset to unset
     *
     * @param mixed $offset The offset to unset.
     */
    public function offsetUnset($offset)
    {
        unset($this->_items[ $offset ]);
    }
 
    /**
     * @return \ArrayIterator|\Traversable
     */
    public function getIterator()
    {
        return new \ArrayIterator($this->_items);
    }
 
    /**
     * @param string $name
     *
     * @return mixed
     * @throws \Php\Support\Exceptions\UnknownPropertyException
     */
    public function __get(string $name)
    {
        if ($this->offsetExists($name)) {
            return $this->offsetGet($name);
        }
 
        throw new UnknownPropertyException('Getting unknown property: ' . get_class($this) . '::' . $name, $name);
    }
 
    /**
     * @param string $name
     *
     * @return bool
     */
    public function __isset(string $name)
    {
        return $this->offsetExists($name);
    }
 
    /**
     * @param string $name
     * @param mixed  $value
     */
    public function __set(string $name, $value)
    {
        $this->offsetSet($name, $value);
    }
 
    /**
     * @param string $name
     */
    public function __unset(string $name)
    {
        if ($this->offsetExists($name)) {
            $this->offsetUnset($name);
        }
    }
}