/** Get database collation
* @param string
- * @param list<string>[] result of collations()
+ * @param string[][] result of collations()
* @return string
*/
function db_collation($db, $collations) {
}
/** Get sorted grouped list of collations
- * @return list<string>[]
+ * @return string[][]
*/
function collations() {
$return = array();
/** Create database
* @param string
* @param string
- * @return string
+ * @return Result
*/
function create_database($db, $collation) {
return queries("CREATE DATABASE " . idf_escape($db) . ($collation ? " COLLATE " . q($collation) : ""));
* @param string
* @param string number
* @param string
- * @return bool
+ * @return Result|bool
*/
function alter_table($table, $name, $fields, $foreign, $comment, $engine, $collation, $auto_increment, $partitioning) {
global $connection;
/** Run commands to alter indexes
* @param string escaped table name
* @param array{string, string, 'DROP'|list<string>} of ["index type", "name", ["column definition", ...]] or ["index type", "name", "DROP"]
- * @return bool
+ * @return Result|bool
*/
function alter_indexes($table, $alter) {
foreach ($alter as $key => $val) {
/** Drop views
* @param list<string>
- * @return bool
+ * @return Result|bool
*/
function drop_views($views) {
return queries("DROP VIEW " . implode(", ", array_map('Adminer\table', $views)));
/** Drop tables
* @param list<string>
- * @return bool
+ * @return Result|bool
*/
function drop_tables($tables) {
return queries("DROP TABLE " . implode(", ", array_map('Adminer\table', $tables)));
"type" => strtolower($param[5]),
"length" => preg_replace_callback("~$enum~s", 'Adminer\normalize_enum', $param[6]),
"unsigned" => strtolower(preg_replace('~\s+~', ' ', trim("$param[8] $param[7]"))),
- "null" => 1,
+ "null" => true,
"full_type" => $param[4],
"inout" => strtoupper($param[1]),
"collation" => strtolower($param[9]),
/** Get approximate number of rows
* @param TableStatus
* @param list<string>
- * @return int or null if approximate number can't be retrieved
+ * @return numeric-string|void null if approximate number can't be retrieved
*/
function found_rows($table_status, $where) {
return ($where || $table_status["Engine"] != "InnoDB" ? null : $table_status["Rows"]);
/** Kill a process
* @param int
- * @return bool
+ * @return Result|bool
*/
function kill_process($val) {
return queries("KILL " . number($val));
}
/** Get maximum number of connections
- * @return int
+ * @return numeric-string
*/
function max_connections() {
return get_val("SELECT @@max_connections");
if (preg_match("~ rows=([0-9]+)~", get_val("EXPLAIN SELECT * FROM " . idf_escape($table_status["Name"]) . ($where ? " WHERE " . implode(" AND ", $where) : "")), $regs)) {
return $regs[1];
}
- return false;
}
function types() {
}
function __destruct() {
- return $this->result->finalize();
+ $this->result->finalize();
}
}
}
/** Get structured types
- * @return list<string>[] [$description => [$type, ...], ...]
+ * @return list<string>[]|list<string> [$description => [$type, ...], ...]
*/
function structuredTypes() {
return array_map('array_keys', $this->types);
* @param int result of $adminer->selectLimitProcess()
* @param int index of page starting at zero
* @param bool whether to print the query
- * @return Result
+ * @return Result|false
*/
function select($table, $select, $where, $group, $order = array(), $limit = 1, $page = 0, $print = false) {
global $adminer;
* @param string
* @param string " WHERE ..."
* @param int 0 or 1
- * @return bool
+ * @return Result|bool
*/
function delete($table, $queryWhere, $limit = 0) {
$query = "FROM " . table($table);
* @param string " WHERE ..."
* @param int 0 or 1
* @param string
- * @return bool
+ * @return Result|bool
*/
function update($table, $set, $queryWhere, $limit = 0, $separator = "\n") {
$values = array();
/** Insert data into table
* @param string
* @param string[] escaped columns in keys, quoted data in values
- * @return bool
+ * @return Result|bool
*/
function insert($table, $set) {
return queries("INSERT INTO " . table($table) . ($set
) . $this->insertReturning($table));
}
- /** Get RETURNING clause for INSERT queries, PostgreSQL specific
+ /** Get RETURNING clause for INSERT queries (PostgreSQL specific)
* @param string
* @return string
*/
* @param string
* @param list<string[]> of arrays with escaped columns in keys and quoted data in values
* @param int[] column names in keys
- * @return bool
+ * @return Result|bool
*/
function insertUpdate($table, $rows, $primary) {
return false;
}
/** Begin transaction
- * @return bool
+ * @return Result|bool
*/
function begin() {
return queries("BEGIN");
}
/** Commit transaction
- * @return bool
+ * @return Result|bool
*/
function commit() {
return queries("COMMIT");
}
/** Rollback transaction
- * @return bool
+ * @return Result|bool
*/
function rollback() {
return queries("ROLLBACK");
* @param list<string>
* @param string
* @param string
-* @return bool
+* @return Result|bool
*/
function grant($grant, $privileges, $columns, $on) {
if (!$privileges) {
/** Generate SQL query for creating routine
* @param string "PROCEDURE" or "FUNCTION"
-* @param string[] result of routine()
+* @param Routine result of routine()
* @return string
*/
function create_routine($routine, $row) {
/** Find out foreign keys for each column
* @param string
-* @return list<string>[] [$col => []]
+* @return list<ForeignKey>[] [$col => []]
*/
function column_foreign_keys($table) {
global $adminer;
} else {
$filename = @tempnam("", ""); // @ - temp directory can be disabled by open_basedir
if (!$filename) {
- return false;
+ return '';
}
$return = dirname($filename);
unlink($filename);
/** Open and exclusively lock a file
* @param string
-* @return resource or null for error
+* @return resource|void null for error
*/
function file_open_lock($filename) {
if (is_link($filename)) {
/** Read password from file adminer.key in temporary directory or create one
* @param bool
-* @return string or false if the file can not be created
+* @return string|false false if the file can not be created
*/
function password_file($create) {
$filename = get_temp_dir() . "/adminer.key";
/** Process edit input field
* @param Field one field from fields()
-* @return string or false to leave the original value
+* @return mixed false to leave the original value
*/
function process_input($field) {
global $adminer, $driver;
if (stripos($field["default"], "GENERATED ALWAYS AS ") === 0) {
- return null;
+ return;
}
$idf = bracket_escape($field["field"]);
$function = idx($_POST["function"], $idf);
/** Decipher
* @param string binary cipher
* @param string
-* @return string plain-text password
+* @return string|false plain-text password
*/
function decrypt_string($str, $key) {
if ($str == "") {
* @param string
* @param string
* @param string
-* @param array{error?:list<int>, type?:list<string>, name?:list<string>}
+* @param array{error?:list<int>, type?:list<string>, name?:list<string>, tmp_name?:list<string>}
* @return bool
*/
function send_mail($email, $subject, $message, $from = "", $files = array()) {
parameters:
- level: 2
+ level: 3
ignoreErrors:
+ # diagnose
+ - "~Adminer\\\\Db::~"
+
+ # need to fix
+ - "~^Function Adminer\\\\fields_from_edit\\(\\) should return~" # Mongo and SimpleDB
+
+ # not real problems
- identifier: include.fileNotFound # relative includes
- identifier: includeOnce.fileNotFound # ./adminer-plugins.php
- "~^Function (set_magic_quotes_runtime|mysql_)~" # PHP < 7 functions
- "~^Variable \\$(adminer|connection|driver|drivers|error|HTTPS|LANG|langs|permanent|has_token|token|translations|VERSION) might not be defined~" # declared in bootstrap.inc.php
- "~^Comparison operation \"==\" between \\(array\\|float\\|int\\) and 1~" # false positive
- "~OCI-?Lob~" # maybe include stub?
- - "~Adminer\\\\Db::~" # diagnose!
+
paths:
- .
phpVersion:
max: 80499
checkMissingCallableSignature: true
typeAliases:
- TableStatus: "array{Name:string, Engine:string, Comment:string, Oid:int, Rows:int, Collation:string, Auto_increment:int, Data_length:int, Index_length:int, Data_free:int}"
- Field: "array{field:string, full_type:string, type:string, length:int, unsigned:string, default:string, null:bool, auto_increment:bool, on_update:string, collation:string, privileges:int[], comment:string, primary:bool, generated:string}"
- Index: "array{type:string, columns:list<string>, lengths:list<int>, descs:list<bool>}"
- ForeignKey: "array{db:string, ns:string, table:string, source:list<string>, target:list<string>, on_delete:string, on_update:string}"
- Trigger: "array{Trigger:string, Timing:string, Event:string, Of:string, Type:string, Statement:string}"
- Routine: "array{fields:list<array{field:string, type:string, length:string, unsigned:string, null:bool, full_type:string, inout:string, collation:string}>, comment:string, returns:array, definition:string, language:string}"
+ TableStatus: "array{Name:string, Engine:string, Comment:string, Oid?:numeric-string, Rows:numeric-string, Collation:string, Auto_increment:numeric-string, Data_length:numeric-string, Index_length:numeric-string, Data_free:numeric-string, Create_options?:string, nspname?:string}"
+ Field: "array{field:string, full_type:string, type:string, length:numeric-string, unsigned:string, default:?string, null:bool, auto_increment:bool, on_update:string, collation:string, privileges:int[], comment:string, primary:bool, generated:string, orig?:string, on_delete?:string, inout?:string}"
+ Index: "array{type:string, columns:list<string>, lengths:list<numeric-string>, descs:list<?bool>}"
+ ForeignKey: "array{db:string, ns?:string, table:string, source:list<string>, target:list<string>, on_delete:string, on_update:string}"
+ Trigger: "array{Trigger?:string, Timing?:string, Event?:string, Of?:string, Type?:string, Statement?:string}"
+ Routine: "array{name?:string, fields:list<array{field:string, type:string, length:?string, unsigned:string, null:bool, full_type:string, inout:string, collation:string}>, comment:string, returns?:array, definition:string, language?:string}"
BackwardKey: "array{name:string, keys:string[][]}"
}
}
- return $this->conn->affected_rows;
+ return !!$this->conn->affected_rows;
}
function convertOperator($operator) {
}
function found_rows($table_status, $where) {
- return null;
}
/** Alter type
projects / adminer.git / commitdiff