adminer

README.md

@@ -1,2 +1,52 @@
 # adminer
 
+Správa databází.
+
+Zdroj: https://www.adminer.org/
+
+## Poznámka
+
+- Pro potřeby tohoto návodu bude pracovním adresářem `C:\devel`. Adresář může být samozřejmě libovolný.
+- Instalace PHP je v adresáři `C:\php\php.exe`
+
+## Spuštění
+
+Naklonujte si repozitář
+
+```shell
+cd C:\devel
+git clone http://git.asgard.odbornaskola.cz/mist/adminer.git
+```
+
+a následně spusťte
+
+```shell
+cd adminer
+C:\php\php.exe -S localhost:9090
+```
+
+V prohlížeči pak bude adminer dostupný pod URL:
+
+```
+http://localhost:9090/
+```
+
+## Připojení k databázi
+
+- Vyberte _Systém_ **SQLite 3**
+- Zadejte `heslo`. Hodnota pro heslo je vidět v souboru [index.php](./index.php) na 8. řádku (a ano nemá tam co dělat :shame:).
+- Jako cestu k databázi je třeba zadat cestu k souboru, kde se databáze nachází.
+
+![Přihlášení](./docs/login.png)
+
+Výsledek bude
+
+![Prázdná databáze](./docs/db-empty.png)
+
+### Nesprávná databáze
+
+Pokud se zobrazí chybová zpráva ohledně nesprávné databáze, znamená to, že soubor neexistuje.
+
+![Prázdná databáze](./docs/db-error.png)
+
+Jako opravu stačí vytvořit ručně prázdný soubor.

index.php

@@ -0,0 +1,12 @@
+<?php
+
+function adminer_object() {
+	include_once "./plugins/plugin.php";
+	include_once "./plugins/login-password-less.php";
+	return new AdminerPlugin(array(
+		// TODO: inline the result of password_hash() so that the password is not visible in source codes
+		new AdminerLoginPasswordLess(password_hash("heslo", PASSWORD_DEFAULT)),
+	));
+}
+
+include "./adminer.php";

plugins/login-password-less.php

@@ -0,0 +1,31 @@
+<?php
+
+/** Enable login for password-less database
+* @link https://www.adminer.org/plugins/#use
+* @author Jakub Vrana, https://www.vrana.cz/
+* @license https://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
+* @license https://www.gnu.org/licenses/gpl-2.0.html GNU General Public License, version 2 (one or other)
+*/
+class AdminerLoginPasswordLess {
+	/** @access protected */
+	var $password_hash;
+
+	/** Set allowed password
+	* @param string result of password_hash
+	*/
+	function __construct($password_hash) {
+		$this->password_hash = $password_hash;
+	}
+
+	function credentials() {
+		$password = get_password();
+		return array(SERVER, $_GET["username"], (password_verify($password, $this->password_hash) ? "" : $password));
+	}
+
+	function login($login, $password) {
+		if ($password != "") {
+			return true;
+		}
+	}
+
+}

plugins/plugin.php

@@ -0,0 +1,408 @@
+<?php
+
+/** Adminer customization allowing usage of plugins
+* @link https://www.adminer.org/plugins/#use
+* @author Jakub Vrana, https://www.vrana.cz/
+* @license https://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
+* @license https://www.gnu.org/licenses/gpl-2.0.html GNU General Public License, version 2 (one or other)
+*/
+class AdminerPlugin extends Adminer {
+	/** @access protected */
+	var $plugins;
+
+	function _findRootClass($class) { // is_subclass_of(string, string) is available since PHP 5.0.3
+		do {
+			$return = $class;
+		} while ($class = get_parent_class($class));
+		return $return;
+	}
+
+	/** Register plugins
+	* @param array object instances or null to register all classes starting by 'Adminer'
+	*/
+	function __construct($plugins) {
+		if ($plugins === null) {
+			$plugins = array();
+			foreach (get_declared_classes() as $class) {
+				if (preg_match('~^Adminer.~i', $class) && strcasecmp($this->_findRootClass($class), 'Adminer')) { //! can use interface
+					$plugins[$class] = new $class;
+				}
+			}
+		}
+		$this->plugins = $plugins;
+		//! it is possible to use ReflectionObject to find out which plugins defines which methods at once
+	}
+
+	function _callParent($function, $args) {
+		return call_user_func_array(array('parent', $function), $args);
+	}
+
+	function _applyPlugin($function, $args) {
+		foreach ($this->plugins as $plugin) {
+			if (method_exists($plugin, $function)) {
+				switch (count($args)) { // call_user_func_array() doesn't work well with references
+					case 0: $return = $plugin->$function(); break;
+					case 1: $return = $plugin->$function($args[0]); break;
+					case 2: $return = $plugin->$function($args[0], $args[1]); break;
+					case 3: $return = $plugin->$function($args[0], $args[1], $args[2]); break;
+					case 4: $return = $plugin->$function($args[0], $args[1], $args[2], $args[3]); break;
+					case 5: $return = $plugin->$function($args[0], $args[1], $args[2], $args[3], $args[4]); break;
+					case 6: $return = $plugin->$function($args[0], $args[1], $args[2], $args[3], $args[4], $args[5]); break;
+					default: trigger_error('Too many parameters.', E_USER_WARNING);
+				}
+				if ($return !== null) {
+					return $return;
+				}
+			}
+		}
+		return $this->_callParent($function, $args);
+	}
+
+	function _appendPlugin($function, $args) {
+		$return = $this->_callParent($function, $args);
+		foreach ($this->plugins as $plugin) {
+			if (method_exists($plugin, $function)) {
+				$value = call_user_func_array(array($plugin, $function), $args);
+				if ($value) {
+					$return += $value;
+				}
+			}
+		}
+		return $return;
+	}
+
+	// appendPlugin
+
+	function dumpFormat() {
+		$args = func_get_args();
+		return $this->_appendPlugin(__FUNCTION__, $args);
+	}
+
+	function dumpOutput() {
+		$args = func_get_args();
+		return $this->_appendPlugin(__FUNCTION__, $args);
+	}
+
+	function editRowPrint($table, $fields, $row, $update) {
+		$args = func_get_args();
+		return $this->_appendPlugin(__FUNCTION__, $args);
+	}
+
+	function editFunctions($field) {
+		$args = func_get_args();
+		return $this->_appendPlugin(__FUNCTION__, $args);
+	}
+
+	// applyPlugin
+
+	function name() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function credentials() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function connectSsl() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function permanentLogin($create = false) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function bruteForceKey() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function serverName($server) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function database() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function schemas() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function databases($flush = true) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function queryTimeout() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function headers() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function csp() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function head() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function css() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function loginForm() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function loginFormField($name, $heading, $value) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function login($login, $password) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function tableName($tableStatus) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function fieldName($field, $order = 0) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectLinks($tableStatus, $set = "") {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function foreignKeys($table) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function backwardKeys($table, $tableName) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function backwardKeysPrint($backwardKeys, $row) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectQuery($query, $start, $failed = false) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function sqlCommandQuery($query) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function rowDescription($table) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function rowDescriptions($rows, $foreignKeys) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectLink($val, $field) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectVal($val, $link, $field, $original) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function editVal($val, $field) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function tableStructurePrint($fields) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function tableIndexesPrint($indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectColumnsPrint($select, $columns) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectSearchPrint($where, $columns, $indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectOrderPrint($order, $columns, $indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectLimitPrint($limit) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectLengthPrint($text_length) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectActionPrint($indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectCommandPrint() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectImportPrint() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectEmailPrint($emailFields, $columns) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectColumnsProcess($columns, $indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectSearchProcess($fields, $indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectOrderProcess($fields, $indexes) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectLimitProcess() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectLengthProcess() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectEmailProcess($where, $foreignKeys) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function selectQueryBuild($select, $where, $group, $order, $limit, $page) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function messageQuery($query, $time, $failed = false) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function editInput($table, $field, $attrs, $value) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function editHint($table, $field, $value) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function processInput($field, $value, $function = "") {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function dumpDatabase($db) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function dumpTable($table, $style, $is_view = 0) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function dumpData($table, $style, $query) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function dumpFilename($identifier) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function dumpHeaders($identifier, $multi_table = false) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function importServerPath() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function homepage() {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function navigation($missing) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function databasesPrint($missing) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+	function tablesPrint($tables) {
+		$args = func_get_args();
+		return $this->_applyPlugin(__FUNCTION__, $args);
+	}
+
+}