commits from branch v5, new version, major breaking changes, updated docs/doc-blocks

- The use of `namespace` in the `global` functions **ezFunctions.php** file.
    Usage of the **global** functions will require the user to begin a `.php` file something like:

    ```php
    use function ezsql\functions\where;
    // Or
    use function ezsql\functions\{
        getInstance,
        selecting,
        inserting,
    };
    ```

- Class properties that was accessible by magic methods `get/set`, now PSR 1 camelCase.
- update class libraries and tests to match PSR 1, but still backwards with previous way.
- Renamed `select` of `ez_mysqli` to `dbSelect`.
- Renamed class method and behavior of `selecting` to `select`.
- `selecting`, and new `inserting` methods, can be called without table name, only the other necessary parameters:
    - The table *name* with *prefix*, can be preset/stored with methods `tableSetup(name, prefix), or setTable(name), setPrefix(append)`, if called without presetting, `false` is returned.
    - This **feature** will be added to **all** database *CRUD* access methods , each method name will have an `ing` ending added.
- Removed global functions where `table` name passed in, use functions as outlined above using preset table names ending with `ing`.

Author: TheTechsTech

README.md

@@ -6,11 +6,36 @@
 [![codecov](https://codecov.io/gh/ezSQL/ezSQL/branch/master/graph/badge.svg)](https://codecov.io/gh/ezSQL/ezSQL)
 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/aad1f6aaaaa14f60933e75615da900b8)](https://www.codacy.com/app/techno-express/ezsql?utm_source=github.com&utm_medium=referral&utm_content=ezSQL/ezsql&utm_campaign=Badge_Grade)
 [![Maintainability](https://api.codeclimate.com/v1/badges/6f6107f25e9de7bf4272/maintainability)](https://codeclimate.com/github/ezSQL/ezsql/maintainability)
-[![Total Downloads](https://poser.pugx.org/ezSQL/ezsql/downloads)](https://packagist.org/packages/ezSQL/ezsql)
+[![Total Downloads](https://poser.pugx.org/ezsql/ezsql/downloads)](https://packagist.org/packages/ezsql/ezsql)
 
 ***A class to make it very easy to deal with database connections.***
 
-This is [__version 4__](https://github.com/ezSQL/ezsql/tree/v4) that has many modern programming practices in which will break users of version 3.
+This is [__Version 5__](https://github.com/ezSQL/ezsql/tree/v5) which will break users of **version 4**.
+
+Mainly by:
+
+- The use of `namespace` in the `global` functions **ezFunctions.php** file.
+    Usage of the **global** functions will require the user to begin a `.php` file something like:
+
+    ```php
+    use function ezsql\functions\where;
+    // Or
+    use function ezsql\functions\{
+        getInstance,
+        selecting,
+        inserting,
+    };
+    ```
+
+- Class properties that was accessible by magic methods `get/set`, now PSR 1 camelCase.
+- Renamed `select` of `ez_mysqli` to `dbSelect`.
+- Renamed class method and behavior of `selecting` to `select`.
+- `selecting`, and new `inserting` methods, can be called without table name, only the other necessary parameters:
+    - The table *name* with *prefix*, can be preset/stored with methods `tableSetup(name, prefix), or setTable(name), setPrefix(append)`, if called without presetting, `false` is returned.
+    - This **feature** will be added to **all** database *CRUD* access methods , each method name will have an `ing` ending added.
+- Removed global functions where `table` name passed in, use functions using preset table names ending with `ing`.
+
+[__Version 4__](https://github.com/ezSQL/ezsql/tree/v4) has many modern programming practices in which will break users of version 3.
 
 [__Version 3__](https://github.com/ezSQL/ezsql/tree/v3) broke version 2.1.7 in one major way, it required *PHP 5.6*. Which drop mysql extension support, other than that, nothing as far using the library was changed, only additional features.
 
@@ -115,7 +140,7 @@ prepareOff(); // When off shortcut SQL Methods calls will use vendors escape rou
 * `orderBy($orderBy, $order);`
 * `limit($numberOf, $offset = null)`
 * `where( ...$whereConditions);`
-* `selecting(string $table = null, $columnFields = '*', ...$conditions);`
+* `select(string $table = null, $columnFields = '*', ...$conditions);`
 * `create_select(string $newTable, $fromColumns, $oldTable = null, ...$conditions);`
 * `select_into(string $newTable, $fromColumns, $oldTable = null, ...$conditions);`
 * `update(string $table = null, $keyAndValue, ...$whereConditions);`
@@ -158,11 +183,18 @@ grouping( eq(key, value, combiner ), eq(key, value, combiner ) )
 ```
 
 ```php
-// Supply the the whole query string, and placing '?' within
-// With the same number of arguments in an array.
-// It will determine arguments type, execute, and return results.
+// Note: The usage of this method will require the user/developer to check
+// if `query_string` or `param_array` is valid.
+//
+// This is really an `private` internal method for other shortcut methods,
+// it's made public for `class development` usage only.
+//
+//
+// Supply the the whole `query` string, and placing '?' within, with the same number of arguments in an array.
+// It will then determine arguments type, execute, and return results.
 query_prepared(string $query_string, array $param_array);
-// Will need to call to get last successful query result, will return an object array
+// You will need to call this method to get last successful query result.
+// It wll return an object array.
 queryResult();
 ```
 
@@ -180,13 +212,13 @@ $db->insert('profile', $values);
 $db->insert('profile', ['name' => 'john john', 'email' => 'john@email', 'phone' => 123456]);
 
 // returns result set given the table name, column fields, and ...conditions
-$result = $db->selecting('profile', 'phone', eq('email', $email), between('id', 1, $values));
+$result = $db->select('profile', 'phone', eq('email', $email), between('id', 1, $values));
 
 foreach ($result as $row) {
     echo $row->phone;
 }
 
-$result = $db->selecting('profile', 'name, email',
+$result = $db->select('profile', 'name, email',
     // Conditionals can also be called, stacked with other functions like:
     //  innerJoin(), leftJoin(), rightJoin(), fullJoin()
     //      as (leftTable, rightTable, leftColumn, rightColumn, tableAs, equal condition),
@@ -222,6 +254,83 @@ foreach ($result as $row) {
 }
 ```
 
+Most of shortcut methods have counter **global** _functions_ available.
+They can only be access by beginning your `.php` file like:
+
+```php
+use function ezsql\functions\functionBelow;
+// Or as here, a complete list.
+use function ezsql\functions\{
+    database,
+    mysqlInstance,
+    pgsqlInstance,
+    mssqlInstance,
+    sqliteInstance,
+    pdoInstance,
+    tagInstance,
+    setInstance,
+    getInstance,
+    clearInstance,
+///
+    getVendor,
+    to_string,
+    cleanInput,
+    createCertificate,
+///
+    column,
+    primary,
+    foreign,
+    unique,
+    index,
+    addColumn,
+    dropColumn,
+///
+    eq,
+    neq,
+    ne,
+    lt,
+    lte,
+    gt,
+    gte,
+    isNull,
+    isNotNull,
+    like,
+    in,
+    notLike,
+    notIn,
+    between,
+    notBetween,
+///
+    select_into,
+    insert_select,
+    create_select,
+    where,
+    grouping,
+    groupBy,
+    having,
+    orderBy,
+    limit,
+    innerJoin,
+    leftJoin,
+    rightJoin,
+    fullJoin,
+    union,
+    unionAll,
+///
+    creating,
+    deleting,
+    dropping,
+    replacing,
+    selecting,
+    inserting,
+    table_setup,
+    set_table,
+    set_prefix
+};
+```
+
+For the functions **usage/docs** see [ezFunctions.php](https://github.com/ezSQL/ezsql/blob/v5/lib/ezFunctions.php).
+
 ## For Authors and **[Contributors](https://github.com/ezSQL/ezsql/blob/master/CONTRIBUTORS.md)**
 
 ## Contributing

lib/Config.php

@@ -8,33 +8,6 @@
 use ezsql\ConfigAbstract;
 use ezsql\ConfigInterface;
 
-/**
- * @method void setDriver($args);
- * @method void setDsn($args);
- * @method void setUser($args);
- * @method void setPassword($args);
- * @method void setName($args);
- * @method void setHost($args);
- * @method void setPort($args);
- * @method void setCharset($args);
- * @method void setOptions($args);
- * @method void setIsFile($args);
- * @method void setToMssql($args);
- * @method void setPath($args);
- *
- * @method string getDriver();
- * @method string getDsn();
- * @method string getUser();
- * @method string getPassword()
- * @method string getName();
- * @method string getHost();
- * @method string getPort();
- * @method string getCharset();
- * @method string getOptions();
- * @method bool getIsFile();
- * @method bool getToMssql();
- * @method string getPath();
- */
 class Config extends ConfigAbstract implements ConfigInterface
 {
     public function __construct(string $driver = '', array $arguments = null)

lib/ConfigInterface.php

@@ -13,6 +13,7 @@
  * @method void setCharset($args);
  * @method void setOptions($args);
  * @method void setIsFile($args);
+ * @method void setToMssql($args);
  * @method void setToMysql($args);
  * @method void setPath($args);
  *
@@ -27,6 +28,7 @@
  * @method string getOptions();
  * @method bool getIsFile();
  * @method bool getToMysql();
+ * @method bool getToMssql();
  * @method string getPath();
  */
 interface ConfigInterface

lib/Constants.php

@@ -5,7 +5,7 @@
     /**
      * ezsqlModel Constants
      */
-    \defined('EZSQL_VERSION') or \define('EZSQL_VERSION', '4.1.0');
+    \defined('EZSQL_VERSION') or \define('EZSQL_VERSION', '5.0.0');
     \defined('OBJECT') or \define('OBJECT', 'OBJECT');
     \defined('ARRAY_A') or \define('ARRAY_A', 'ARRAY_A');
     \defined('ARRAY_N') or \define('ARRAY_N', 'ARRAY_N');

lib/Database.php

@@ -5,6 +5,7 @@
 namespace ezsql;
 
 use ezsql\DInjector;
+use function ezsql\functions\setInstance;
 
 class Database
 {
@@ -30,15 +31,15 @@ public function __wakeup()
     /**
      * Initialize and connect a vendor database.
      *
-     * @param mixed $vendor - SQL driver
-     * @param mixed $setting - SQL connection parameters
-     * @param mixed $tag - Store the instance for later use
+     * @param string $vendor SQL driver
+     * @param array $setting SQL connection parameters
+     * @param string $tag Store the instance for later use
      * @return Database\ez_pdo|Database\ez_pgsql|Database\ez_sqlsrv|Database\ez_sqlite3|Database\ez_mysqli
      */
     public static function initialize(?string $vendor = null, ?array $setting = null, ?string $tag = null)
     {
         if (isset(self::$instances[$vendor]) && empty($setting) && empty($tag))
-            return \setInstance(self::$instances[$vendor]) ? self::$instances[$vendor] : false;
+            return setInstance(self::$instances[$vendor]) ? self::$instances[$vendor] : false;
 
         if (empty($vendor) || empty($setting)) {
             throw new \Exception(\MISSING_CONFIGURATION);
@@ -58,7 +59,7 @@ public static function initialize(?string $vendor = null, ?array $setting = null
                 }
             }
 
-            \setInstance($GLOBALS['ez' . $key]);
+            setInstance($GLOBALS['ez' . $key]);
             return $GLOBALS['ez' . $key];
         }
     }