[1.0.0] Первый коммит

Author: vjik

.gitignore

@@ -0,0 +1,5 @@
+# PhpStorm project files
+.idea
+
+# Composer vendor dir
+/vendor

Enum.php

@@ -0,0 +1,204 @@
+<?php
+
+namespace vjik\enum;
+
+/**
+ * Abstract Enum class
+ *
+ * @property mixed $value
+ * @property mixed $name
+ */
+abstract class Enum
+{
+
+
+    /**
+     * @var array
+     */
+    protected static $_cache = [];
+
+
+    /**
+     * @var mixed
+     */
+    protected $value;
+
+
+    /**
+     * @var string
+     */
+    protected $name;
+
+
+    /**
+     * @param mixed $value
+     *
+     * @throws \UnexpectedValueException
+     */
+    public function __construct($value)
+    {
+        if (!static::isValid($value)) {
+            throw new \UnexpectedValueException("Value '$value' is not part of the enum " . get_called_class());
+        }
+        foreach (static::toArray()[$value] as $k => $v) {
+            $this->$k = $v;
+        }
+    }
+
+
+    /**
+     * Проверяет входит ли значение в допустимые
+     *
+     * @param $value
+     * @param $filter
+     *
+     * @return bool
+     */
+    public static function isValid($value, $filter = [])
+    {
+        return in_array($value, static::toValues($filter), true);
+    }
+
+
+    /**
+     * Все доступные значения в виде массива с данными
+     *
+     * @param array $filter ['key' => 'value', ['operator', 'key', 'value'], …]
+     *
+     * @return array enum-значение - ключ, массив с данными - значение
+     */
+    public static function toArray($filter = [])
+    {
+        $class = get_called_class();
+        if (!array_key_exists($class, static::$_cache)) {
+            if (is_callable([$class, 'items'])) {
+                /** @noinspection PhpUndefinedMethodInspection */
+                $items = $class::items();
+            } else {
+                $items = [];
+                $reflection = new \ReflectionClass($class);
+                foreach ($reflection->getConstants() as $constant) {
+                    $items[$constant] = $constant;
+                }
+            }
+            array_walk($items, function (&$item, $value) {
+                $item = is_array($item) ? $item : ['name' => $item];
+                if (!isset($item['name'])) {
+                    $item['name'] = $value;
+                }
+                $item['value'] = $value;
+            });
+            static::$_cache[$class] = $items;
+        }
+        $items = array_filter(static::$_cache[$class], function ($item) use ($filter) {
+            foreach ($filter as $key => $value) {
+                if (is_int($key)) {
+                    $operator = $value[0];
+                    $key = $value[1];
+                    $value = $value[2];
+                    switch ($operator) {
+                        case '=':
+                            if ($item[$key] != $value) {
+                                return false;
+                            }
+                            break;
+
+                        case '!=':
+                            if ($item[$key] == $value) {
+                                return false;
+                            }
+                            break;
+
+                        case '>':
+                            if ($item[$key] <= $value) {
+                                return false;
+                            }
+                            break;
+
+                        case '<':
+                            if ($item[$key] >= $value) {
+                                return false;
+                            }
+                            break;
+
+                        case '>=':
+                            if ($item[$key] < $value) {
+                                return false;
+                            }
+                            break;
+
+                        case '<=':
+                            if ($item[$key] > $value) {
+                                return false;
+                            }
+                            break;
+                    }
+                } else {
+                    if ($item[$key] != $value) {
+                        return false;
+                    }
+                }
+            }
+            return true;
+        });
+        return $items;
+    }
+
+
+    /**
+     * Все доступные значения в виде массива
+     *
+     * @param array $filter
+     *
+     * @return array
+     */
+    public static function toValues($filter = [])
+    {
+        return array_keys(static::toArray($filter));
+    }
+
+
+    /**
+     * Все доступные значение с именами
+     *
+     * @param array $filter
+     *
+     * @return array enum-значение - ключ, имя - значение
+     */
+    public static function toList($filter = [])
+    {
+        $list = [];
+        foreach (static::toArray($filter) as $id => $data) {
+            $list[$id] = $data['name'];
+        }
+        return $list;
+    }
+
+
+    /**
+     * @param $name
+     *
+     * @return mixed
+     *
+     * @throws \LogicException
+     */
+    public function __get($name)
+    {
+        $getter = 'get' . $name;
+        if (method_exists($this, $getter)) {
+            return $this->$getter();
+        } elseif (property_exists($this, $name)) {
+            return $this->{$name};
+        }
+        throw new \LogicException('Getting unknown property: ' . get_class($this) . '::' . $name);
+    }
+
+
+    /**
+     * @return string
+     */
+    public function __toString()
+    {
+        return (string)$this->value;
+    }
+}

LICENSE.md

@@ -0,0 +1,15 @@
+The MIT License (MIT)
+Copyright (c) 2017 Sergey Predvoditelev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and
+to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of
+the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
+OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
+OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.