https://github.com/webcaetano/mq
simple PHP SQL functions and JSON results convert
https://github.com/webcaetano/mq
Last synced: 7 months ago
JSON representation
simple PHP SQL functions and JSON results convert
- Host: GitHub
- URL: https://github.com/webcaetano/mq
- Owner: webcaetano
- License: mit
- Created: 2015-04-16T03:24:01.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2015-04-30T11:48:08.000Z (about 11 years ago)
- Last Synced: 2024-12-29T10:28:49.824Z (over 1 year ago)
- Language: PHP
- Homepage:
- Size: 215 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 
simple PHP SQL functions
and JSON results convert
- [x] Open the code.
- [x] Finish documentation.
- [ ] Add it to composer.
- [ ] Create Subgroups results on SELECT
## Documentation
config.php - credencials file
mQ.php - main file
- [connect](#connect)
- [mIns](#mins)
- [mQ](#mq)
- [mSel](#msel)
- [mRow](#mrow)
- [mRows](#mrows)
- [mDel](#mdel)
- [mSet](#mset)
- [mAr](#mar)
- [mNum](#mnum)
- [mQN](#mqn)
- [oV](#ov)
- [sql2JSON](#sql2json)
- [_json](#_json)
### connect
Connect to database.
```php
connect('gamedb');
```
### mIns
Insert SQL row and return row index.
mIns(table,cols)
```php
mIns('players','name="Polt"'); // runs INSERT INTO players set name="Polt"
$id = mIns('players',['name="TheOddOne"','team="TSM"']); // runs INSERT INTO players set name="TheOddOne", team="TSM"
echo $id;
# 2 // return row insertion index
```
### mQ
Run SQL command.
mQ(sql)
```php
mQ('SELECT * FROM players WHERE 1');
```
### mSel
Run a [mRows](#mrows) command based on a object
mSel(data)
```php
// Each attribute from object could be Array or string
mSel([
"cols"=>['name','team'],
"table"=>"players",
"where"=>['name="Polt"','team="TSM"'],
"group"=>"name",
"limit"=>"0,1",
"order"=>"name DESC"
]);
// Return mRows('
// SELECT name,team
// FROM players
// WHERE name="Polt" and team="TSM"
// GROUP BY name
// ORDER BY limit 0,1
// ');
```
### mRow
Return a single row SQL result
mRow(query)
```php
$row1 = mRow('SELECT * FROM players WHERE 1');
```
### mRows
Return an array of rows
mRows(query)
```php
$allRows = mRows('SELECT * FROM players WHERE 1');
```
### mDel
Runs a DELETE comand in a table
mDel(table,where)
```php
mDel('players',['name="TheOddOne"','team="TSM"']); // runs DELETE FROM players WHERE name="TheOddOne" and team="TSM"
or
mDel('players','1'); // runs DELETE FROM players WHERE 1
```
### mSet
Runs a UPDATE comand in a table
mSet(table,set,where)
```php
// @table could be string or array
// @set could be string or array
// @where could be string or array
mSet('players',['name="TheOddOne"','team="TSM"'],'team=""'); // runs UPDATE players set name="TheOddOne", team="TSM" WHERE team=""
```
### mAr
Turns SQL query and return the next row.
mAr(query)
```php
$row1 = mAr(mQ('SELECT * FROM players WHERE 1'));
```
### mNum
Return num of rows in a query.
mNum(query)
```php
$sql = mQ('SELECT * FROM players ');
echo mNum($sql);
// 2
or
echo mNum(mQ('SELECT * FROM players '));
//2
```
### mQN
Run command and return num of rows in this query.
mQN(sql)
```php
echo mQN('SELECT * FROM players ');
//2
//same as mNum(mQ('SELECT * FROM players '));
```
### oV
(One Value)
Return a single value of A single Row.
oV(sql)
```php
echo oV('SELECT name FROM players Limit 0,1');
//Polt
```
### sql2JSON
Runs SQL and Parse Array result values to utf8 and return a JSON string
sql2JSON(SQL)
```php
echo sql2JSON('SELECT name FROM players Limit 0,1');
//{"name":"Polt"}
or
_sql2JSON('SELECT name FROM players Limit 0,1');
// same as sql2JSON but auto "echo"
// {"name":"Polt"}
```
### _json
Parse Array result values to utf8 and return a JSON string
sql2JSON(array)
```php
echo _json(["name"=>"Polt"]);
// {"name":"Polt"}
```