Differences

This shows you the differences between two versions of the page.

--- development:mysql [2012/11/26 20:10] – Addition of 'maintainer' and 'admin' fields, and changing field-type of 'quota' to integer. s0600204
+++ development:mysql [2017/05/07 11:09] (current) – Lars Knickrehm
@@ Line 1: / Line 1: @@
-====== mySQL ======
+====== MySQL ======
-This page is dedicated to the development of a standard way of encoding user data into a mySQL database.
+This page is dedicated to the documentation of how we have encoded oneye user data into a mySQL database.
-For the moment, the technical details of how to connect oneye to the database are not important. What's currently being discussed is how data should be stored within the database. This requires the following decisions:
+Any suggestions, concerns, problems or other should be brought to light on the forums, specifically [[http://forums.oneye-project.org/viewtopic.php?id=37|in this thread]]. (To those used to MediaWiki-type wiki, think of the forum page linked as the discussion page for this wiki page).
-  * What tables are required, and what they should be called
-  * What fields are required inside those tables, and
-    * What the fields should be named
-    * What format the fields should be (Number, String, etc.)
-    * What length the fields should be
-Please note that modifications should only be made to this page __after__ they've been discussed in [[http://forums.oneye-project.org/viewtopic.php?id=37|this thread]] on the forums. Any concerns, problems or other should be brought to light there, not here. (To those used to MediaWiki-type wiki, think of the forum page linked as the discussion page for this wiki page).
+==== The Codebase ====
+As with all current development on oneye, the current code for the implementation is publicly accessible on GitHub. Specifically, here: https://github.com/s0600204/oneye/tree/userConfig
 ==== The Database ====
-The database format is mySQL. More details will be determined later.
+The database format is mySQL.
+The method used to connect to the database from PHP is the mySQLi Extension, included by default with PHP and compatible with databases created with mySQL v4.1 and later (current stable version: v5.1).
+== Constants ==
+The values of these constants will be used by oneye to connect to the database. The root user will, of course, be able to change the values.
+^  Constant Description  ^     Constant     ^  Default Value  ^        Notes       |
+|   mySQL Server Address |   MYSQL_SERVER   |    127.0.0.1    |                    |
+|          Database Name |   MYSQL_DBNAME   |     oneyeDB     |                    |
+|      Database Username |  MYSQL_USERNAME  |    www-data     |                    |
+|      Database Password |  MYSQL_PASSWORD  |                 |  Stored encrypted  |
 ==== The Tables ====
-List of suggested tables:
+List of currently implementated tables:
-  * **tblUser** - Main table that contains user data
+  * **tblUser** - Main table that contains user data.
+  * **tblGroups** - Table listing which users belong to which groups. Always checked.
+  * **tblMaintainedUsers** - This table lists the maintainers and their assigned users. Only checked if the //maintainer// field for a user in **tblUser** is '1'.
+  * **tblMaintainedGroups** - This table lists the maintainers and their assigned groups. Only checked if the //maintainer// field for a user in **tblUser** is '1'.
@@ Line 29: / Line 39: @@
 |       username |  varchar  |  32      |  No                    |                 |  Primary Key  |
 |       password |   char    |  32      |  No                    |                 |               |
-|          email |  varchar  |  64      |  Yes                   |  NULL           |               |
+|          email |  varchar  |  64      |  Yes                   |                 |               |
-|          quota |  integer  |          |  Yes                   |  NULL           |               |
+|          quota |  integer  |          |  Yes                   |  NULL           |  Unsigned, NULL = 'System Default'  |
-|       fullname |  varchar  |  64      |  Yes                   |  NULL           |               |
+|       fullname |  varchar  |  64      |  Yes                   |                 |               |
-|     createDate |  integer  |          |  Yes                   |  NULL           |               |
+|     createDate |  integer  |          |  Yes                   |  0              |  Unsigned     |
-| expirationDate |  integer  |          |  Yes                   |  0              |               |
+|      lastLogin |  integer  |          |  Yes                   |  0              |  Unsigned     |
+| expirationDate |  integer  |          |  Yes                   |  0              |  Unsigned     |
 |       disabled |   char    |  1       |  Yes                   |  0              |               |
-|      lastLogin |  integer  |          |  Yes                   |  NULL           |               |
+|          admin |   char    |  1       |  Yes                   |  0              |               |
-|          group |  varchar  |  128     |  Yes                   |  NULL           |               |
+|     maintainer |   char    |  1       |  Yes                   |  0              |               |
-|          admin |   char    |  1       |  Yes					 |  NULL           |  default could be '0'  |
-|     maintainer |   char    |  1       |  Yes					 |  NULL           |  default could be '0'  |
+== tblGroups ==
-|       maintain |  varchar  |  128     |  Yes					 |  NULL           |               |
+^  Field Name  ^   Type    ^  Length  ^  Permitted to be Null  ^  Default Value  ^  Other notes  |
-|       mngUsers |  varchar  |  1024    |  Yes      			 |  NULL           |               |
+|     username |  varchar  |    32    |  No                    |                 |  Primary Key  |
+|    groupname |  varchar  |    32    |  No                    |                 |  Primary Key  |
+== tblMaintainedUsers ==
+^  Field Name  ^   Type    ^  Length  ^  Permitted to be Null  ^  Default Value  ^  Other notes  |
+|   maintainer |  varchar  |    32    |  No                    |                 |  Primary Key  |
+|     username |  varchar  |    32    |  No                    |                 |  Primary Key  |
+== tblMaintainedGroups ==
+^  Field Name  ^   Type    ^  Length  ^  Permitted to be Null  ^  Default Value  ^  Other notes  |
+|   maintainer |  varchar  |    32    |  No                    |                 |  Primary Key  |
+|    groupname |  varchar  |    32    |  No                    |                 |  Primary Key  |
 ==== Reference ====