Friendica/friendica-github
1
0
Fork 0
mirror of https://github.com/friendica/friendica synced 2025-04-30 23:44:23 +02:00
Code Issues Projects Releases Packages Wiki Activity

@brief is removed completely

Browse source
This commit is contained in:
Michael 2020-01-19 06:05:23 +00:00
parent fd1f1999f0
commit 0a4119adaf
170 changed files with 901 additions and 962 deletions
Download patch file Download diff file Expand all files Collapse all files

6
src/Database/DBA.php
View file

@ -207,7 +207,6 @@ class DBA
*
* Please use DBA::selectFirst or DBA::exists whenever this is possible.
*
* @brief Fetches the first row
* @param string $sql SQL statement
* @return array first row of query
* @throws \Exception
@ -360,7 +359,9 @@ class DBA
}
/**
* Updates rows in the database. When $old_fields is set to an array,
* Updates rows in the database.
*
* When $old_fields is set to an array,
* the system will only do an update if the fields in that array changed.
*
* Attention:
@ -378,7 +379,6 @@ class DBA
* Only set $old_fields to a boolean value when you are sure that you will update a single row.
* When you set $old_fields to "true" then $fields must contain all relevant fields!
*
* @brief Updates rows
* @param string|array $table Table name or array [schema => table]
* @param array $fields contains the fields that are updated
* @param array $condition condition array with the key values

4
src/Database/DBStructure.php
View file

@ -15,8 +15,6 @@ use Friendica\Util\DateTimeFormat;
require_once __DIR__ . '/../../include/dba.php';
/**
* @brief This class contain functions for the database management
*
* This class contains functions that doesn't need to know if pdo, mysqli or whatever is used.
*/
class DBStructure
@ -63,7 +61,7 @@ class DBStructure
}
/**
* @brief Print out database error messages
* Print out database error messages
*
* @param string $message Message to be added to the error message
*

70
src/Database/Database.php
View file

@ -226,7 +226,7 @@ class Database
}
/**
* @brief Returns the MySQL server version string
* Returns the MySQL server version string
*
* This function discriminate between the deprecated mysql API and the current
* object-oriented mysqli API. Example of returned string: 5.5.46-0+deb8u1
@ -249,7 +249,7 @@ class Database
}
/**
* @brief Returns the selected database name
* Returns the selected database name
*
* @return string
* @throws \Exception
@ -262,7 +262,7 @@ class Database
}
/**
* @brief Analyze a database query and log this if some conditions are met.
* Analyze a database query and log this if some conditions are met.
*
* @param string $query The database query that will be analyzed
*
@ -378,8 +378,8 @@ class Database
}
/**
* @brief Replaces ANY_VALUE() function by MIN() function,
* if the database server does not support ANY_VALUE().
* Replaces ANY_VALUE() function by MIN() function,
* if the database server does not support ANY_VALUE().
*
* Considerations for Standard SQL, or MySQL with ONLY_FULL_GROUP_BY (default since 5.7.5).
* ANY_VALUE() is available from MySQL 5.7.5 https://dev.mysql.com/doc/refman/5.7/en/miscellaneous-functions.html
@ -400,7 +400,7 @@ class Database
}
/**
* @brief Replaces the ? placeholders with the parameters in the $args array
* Replaces the ? placeholders with the parameters in the $args array
*
* @param string $sql SQL query
* @param array $args The parameters that are to replace the ? placeholders
@ -427,7 +427,7 @@ class Database
}
/**
* @brief Executes a prepared statement that returns data
* Executes a prepared statement that returns data
* @usage Example: $r = p("SELECT * FROM `item` WHERE `guid` = ?", $guid);
*
* Please only use it with complicated queries.
@ -667,7 +667,7 @@ class Database
}
/**
* @brief Executes a prepared statement like UPDATE or INSERT that doesn't return data
* Executes a prepared statement like UPDATE or INSERT that doesn't return data
*
* Please use DBA::delete, DBA::insert, DBA::update, ... instead
*
@ -733,7 +733,7 @@ class Database
}
/**
* @brief Check if data exists
* Check if data exists
*
* @param string|array $table Table name or array [schema => table]
* @param array $condition array of fields for condition
@ -777,7 +777,7 @@ class Database
*
* Please use DBA::selectFirst or DBA::exists whenever this is possible.
*
* @brief Fetches the first row
* Fetches the first row
*
* @param string $sql SQL statement
*
@ -802,7 +802,7 @@ class Database
}
/**
* @brief Returns the number of affected rows of the last statement
* Returns the number of affected rows of the last statement
*
* @return int Number of rows
*/
@ -812,7 +812,7 @@ class Database
}
/**
* @brief Returns the number of columns of a statement
* Returns the number of columns of a statement
*
* @param object Statement object
*
@ -833,7 +833,7 @@ class Database
}
/**
* @brief Returns the number of rows of a statement
* Returns the number of rows of a statement
*
* @param PDOStatement|mysqli_result|mysqli_stmt Statement object
*
@ -854,7 +854,7 @@ class Database
}
/**
* @brief Fetch a single row
* Fetch a single row
*
* @param mixed $stmt statement object
*
@ -914,7 +914,7 @@ class Database
}
/**
* @brief Insert a row into a table
* Insert a row into a table
*
* @param string|array $table Table name or array [schema => table]
* @param array $param parameter array
@ -951,7 +951,7 @@ class Database
}
/**
* @brief Fetch the id of the last insert command
* Fetch the id of the last insert command
*
* @return integer Last inserted id
*/
@ -969,7 +969,7 @@ class Database
}
/**
* @brief Locks a table for exclusive write access
* Locks a table for exclusive write access
*
* This function can be extended in the future to accept a table array as well.
*
@ -1007,7 +1007,7 @@ class Database
}
/**
* @brief Unlocks all locked tables
* Unlocks all locked tables
*
* @return boolean was the unlock successful?
* @throws \Exception
@ -1035,7 +1035,7 @@ class Database
}
/**
* @brief Starts a transaction
* Starts a transaction
*
* @return boolean Was the command executed successfully?
*/
@ -1081,7 +1081,7 @@ class Database
}
/**
* @brief Does a commit
* Does a commit
*
* @return boolean Was the command executed successfully?
*/
@ -1095,7 +1095,7 @@ class Database
}
/**
* @brief Does a rollback
* Does a rollback
*
* @return boolean Was the command executed successfully?
*/
@ -1121,7 +1121,7 @@ class Database
}
/**
* @brief Build the array with the table relations
* Build the array with the table relations
*
* The array is build from the database definitions in DBStructure.php
*
@ -1143,7 +1143,7 @@ class Database
}
/**
* @brief Delete a row from a table
* Delete a row from a table
*
* Note: this methods does NOT accept schema => table arrays because of the complex relation stuff.
*
@ -1292,7 +1292,7 @@ class Database
}
/**
* @brief Updates rows
* Updates rows
*
* Updates rows in the database. When $old_fields is set to an array,
* the system will only do an update if the fields in that array changed.
@ -1374,8 +1374,6 @@ class Database
/**
* Retrieve a single record from a table and returns it in an associative array
*
* @brief Retrieve a single record from a table
*
* @param string|array $table
* @param array $fields
* @param array $condition
@ -1400,7 +1398,7 @@ class Database
}
/**
* @brief Select rows from a table and fills an array with the data
* Select rows from a table and fills an array with the data
*
* @param string|array $table Table name or array [schema => table]
* @param array $fields Array of selected fields, empty for all
@ -1417,7 +1415,7 @@ class Database
}
/**
* @brief Select rows from a table
* Select rows from a table
*
* @param string|array $table Table name or array [schema => table]
* @param array $fields Array of selected fields, empty for all
@ -1465,7 +1463,7 @@ class Database
}
/**
* @brief Counts the rows from a table satisfying the provided condition
* Counts the rows from a table satisfying the provided condition
*
* @param string|array $table Table name or array [schema => table]
* @param array $condition Array of fields for condition
@ -1509,7 +1507,7 @@ class Database
}
/**
* @brief Fills an array with data from a query
* Fills an array with data from a query
*
* @param object $stmt statement object
* @param bool $do_close
@ -1535,7 +1533,7 @@ class Database
}
/**
* @brief Returns the error number of the last query
* Returns the error number of the last query
*
* @return string Error number (0 if no error)
*/
@ -1545,7 +1543,7 @@ class Database
}
/**
* @brief Returns the error message of the last query
* Returns the error message of the last query
*
* @return string Error message ('' if no error)
*/
@ -1555,7 +1553,7 @@ class Database
}
/**
* @brief Closes the current statement
* Closes the current statement
*
* @param object $stmt statement object
*
@ -1596,7 +1594,7 @@ class Database
}
/**
* @brief Return a list of database processes
* Return a list of database processes
*
* @return array
* 'list' => List of processes, separated in their different states
@ -1652,7 +1650,7 @@ class Database
}
/**
* @brief Callback function for "esc_array"
* Callback function for "esc_array"
*
* @param mixed $value Array value
* @param string $key Array key
@ -1681,7 +1679,7 @@ class Database
}
/**
* @brief Escapes a whole array
* Escapes a whole array
*
* @param mixed $arr Array with values to be escaped
* @param boolean $add_quotation add quotation marks for string values

12
src/Database/PostUpdate.php
View file

@ -19,7 +19,7 @@ use Friendica\Model\PermissionSet;
class PostUpdate
{
/**
* @brief Calls the post update functions
* Calls the post update functions
*/
public static function update()
{
@ -49,7 +49,7 @@ class PostUpdate
}
/**
* @brief Updates the "global" field in the item table
* Updates the "global" field in the item table
*
* @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -118,7 +118,7 @@ class PostUpdate
}
/**
* @brief update the "last-item" field in the "self" contact
* update the "last-item" field in the "self" contact
*
* This field avoids cost intensive calls in the admin panel and in "nodeinfo"
*
@ -153,7 +153,7 @@ class PostUpdate
}
/**
* @brief update the item related tables
* update the item related tables
*
* @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -305,7 +305,7 @@ class PostUpdate
}
/**
* @brief update item-uri data. Prerequisite for the next item structure update.
* update item-uri data. Prerequisite for the next item structure update.
*
* @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException
@ -459,7 +459,7 @@ class PostUpdate
}
/**
* @brief update user-item data with notifications
* update user-item data with notifications
*
* @return bool "true" when the job is done
* @throws \Friendica\Network\HTTPException\InternalServerErrorException