Skip to content

Q
question2answer
Commit d64f2ad4 by pupi1985
Options

PHPDoc update in db/admin, db/cache, db/install and db/metas

parent f90cc369
Showing with 161 additions and 150 deletions
qa-include/db/admin.php
...@@ -27,6 +27,7 @@ if (!defined('QA_VERSION')) { // don't allow this page to be requested directly ...@@ -27,6 +27,7 @@ if (!defined('QA_VERSION')) { // don't allow this page to be requested directly
/** /**
* Return the current version of MySQL * Return the current version of MySQL
* @return string
*/ */
function qa_db_mysql_version() function qa_db_mysql_version()
{ {
...@@ -36,6 +37,7 @@ function qa_db_mysql_version() ...@@ -36,6 +37,7 @@ function qa_db_mysql_version()
/** /**
* Return the total size in bytes of all relevant tables in the Q2A database * Return the total size in bytes of all relevant tables in the Q2A database
* @return float
*/ */
function qa_db_table_size() function qa_db_table_size()
{ {
...@@ -67,9 +69,9 @@ function qa_db_table_size() ...@@ -67,9 +69,9 @@ function qa_db_table_size()
/** /**
* Return a count of the number of posts of $type in database. * Return a count of the number of posts of $type in database.
* Set $fromuser to true to only count non-anonymous posts, false to only count anonymous posts * Set $fromuser to true to only count non-anonymous posts, false to only count anonymous posts
* @param $type * @param string|null $type
* @param $fromuser * @param mixed|null $fromuser
* @return mixed|null * @return string
*/ */
function qa_db_count_posts($type = null, $fromuser = null) function qa_db_count_posts($type = null, $fromuser = null)
{ {
...@@ -89,6 +91,7 @@ function qa_db_count_posts($type = null, $fromuser = null) ...@@ -89,6 +91,7 @@ function qa_db_count_posts($type = null, $fromuser = null)
/** /**
* Return number of registered users in database. * Return number of registered users in database.
* @return string
*/ */
function qa_db_count_users() function qa_db_count_users()
{ {
...@@ -100,8 +103,8 @@ function qa_db_count_users() ...@@ -100,8 +103,8 @@ function qa_db_count_users()
/** /**
* Return number of active users in database $table * Return number of active users in database $table
* @param $table * @param string $table
* @return mixed|null * @return string
*/ */
function qa_db_count_active_users($table) function qa_db_count_active_users($table)
{ {
...@@ -124,6 +127,7 @@ function qa_db_count_active_users($table) ...@@ -124,6 +127,7 @@ function qa_db_count_active_users($table)
/** /**
* Return number of categories in the database * Return number of categories in the database
* @return string
*/ */
function qa_db_count_categories() function qa_db_count_categories()
{ {
...@@ -135,8 +139,8 @@ function qa_db_count_categories() ...@@ -135,8 +139,8 @@ function qa_db_count_categories()
/** /**
* Return number of questions in the database in $categoryid exactly, and not one of its subcategories * Return number of questions in the database in $categoryid exactly, and not one of its subcategories
* @param $categoryid * @param int $categoryid
* @return mixed|null * @return string
*/ */
function qa_db_count_categoryid_qs($categoryid) function qa_db_count_categoryid_qs($categoryid)
{ {
...@@ -149,7 +153,7 @@ function qa_db_count_categoryid_qs($categoryid) ...@@ -149,7 +153,7 @@ function qa_db_count_categoryid_qs($categoryid)
/** /**
* Return list of postids of visible or queued posts by $userid * Return list of postids of visible or queued posts by $userid
* @param $userid * @param mixed $userid
* @return array * @return array
*/ */
function qa_db_get_user_visible_postids($userid) function qa_db_get_user_visible_postids($userid)
...@@ -163,7 +167,7 @@ function qa_db_get_user_visible_postids($userid) ...@@ -163,7 +167,7 @@ function qa_db_get_user_visible_postids($userid)
/** /**
* Return list of postids of visible or queued posts from $ip address * Return list of postids of visible or queued posts from $ip address
* @param $ip * @param string $ip
* @return array * @return array
*/ */
function qa_db_get_ip_visible_postids($ip) function qa_db_get_ip_visible_postids($ip)
...@@ -177,12 +181,12 @@ function qa_db_get_ip_visible_postids($ip) ...@@ -177,12 +181,12 @@ function qa_db_get_ip_visible_postids($ip)
/** /**
* Return an array whose keys contain the $postids which exist, and whose elements contain the number of other posts depending on each one * Return an array whose keys contain the $postids which exist, and whose elements contain the number of other posts depending on each one
* @param $postids * @param array $postids
* @return array * @return array
*/ */
function qa_db_postids_count_dependents($postids) function qa_db_postids_count_dependents($postids)
{ {
if (count($postids)) if (!empty($postids))
return qa_db_read_all_assoc(qa_db_query_sub( return qa_db_read_all_assoc(qa_db_query_sub(
"SELECT postid, COALESCE(childcount, 0) AS count FROM ^posts LEFT JOIN (SELECT parentid, COUNT(*) AS childcount FROM ^posts WHERE parentid IN (#) AND LEFT(type, 1) IN ('A', 'C') GROUP BY parentid) x ON postid=x.parentid WHERE postid IN (#)", "SELECT postid, COALESCE(childcount, 0) AS count FROM ^posts LEFT JOIN (SELECT parentid, COUNT(*) AS childcount FROM ^posts WHERE parentid IN (#) AND LEFT(type, 1) IN ('A', 'C') GROUP BY parentid) x ON postid=x.parentid WHERE postid IN (#)",
$postids, $postids $postids, $postids
...@@ -195,7 +199,7 @@ function qa_db_postids_count_dependents($postids) ...@@ -195,7 +199,7 @@ function qa_db_postids_count_dependents($postids)
/** /**
* Return an array of the (up to) $count most recently created users who are awaiting approval and have not been blocked. * Return an array of the (up to) $count most recently created users who are awaiting approval and have not been blocked.
* The array element for each user includes a 'profile' key whose value is an array of non-empty profile fields of the user. * The array element for each user includes a 'profile' key whose value is an array of non-empty profile fields of the user.
* @param $count * @param int $count
* @return array * @return array
*/ */
function qa_db_get_unapproved_users($count) function qa_db_get_unapproved_users($count)
...@@ -227,6 +231,7 @@ function qa_db_get_unapproved_users($count) ...@@ -227,6 +231,7 @@ function qa_db_get_unapproved_users($count)
/** /**
* Return whether there are any blobs whose content has been stored as a file on disk * Return whether there are any blobs whose content has been stored as a file on disk
* @return bool
*/ */
function qa_db_has_blobs_on_disk() function qa_db_has_blobs_on_disk()
{ {
...@@ -236,6 +241,7 @@ function qa_db_has_blobs_on_disk() ...@@ -236,6 +241,7 @@ function qa_db_has_blobs_on_disk()
/** /**
* Return whether there are any blobs whose content has been stored in the database * Return whether there are any blobs whose content has been stored in the database
* @return bool
*/ */
function qa_db_has_blobs_in_db() function qa_db_has_blobs_in_db()
{ {
...@@ -245,8 +251,8 @@ function qa_db_has_blobs_in_db() ...@@ -245,8 +251,8 @@ function qa_db_has_blobs_in_db()
/** /**
* Return the maximum position of the categories with $parentid * Return the maximum position of the categories with $parentid
* @param $parentid * @param int $parentid
* @return mixed|null * @return string
*/ */
function qa_db_category_last_pos($parentid) function qa_db_category_last_pos($parentid)
{ {
...@@ -259,7 +265,7 @@ function qa_db_category_last_pos($parentid) ...@@ -259,7 +265,7 @@ function qa_db_category_last_pos($parentid)
/** /**
* Return how many levels of subcategory there are below $categoryid * Return how many levels of subcategory there are below $categoryid
* @param $categoryid * @param int $categoryid
* @return int * @return int
*/ */
function qa_db_category_child_depth($categoryid) function qa_db_category_child_depth($categoryid)
...@@ -283,18 +289,18 @@ function qa_db_category_child_depth($categoryid) ...@@ -283,18 +289,18 @@ function qa_db_category_child_depth($categoryid)
/** /**
* Create a new category with $parentid, $title (=name) and $tags (=slug) in the database * Create a new category with $parentid, $title (=name) and $tags (=slug) in the database
* @param $parentid * @param int $parentid
* @param $title * @param string $title
* @param $tags * @param string $tags
* @return mixed * @return int
*/ */
function qa_db_category_create($parentid, $title, $tags) function qa_db_category_create($parentid, $title, $tags)
{ {
$lastpos = qa_db_category_last_pos($parentid); $lastpos = (int)qa_db_category_last_pos($parentid);
qa_db_query_sub( qa_db_query_sub(
'INSERT INTO ^categories (parentid, title, tags, position) VALUES (#, $, $, #)', 'INSERT INTO ^categories (parentid, title, tags, position) VALUES (#, $, $, #)',
$parentid, $title, $tags, 1 + $lastpos $parentid, $title, $tags, $lastpos + 1
); );
$categoryid = qa_db_last_insert_id(); $categoryid = qa_db_last_insert_id();
...@@ -307,8 +313,8 @@ function qa_db_category_create($parentid, $title, $tags) ...@@ -307,8 +313,8 @@ function qa_db_category_create($parentid, $title, $tags)
/** /**
* Recalculate the backpath columns for all categories from $firstcategoryid to $lastcategoryid (if specified) * Recalculate the backpath columns for all categories from $firstcategoryid to $lastcategoryid (if specified)
* @param $firstcategoryid * @param int $firstcategoryid
* @param $lastcategoryid * @param int|null $lastcategoryid
*/ */
function qa_db_categories_recalc_backpaths($firstcategoryid, $lastcategoryid = null) function qa_db_categories_recalc_backpaths($firstcategoryid, $lastcategoryid = null)
{ {
...@@ -324,9 +330,9 @@ function qa_db_categories_recalc_backpaths($firstcategoryid, $lastcategoryid = n ...@@ -324,9 +330,9 @@ function qa_db_categories_recalc_backpaths($firstcategoryid, $lastcategoryid = n
/** /**
* Set the name of $categoryid to $title and its slug to $tags in the database * Set the name of $categoryid to $title and its slug to $tags in the database
* @param $categoryid * @param int $categoryid
* @param $title * @param string $title
* @param $tags * @param string $tags
*/ */
function qa_db_category_rename($categoryid, $title, $tags) function qa_db_category_rename($categoryid, $title, $tags)
{ {
...@@ -341,8 +347,8 @@ function qa_db_category_rename($categoryid, $title, $tags) ...@@ -341,8 +347,8 @@ function qa_db_category_rename($categoryid, $title, $tags)
/** /**
* Set the content (=description) of $categoryid to $content * Set the content (=description) of $categoryid to $content
* @param $categoryid * @param int $categoryid
* @param $content * @param string $content
*/ */
function qa_db_category_set_content($categoryid, $content) function qa_db_category_set_content($categoryid, $content)
{ {
...@@ -355,8 +361,8 @@ function qa_db_category_set_content($categoryid, $content) ...@@ -355,8 +361,8 @@ function qa_db_category_set_content($categoryid, $content)
/** /**
* Return the parentid of $categoryid * Return the parentid of $categoryid
* @param $categoryid * @param int $categoryid
* @return mixed|null * @return string
*/ */
function qa_db_category_get_parent($categoryid) function qa_db_category_get_parent($categoryid)
{ {
...@@ -369,8 +375,8 @@ function qa_db_category_get_parent($categoryid) ...@@ -369,8 +375,8 @@ function qa_db_category_get_parent($categoryid)
/** /**
* Move the category $categoryid into position $newposition under its parent * Move the category $categoryid into position $newposition under its parent
* @param $categoryid * @param int $categoryid
* @param $newposition * @param int $newposition
*/ */
function qa_db_category_set_position($categoryid, $newposition) function qa_db_category_set_position($categoryid, $newposition)
{ {
...@@ -381,8 +387,8 @@ function qa_db_category_set_position($categoryid, $newposition) ...@@ -381,8 +387,8 @@ function qa_db_category_set_position($categoryid, $newposition)
/** /**
* Set the parent of $categoryid to $newparentid, placing it in last position (doesn't do necessary recalculations) * Set the parent of $categoryid to $newparentid, placing it in last position (doesn't do necessary recalculations)
* @param $categoryid * @param int $categoryid
* @param $newparentid * @param string $newparentid
*/ */
function qa_db_category_set_parent($categoryid, $newparentid) function qa_db_category_set_parent($categoryid, $newparentid)
{ {
...@@ -393,11 +399,11 @@ function qa_db_category_set_parent($categoryid, $newparentid) ...@@ -393,11 +399,11 @@ function qa_db_category_set_parent($categoryid, $newparentid)
qa_db_ordered_move('categories', 'categoryid', $categoryid, $lastpos, qa_db_apply_sub('parentid<=>#', array($oldparentid))); qa_db_ordered_move('categories', 'categoryid', $categoryid, $lastpos, qa_db_apply_sub('parentid<=>#', array($oldparentid)));
$lastpos = qa_db_category_last_pos($newparentid); $lastpos = (int)qa_db_category_last_pos($newparentid);
qa_db_query_sub( qa_db_query_sub(
'UPDATE ^categories SET parentid=#, position=# WHERE categoryid=#', 'UPDATE ^categories SET parentid=#, position=# WHERE categoryid=#',
$newparentid, 1 + $lastpos, $categoryid $newparentid, $lastpos + 1, $categoryid
); );
} }
} }
...@@ -405,8 +411,8 @@ function qa_db_category_set_parent($categoryid, $newparentid) ...@@ -405,8 +411,8 @@ function qa_db_category_set_parent($categoryid, $newparentid)
/** /**
* Change the categoryid of any posts with (exact) $categoryid to $reassignid * Change the categoryid of any posts with (exact) $categoryid to $reassignid
* @param $categoryid * @param int $categoryid
* @param $reassignid * @param int $reassignid
*/ */
function qa_db_category_reassign($categoryid, $reassignid) function qa_db_category_reassign($categoryid, $reassignid)
{ {
...@@ -416,7 +422,7 @@ function qa_db_category_reassign($categoryid, $reassignid) ...@@ -416,7 +422,7 @@ function qa_db_category_reassign($categoryid, $reassignid)
/** /**
* Delete the category $categoryid in the database * Delete the category $categoryid in the database
* @param $categoryid * @param int $categoryid
*/ */
function qa_db_category_delete($categoryid) function qa_db_category_delete($categoryid)
{ {
...@@ -427,9 +433,9 @@ function qa_db_category_delete($categoryid) ...@@ -427,9 +433,9 @@ function qa_db_category_delete($categoryid)
/** /**
* Return the categoryid for the category with parent $parentid and $slug * Return the categoryid for the category with parent $parentid and $slug
* @param $parentid * @param int $parentid
* @param $slug * @param string $slug
* @return mixed|null * @return string|null
*/ */
function qa_db_category_slug_to_id($parentid, $slug) function qa_db_category_slug_to_id($parentid, $slug)
{ {
...@@ -442,13 +448,13 @@ function qa_db_category_slug_to_id($parentid, $slug) ...@@ -442,13 +448,13 @@ function qa_db_category_slug_to_id($parentid, $slug)
/** /**
* Create a new custom page (or link) in the database * Create a new custom page (or link) in the database
* @param $title * @param string $title
* @param $flags * @param int $flags
* @param $tags * @param string $tags
* @param $heading * @param string $heading
* @param $content * @param string $content
* @param $permit * @param int|null $permit
* @return mixed * @return string
*/ */
function qa_db_page_create($title, $flags, $tags, $heading, $content, $permit = null) function qa_db_page_create($title, $flags, $tags, $heading, $content, $permit = null)
{ {
...@@ -465,13 +471,13 @@ function qa_db_page_create($title, $flags, $tags, $heading, $content, $permit = ...@@ -465,13 +471,13 @@ function qa_db_page_create($title, $flags, $tags, $heading, $content, $permit =
/** /**
* Set the fields of $pageid to the values provided in the database * Set the fields of $pageid to the values provided in the database
* @param $pageid * @param int $pageid
* @param $title * @param string $title
* @param $flags * @param int $flags
* @param $tags * @param string $tags
* @param $heading * @param string $heading
* @param $content * @param string $content
* @param $permit * @param int|null $permit
*/ */
function qa_db_page_set_fields($pageid, $title, $flags, $tags, $heading, $content, $permit = null) function qa_db_page_set_fields($pageid, $title, $flags, $tags, $heading, $content, $permit = null)
{ {
...@@ -484,9 +490,9 @@ function qa_db_page_set_fields($pageid, $title, $flags, $tags, $heading, $conten ...@@ -484,9 +490,9 @@ function qa_db_page_set_fields($pageid, $title, $flags, $tags, $heading, $conten
/** /**
* Move the page $pageid into navigation menu $nav and position $newposition in the database * Move the page $pageid into navigation menu $nav and position $newposition in the database
* @param $pageid * @param int $pageid
* @param $nav * @param string $nav
* @param $newposition * @param int $newposition
*/ */
function qa_db_page_move($pageid, $nav, $newposition) function qa_db_page_move($pageid, $nav, $newposition)
{ {
...@@ -501,7 +507,7 @@ function qa_db_page_move($pageid, $nav, $newposition) ...@@ -501,7 +507,7 @@ function qa_db_page_move($pageid, $nav, $newposition)
/** /**
* Delete the page $pageid in the database * Delete the page $pageid in the database
* @param $pageid * @param int $pageid
*/ */
function qa_db_page_delete($pageid) function qa_db_page_delete($pageid)
{ {
...@@ -511,11 +517,11 @@ function qa_db_page_delete($pageid) ...@@ -511,11 +517,11 @@ function qa_db_page_delete($pageid)
/** /**
* Move the entity identified by $idcolumn=$id into position $newposition (within optional $conditionsql) in $table in the database * Move the entity identified by $idcolumn=$id into position $newposition (within optional $conditionsql) in $table in the database
* @param $table * @param string $table
* @param $idcolumn * @param string $idcolumn
* @param $id * @param string $id
* @param $newposition * @param int $newposition
* @param $conditionsql * @param string|null $conditionsql
*/ */
function qa_db_ordered_move($table, $idcolumn, $id, $newposition, $conditionsql = null) function qa_db_ordered_move($table, $idcolumn, $id, $newposition, $conditionsql = null)
{ {
...@@ -547,10 +553,10 @@ function qa_db_ordered_move($table, $idcolumn, $id, $newposition, $conditionsql ...@@ -547,10 +553,10 @@ function qa_db_ordered_move($table, $idcolumn, $id, $newposition, $conditionsql
/** /**
* Delete the entity identified by $idcolumn=$id (and optional $conditionsql) in $table in the database * Delete the entity identified by $idcolumn=$id (and optional $conditionsql) in $table in the database
* @param $table * @param string $table
* @param $idcolumn * @param string $idcolumn
* @param $id * @param string $id
* @param $conditionsql * @param string|null $conditionsql
*/ */
function qa_db_ordered_delete($table, $idcolumn, $id, $conditionsql = null) function qa_db_ordered_delete($table, $idcolumn, $id, $conditionsql = null)
{ {
...@@ -570,11 +576,11 @@ function qa_db_ordered_delete($table, $idcolumn, $id, $conditionsql = null) ...@@ -570,11 +576,11 @@ function qa_db_ordered_delete($table, $idcolumn, $id, $conditionsql = null)
/** /**
* Create a new user field with (internal) tag $title, label $content, $flags and $permit in the database. * Create a new user field with (internal) tag $title, label $content, $flags and $permit in the database.
* @param $title * @param string $title
* @param $content * @param string $content
* @param $flags * @param int $flags
* @param $permit * @param int|null $permit
* @return mixed * @return string
*/ */
function qa_db_userfield_create($title, $content, $flags, $permit = null) function qa_db_userfield_create($title, $content, $flags, $permit = null)
{ {
...@@ -591,10 +597,10 @@ function qa_db_userfield_create($title, $content, $flags, $permit = null) ...@@ -591,10 +597,10 @@ function qa_db_userfield_create($title, $content, $flags, $permit = null)
/** /**
* Change the user field $fieldid to have label $content, $flags and $permit in the database (the title column cannot be changed once set) * Change the user field $fieldid to have label $content, $flags and $permit in the database (the title column cannot be changed once set)
* @param $fieldid * @param string $fieldid
* @param $content * @param string $content
* @param $flags * @param int $flags
* @param $permit * @param int|null $permit
*/ */
function qa_db_userfield_set_fields($fieldid, $content, $flags, $permit = null) function qa_db_userfield_set_fields($fieldid, $content, $flags, $permit = null)
{ {
...@@ -607,8 +613,8 @@ function qa_db_userfield_set_fields($fieldid, $content, $flags, $permit = null) ...@@ -607,8 +613,8 @@ function qa_db_userfield_set_fields($fieldid, $content, $flags, $permit = null)
/** /**
* Move the user field $fieldid into position $newposition in the database * Move the user field $fieldid into position $newposition in the database
* @param $fieldid * @param string $fieldid
* @param $newposition * @param int $newposition
*/ */
function qa_db_userfield_move($fieldid, $newposition) function qa_db_userfield_move($fieldid, $newposition)
{ {
...@@ -618,7 +624,7 @@ function qa_db_userfield_move($fieldid, $newposition) ...@@ -618,7 +624,7 @@ function qa_db_userfield_move($fieldid, $newposition)
/** /**
* Delete the user field $fieldid in the database * Delete the user field $fieldid in the database
* @param $fieldid * @param string $fieldid
*/ */
function qa_db_userfield_delete($fieldid) function qa_db_userfield_delete($fieldid)
{ {
...@@ -628,9 +634,9 @@ function qa_db_userfield_delete($fieldid) ...@@ -628,9 +634,9 @@ function qa_db_userfield_delete($fieldid)
/** /**
* Return the ID of a new widget, to be displayed by the widget module named $title on templates within $tags (comma-separated list) * Return the ID of a new widget, to be displayed by the widget module named $title on templates within $tags (comma-separated list)
* @param $title * @param string $title
* @param $tags * @param string $tags
* @return mixed * @return string
*/ */
function qa_db_widget_create($title, $tags) function qa_db_widget_create($title, $tags)
{ {
...@@ -647,8 +653,8 @@ function qa_db_widget_create($title, $tags) ...@@ -647,8 +653,8 @@ function qa_db_widget_create($title, $tags)
/** /**
* Set the comma-separated list of templates for $widgetid to $tags * Set the comma-separated list of templates for $widgetid to $tags
* @param $widgetid * @param int $widgetid
* @param $tags * @param string $tags
*/ */
function qa_db_widget_set_fields($widgetid, $tags) function qa_db_widget_set_fields($widgetid, $tags)
{ {
...@@ -661,9 +667,9 @@ function qa_db_widget_set_fields($widgetid, $tags) ...@@ -661,9 +667,9 @@ function qa_db_widget_set_fields($widgetid, $tags)
/** /**
* Move the widget $widgetit into position $position in the database's order, and show it in $place on the page * Move the widget $widgetit into position $position in the database's order, and show it in $place on the page
* @param $widgetid * @param int $widgetid
* @param $place * @param string $place
* @param $newposition * @param int $newposition
*/ */
function qa_db_widget_move($widgetid, $place, $newposition) function qa_db_widget_move($widgetid, $place, $newposition)
{ {
...@@ -678,7 +684,7 @@ function qa_db_widget_move($widgetid, $place, $newposition) ...@@ -678,7 +684,7 @@ function qa_db_widget_move($widgetid, $place, $newposition)
/** /**
* Delete the widget $widgetid in the database * Delete the widget $widgetid in the database
* @param $widgetid * @param int $widgetid
*/ */
function qa_db_widget_delete($widgetid) function qa_db_widget_delete($widgetid)
{ {
......
qa-include/db/cache.php
...@@ -29,9 +29,9 @@ require_once QA_INCLUDE_DIR . 'db/maxima.php'; ...@@ -29,9 +29,9 @@ require_once QA_INCLUDE_DIR . 'db/maxima.php';
/** /**
* Create (or replace) the item ($type, $cacheid) in the database cache table with $content * Create (or replace) the item ($type, $cacheid) in the database cache table with $content
* @param $type * @param string $type
* @param $cacheid * @param string $cacheid
* @param $content * @param string $content
* @return mixed * @return mixed
*/ */
function qa_db_cache_set($type, $cacheid, $content) function qa_db_cache_set($type, $cacheid, $content)
...@@ -53,8 +53,8 @@ function qa_db_cache_set($type, $cacheid, $content) ...@@ -53,8 +53,8 @@ function qa_db_cache_set($type, $cacheid, $content)
/** /**
* Retrieve the item ($type, $cacheid) from the database cache table * Retrieve the item ($type, $cacheid) from the database cache table
* @param $type * @param string $type
* @param $cacheid * @param string $cacheid
* @return mixed|null * @return mixed|null
*/ */
function qa_db_cache_get($type, $cacheid) function qa_db_cache_get($type, $cacheid)
......
qa-include/db/install.php
...@@ -29,6 +29,7 @@ define('QA_DB_VERSION_CURRENT', 67); ...@@ -29,6 +29,7 @@ define('QA_DB_VERSION_CURRENT', 67);
/** /**
* Return the column type for user ids after verifying it is one of the legal options * Return the column type for user ids after verifying it is one of the legal options
* @return string
*/ */
function qa_db_user_column_type_verify() function qa_db_user_column_type_verify()
{ {
...@@ -59,6 +60,7 @@ function qa_db_user_column_type_verify() ...@@ -59,6 +60,7 @@ function qa_db_user_column_type_verify()
/** /**
* Return an array of table definitions. For each element of the array, the key is the table name (without prefix) * Return an array of table definitions. For each element of the array, the key is the table name (without prefix)
* and the value is an array of column definitions, [column name] => [definition]. The column name is omitted for indexes. * and the value is an array of column definitions, [column name] => [definition]. The column name is omitted for indexes.
* @return array
*/ */
function qa_db_table_definitions() function qa_db_table_definitions()
{ {
...@@ -539,7 +541,7 @@ function qa_db_table_definitions() ...@@ -539,7 +541,7 @@ function qa_db_table_definitions()
/** /**
* Return array with all values from $array as keys * Return array with all values from $array as keys
* @param $array * @param array $array
* @return array * @return array
*/ */
function qa_array_to_keys($array) function qa_array_to_keys($array)
...@@ -550,7 +552,7 @@ function qa_array_to_keys($array) ...@@ -550,7 +552,7 @@ function qa_array_to_keys($array)
/** /**
* Return a list of tables missing from the database, [table name] => [column/index definitions] * Return a list of tables missing from the database, [table name] => [column/index definitions]
* @param $definitions * @param array $definitions
* @return array * @return array
*/ */
function qa_db_missing_tables($definitions) function qa_db_missing_tables($definitions)
...@@ -569,8 +571,8 @@ function qa_db_missing_tables($definitions) ...@@ -569,8 +571,8 @@ function qa_db_missing_tables($definitions)
/** /**
* Return a list of columns missing from $table in the database, given the full definition set in $definition * Return a list of columns missing from $table in the database, given the full definition set in $definition
* @param $table * @param string $table
* @param $definition * @param array $definition
* @return array * @return array
*/ */
function qa_db_missing_columns($table, $definition) function qa_db_missing_columns($table, $definition)
...@@ -589,6 +591,7 @@ function qa_db_missing_columns($table, $definition) ...@@ -589,6 +591,7 @@ function qa_db_missing_columns($table, $definition)
/** /**
* Return the current version of the Q2A database, to determine need for DB upgrades * Return the current version of the Q2A database, to determine need for DB upgrades
* @return int|null
*/ */
function qa_db_get_db_version() function qa_db_get_db_version()
{ {
...@@ -607,7 +610,7 @@ function qa_db_get_db_version() ...@@ -607,7 +610,7 @@ function qa_db_get_db_version()
/** /**
* Set the current version in the database * Set the current version in the database
* @param $version * @param int $version
*/ */
function qa_db_set_db_version($version) function qa_db_set_db_version($version)
{ {
...@@ -619,6 +622,7 @@ function qa_db_set_db_version($version) ...@@ -619,6 +622,7 @@ function qa_db_set_db_version($version)
/** /**
* Return a string describing what is wrong with the database, or false if everything is just fine * Return a string describing what is wrong with the database, or false if everything is just fine
* @return false|string
*/ */
function qa_db_check_tables() function qa_db_check_tables()
{ {
...@@ -703,8 +707,8 @@ function qa_db_install_tables() ...@@ -703,8 +707,8 @@ function qa_db_install_tables()
/** /**
* Return the SQL command to create a table with $rawname and $definition obtained from qa_db_table_definitions() * Return the SQL command to create a table with $rawname and $definition obtained from qa_db_table_definitions()
* @param $rawname * @param string $rawname
* @param $definition * @param array $definition
* @return string * @return string
*/ */
function qa_db_create_table_sql($rawname, $definition) function qa_db_create_table_sql($rawname, $definition)
...@@ -720,6 +724,7 @@ function qa_db_create_table_sql($rawname, $definition) ...@@ -720,6 +724,7 @@ function qa_db_create_table_sql($rawname, $definition)
/** /**
* Return the SQL to create the default entries in the userfields table (before 1.3 these were hard-coded in PHP) * Return the SQL to create the default entries in the userfields table (before 1.3 these were hard-coded in PHP)
* @return string
*/ */
function qa_db_default_userfields_sql() function qa_db_default_userfields_sql()
{ {
...@@ -1629,9 +1634,9 @@ function qa_db_upgrade_tables() ...@@ -1629,9 +1634,9 @@ function qa_db_upgrade_tables()
/** /**
* Reset the definitions of $columns in $table according to the $definitions array * Reset the definitions of $columns in $table according to the $definitions array
* @param $definitions * @param array $definitions
* @param $table * @param string $table
* @param $columns * @param array $columns
*/ */
function qa_db_upgrade_table_columns($definitions, $table, $columns) function qa_db_upgrade_table_columns($definitions, $table, $columns)
{ {
...@@ -1646,7 +1651,7 @@ function qa_db_upgrade_table_columns($definitions, $table, $columns) ...@@ -1646,7 +1651,7 @@ function qa_db_upgrade_table_columns($definitions, $table, $columns)
/** /**
* Perform upgrade $query and output progress to the browser * Perform upgrade $query and output progress to the browser
* @param $query * @param string $query
*/ */
function qa_db_upgrade_query($query) function qa_db_upgrade_query($query)
{ {
...@@ -1657,7 +1662,7 @@ function qa_db_upgrade_query($query) ...@@ -1657,7 +1662,7 @@ function qa_db_upgrade_query($query)
/** /**
* Output $text to the browser (after converting to HTML) and do all we can to get it displayed * Output $text to the browser (after converting to HTML) and do all we can to get it displayed
* @param $text * @param string $text
*/ */
function qa_db_upgrade_progress($text) function qa_db_upgrade_progress($text)
{ {
......
qa-include/db/metas.php
...@@ -27,9 +27,9 @@ if (!defined('QA_VERSION')) { // don't allow this page to be requested directly ...@@ -27,9 +27,9 @@ if (!defined('QA_VERSION')) { // don't allow this page to be requested directly
/** /**
* Set the metadata for user $userid with $key to $value. Keys beginning qa_ are reserved for the Q2A core. * Set the metadata for user $userid with $key to $value. Keys beginning qa_ are reserved for the Q2A core.
* @param $userid * @param mixed $userid
* @param $key * @param string $key
* @param $value * @param string $value
*/ */
function qa_db_usermeta_set($userid, $key, $value) function qa_db_usermeta_set($userid, $key, $value)
{ {
...@@ -39,8 +39,8 @@ function qa_db_usermeta_set($userid, $key, $value) ...@@ -39,8 +39,8 @@ function qa_db_usermeta_set($userid, $key, $value)
/** /**
* Clear the metadata for user $userid with $key ($key can also be an array of keys) * Clear the metadata for user $userid with $key ($key can also be an array of keys)
* @param $userid * @param mixed $userid
* @param $key * @param string $key
*/ */
function qa_db_usermeta_clear($userid, $key) function qa_db_usermeta_clear($userid, $key)
{ {
...@@ -51,8 +51,8 @@ function qa_db_usermeta_clear($userid, $key) ...@@ -51,8 +51,8 @@ function qa_db_usermeta_clear($userid, $key)
/** /**
* Return the metadata value for user $userid with $key ($key can also be an array of keys in which case this * Return the metadata value for user $userid with $key ($key can also be an array of keys in which case this
* returns an array of metadata key => value). * returns an array of metadata key => value).
* @param $userid * @param mixed $userid
* @param $key * @param string $key
* @return array|mixed|null * @return array|mixed|null
*/ */
function qa_db_usermeta_get($userid, $key) function qa_db_usermeta_get($userid, $key)
...@@ -63,9 +63,9 @@ function qa_db_usermeta_get($userid, $key) ...@@ -63,9 +63,9 @@ function qa_db_usermeta_get($userid, $key)
/** /**
* Set the metadata for post $postid with $key to $value. Keys beginning qa_ are reserved for the Q2A core. * Set the metadata for post $postid with $key to $value. Keys beginning qa_ are reserved for the Q2A core.
* @param $postid * @param int $postid
* @param $key * @param string $key
* @param $value * @param string $value
*/ */
function qa_db_postmeta_set($postid, $key, $value) function qa_db_postmeta_set($postid, $key, $value)
{ {
...@@ -75,8 +75,8 @@ function qa_db_postmeta_set($postid, $key, $value) ...@@ -75,8 +75,8 @@ function qa_db_postmeta_set($postid, $key, $value)
/** /**
* Clear the metadata for post $postid with $key ($key can also be an array of keys) * Clear the metadata for post $postid with $key ($key can also be an array of keys)
* @param $postid * @param int $postid
* @param $key * @param string $key
*/ */
function qa_db_postmeta_clear($postid, $key) function qa_db_postmeta_clear($postid, $key)
{ {
...@@ -87,8 +87,8 @@ function qa_db_postmeta_clear($postid, $key) ...@@ -87,8 +87,8 @@ function qa_db_postmeta_clear($postid, $key)
/** /**
* Return the metadata value for post $postid with $key ($key can also be an array of keys in which case this * Return the metadata value for post $postid with $key ($key can also be an array of keys in which case this
* returns an array of metadata key => value). * returns an array of metadata key => value).
* @param $postid * @param int $postid
* @param $key * @param string $key
* @return array|mixed|null * @return array|mixed|null
*/ */
function qa_db_postmeta_get($postid, $key) function qa_db_postmeta_get($postid, $key)
...@@ -99,9 +99,9 @@ function qa_db_postmeta_get($postid, $key) ...@@ -99,9 +99,9 @@ function qa_db_postmeta_get($postid, $key)
/** /**
* Set the metadata for category $categoryid with $key to $value. Keys beginning qa_ are reserved for the Q2A core. * Set the metadata for category $categoryid with $key to $value. Keys beginning qa_ are reserved for the Q2A core.
* @param $categoryid * @param int $categoryid
* @param $key * @param string $key
* @param $value * @param string $value
*/ */
function qa_db_categorymeta_set($categoryid, $key, $value) function qa_db_categorymeta_set($categoryid, $key, $value)
{ {
...@@ -111,8 +111,8 @@ function qa_db_categorymeta_set($categoryid, $key, $value) ...@@ -111,8 +111,8 @@ function qa_db_categorymeta_set($categoryid, $key, $value)
/** /**
* Clear the metadata for category $categoryid with $key ($key can also be an array of keys) * Clear the metadata for category $categoryid with $key ($key can also be an array of keys)
* @param $categoryid * @param int $categoryid
* @param $key * @param string $key
*/ */
function qa_db_categorymeta_clear($categoryid, $key) function qa_db_categorymeta_clear($categoryid, $key)
{ {
...@@ -123,8 +123,8 @@ function qa_db_categorymeta_clear($categoryid, $key) ...@@ -123,8 +123,8 @@ function qa_db_categorymeta_clear($categoryid, $key)
/** /**
* Return the metadata value for category $categoryid with $key ($key can also be an array of keys in which * Return the metadata value for category $categoryid with $key ($key can also be an array of keys in which
* case this returns an array of metadata key => value). * case this returns an array of metadata key => value).
* @param $categoryid * @param int $categoryid
* @param $key * @param string $key
* @return array|mixed|null * @return array|mixed|null
*/ */
function qa_db_categorymeta_get($categoryid, $key) function qa_db_categorymeta_get($categoryid, $key)
...@@ -135,9 +135,9 @@ function qa_db_categorymeta_get($categoryid, $key) ...@@ -135,9 +135,9 @@ function qa_db_categorymeta_get($categoryid, $key)
/** /**
* Set the metadata for tag $tag with $key to $value. Keys beginning qa_ are reserved for the Q2A core. * Set the metadata for tag $tag with $key to $value. Keys beginning qa_ are reserved for the Q2A core.
* @param $tag * @param string $tag
* @param $key * @param string $key
* @param $value * @param string $value
*/ */
function qa_db_tagmeta_set($tag, $key, $value) function qa_db_tagmeta_set($tag, $key, $value)
{ {
...@@ -147,8 +147,8 @@ function qa_db_tagmeta_set($tag, $key, $value) ...@@ -147,8 +147,8 @@ function qa_db_tagmeta_set($tag, $key, $value)
/** /**
* Clear the metadata for tag $tag with $key ($key can also be an array of keys) * Clear the metadata for tag $tag with $key ($key can also be an array of keys)
* @param $tag * @param string $tag
* @param $key * @param string $key
*/ */
function qa_db_tagmeta_clear($tag, $key) function qa_db_tagmeta_clear($tag, $key)
{ {
...@@ -159,9 +159,9 @@ function qa_db_tagmeta_clear($tag, $key) ...@@ -159,9 +159,9 @@ function qa_db_tagmeta_clear($tag, $key)
/** /**
* Return the metadata value for tag $tag with $key ($key can also be an array of keys in which case this * Return the metadata value for tag $tag with $key ($key can also be an array of keys in which case this
* returns an array of metadata key => value). * returns an array of metadata key => value).
* @param $tag * @param string $tag
* @param $key * @param string $key
* @return array|mixed|null * @return mixed
*/ */
function qa_db_tagmeta_get($tag, $key) function qa_db_tagmeta_get($tag, $key)
{ {
...@@ -171,11 +171,11 @@ function qa_db_tagmeta_get($tag, $key) ...@@ -171,11 +171,11 @@ function qa_db_tagmeta_get($tag, $key)
/** /**
* Internal general function to set metadata * Internal general function to set metadata
* @param $metatable * @param string $metatable
* @param $idcolumn * @param string $idcolumn
* @param $idvalue * @param string $idvalue
* @param $title * @param string $title
* @param $content * @param string $content
*/ */
function qa_db_meta_set($metatable, $idcolumn, $idvalue, $title, $content) function qa_db_meta_set($metatable, $idcolumn, $idvalue, $title, $content)
{ {
...@@ -189,10 +189,10 @@ function qa_db_meta_set($metatable, $idcolumn, $idvalue, $title, $content) ...@@ -189,10 +189,10 @@ function qa_db_meta_set($metatable, $idcolumn, $idvalue, $title, $content)
/** /**
* Internal general function to clear metadata * Internal general function to clear metadata
* @param $metatable * @param string $metatable
* @param $idcolumn * @param string $idcolumn
* @param $idvalue * @param string $idvalue
* @param $title * @param string|array $title
*/ */
function qa_db_meta_clear($metatable, $idcolumn, $idvalue, $title) function qa_db_meta_clear($metatable, $idcolumn, $idvalue, $title)
{ {
...@@ -214,11 +214,11 @@ function qa_db_meta_clear($metatable, $idcolumn, $idvalue, $title) ...@@ -214,11 +214,11 @@ function qa_db_meta_clear($metatable, $idcolumn, $idvalue, $title)
/** /**
* Internal general function to return metadata * Internal general function to return metadata
* @param $metatable * @param string $metatable
* @param $idcolumn * @param string $idcolumn
* @param $idvalue * @param string $idvalue
* @param $title * @param string|array $title
* @return array|mixed|null * @return mixed
*/ */
function qa_db_meta_get($metatable, $idcolumn, $idvalue, $title) function qa_db_meta_get($metatable, $idcolumn, $idvalue, $title)
{ {
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment