First release

Author: Jean-François Hivert

README.md

@@ -0,0 +1,26 @@
+# PHP-CLI SHELL
+
+This repository is the base of PHP Shell project. It contains base classes for create a PHP Shell.
+You must have a service which has an API and develop classes to use PHP-CLI Shell and your API.  
+  
+There is two project which use PHP-CLI Shell:
+- PHPIPAM: https://github.com/cloudwatt/php-cli-shell_phpipam
+- PATCHMANAGER: https://github.com/cloudwatt/php-cli-shell_patchmanager
+
+PHPIPAM is an IPAM in PHP with REST API: https://phpipam.net/
+PATCHMANAGER is an DCIM in JAVA with SOAP and REST API: https://patchmanager.com/
+
+You can use one of this two projects for help you to develop your own project.
+
+
+# INSTALLATION
+
+#### APT PHP
+__*https://launchpad.net/~ondrej/+archive/ubuntu/php*__
+* add-apt-repository ppa:ondrej/php
+* apt-get update
+* apt install php7.1-cli php7.1-mbstring php7.1-readline
+
+#### REPOSITORY TOOLS-CLI
+* git clone https://github.com/cloudwatt/php-cli-shell_base
+* git checkout ????

classes/arrayObject.php

@@ -0,0 +1,95 @@
+<?php
+	class MyArrayObject implements IteratorAggregate, ArrayAccess, Countable
+	{
+		protected $_array;
+
+		public function __construct($input = array())
+		{
+			$this->_array = (array) $input;
+		}
+
+		public function merge(array $input)
+		{
+			// /!\ On ecrase les anciennes valeurs avec les nouvelles pour permettre l'override
+			$this->_array = array_merge($this->_array, $input);
+			return $this;
+		}
+
+		public function merge_recursive(array $input)
+		{
+			// /!\ On ecrase les anciennes valeurs avec les nouvelles pour permettre l'override
+			$this->_array = array_merge_recursive($this->_array, $input);
+			return $this;
+		}
+
+		public function key_exists($key)
+		{
+			return array_key_exists($key, $this->_array);
+		}
+
+		public function getIterator()
+		{
+			return new ArrayIterator($this->_array);
+		}
+
+		public function offsetSet($offset, $value)
+		{
+			if(is_null($offset)) {
+				$this->_array[] = $value;
+			} else {
+				$this->_array[$offset] = $value;
+			}
+		}
+
+		public function offsetExists($offset)
+		{
+			return isset($this->_array[$offset]);
+		}
+
+		public function offsetUnset($offset)
+		{
+			unset($this->_array[$offset]);
+		}
+
+		public function offsetGet($offset)
+		{
+			if($this->offsetExists($offset)) {
+				return $this->{$offset};
+			}
+			else {
+				return null;
+			}
+		}
+
+		public function count()
+		{
+			return count($this->_array);
+		}
+
+		public function __isset($name)
+		{
+			return isset($this->_array[$name]);
+		}
+
+		public function __unset($name)
+		{
+			unset($this->_array[$name]);
+		}
+
+		public function __get($name)
+		{
+			if(array_key_exists($name, $this->_array))
+			{
+				if(is_array($this->_array[$name])) {
+					$className = static::class;
+					return new $className($this->_array[$name]);
+				}
+				else {
+					return $this->_array[$name];
+				}
+			}
+			else {
+				throw new Exception("This attribute ".$name." does not exist", E_USER_ERROR);
+			}
+		}
+	}

classes/config.php

@@ -0,0 +1,77 @@
+<?php
+	include_once(__DIR__ . '/arrayObject.php');
+
+	class CONFIG implements IteratorAggregate
+	{
+		private static $_instance;
+
+		private $_filename;
+		private $_configuration;
+
+		private $_position = 0;
+
+
+		private function __construct($filename)
+		{
+			$this->_filename = array();
+			$this->_configuration = new MyArrayObject();
+
+			$status = $this->_readConfig($filename);
+
+			if(!$status) {
+				throw new Exception("Config file does not exist or is not readable", E_USER_ERROR);
+			}
+		}
+
+		private function _readConfig($filename)
+		{
+			if(file_exists($filename) && is_readable($filename))
+			{
+				if(!in_array($filename, $this->_filename, true))
+				{
+					$this->_filename[] = $filename;
+					$json = file_get_contents($filename);
+					$configuration = json_decode($json, true);
+					$this->_configuration->merge_recursive($configuration);
+				}
+
+				return true;
+			}
+			else {
+				return false;
+			}
+		}
+
+		public static function getInstance($filename = null)
+		{
+			if(self::$_instance === null)
+			{
+				if($filename !== null) {
+					self::$_instance = new self($filename);
+				}
+				else {
+					throw new Exception("Config filename argument is null", E_USER_ERROR);
+				}
+			}
+			else {
+				self::$_instance->_readConfig($filename);
+			}
+
+			return self::$_instance;
+		}
+
+		public function getIterator()
+		{
+			return $this->_configuration->getIterator();
+		}
+
+		public function __get($name)
+		{
+			if($this->_configuration->key_exists($name)) {
+				return $this->_configuration[$name];
+			}
+			else {
+				throw new Exception("Configuration ".$name." does not exist", E_USER_ERROR);
+			}
+		}
+	}

classes/thread.php

@@ -0,0 +1,41 @@
+<?php
+	class MyThread extends Thread
+	{
+		protected $_object;
+		protected $_method;
+		protected $_arguments;
+
+		protected $_result;
+
+
+		public function __construct(Threaded $object, $method, array $arguments)
+		{
+			$this->_object = $object;
+			$this->_method = $method;
+			$this->_arguments = $arguments;
+		}
+
+		protected function _getId()
+		{
+			return (string) $this->getThreadId();
+		}
+
+		public function run()
+		{
+			$this->_result[$this->_getId()] = call_user_func_array(array($this->_object, $this->_method), $this->_arguments);
+		}
+
+		public function getResult()
+		{
+			return $this->_result[$this->_getId()];
+		}
+
+		public function __get($name)
+		{
+			if($name === 'result') {
+				return $this->getResult();
+			}
+
+			throw new Exception("This attribute does not exist", E_USER_ERROR);
+		}
+	}