atayahmet / database-active-record-class
The written for fast, practical database active record actions
Requires
- php: >=5.3.3
Requires (Dev)
- phpunit/phpunit: ~4.0
- squizlabs/php_codesniffer: ~1.5
This package is auto-updated.
Last update: 2024-12-17 10:26:21 UTC
README
Available fields:
- This library completly is written for composer package
- This will works with vendor autoload
- Codeigniter active record class interface used
- These library use simple and fast of
Let's start!
- We first make the database connection
- Processing the query results
Database Configuration
First let's start with the database settings.
database configuration files in the Db folders -> config.php
$current = 'mysql:connect1'; $db = array( 'mysql' => array( 'connect1' => array( 'hostname' => 'localhost', 'username' => 'root', 'password' => '', 'database' => '', 'dbprefix' => '' ) ) );
The $current variable is the driver you want to use as the active and allows you to use the database connection.
Example:
Up when I want to define a second database connection settings you need to do the following.
'connect2' => array( 'hostname' => 'localhost', 'username' => 'root', 'password' => '', 'database' => '', 'dbprefix' => '' )
and my $current variable have been:
$current = 'mysql:connect2';
We can define the connection as we want it that way.
Note: mysql needs to be defined for the identification of the considered prospective.
We first make the database connection
Add our workspace our library
use Db\Query as DB;
We install the library and also have set a alias. I chose the DB alias.
A simple database query:
DB::select('*'); DB::get('example_table');
We questioned directly above our table without specifying any criteria query. We can do the same query in the following way:
DB::select('*')->get('example_table');
SELECT:
Use 1:
DB::select('*')->get('example_table');
Use 2:
DB::select('examle_type.*')->get('example_type');
Use 3:
DB::select('example_type.id'); DB::select('example_type.name')->get('example_type');
**select_max():**
$result = DB::select_max('id')->get('example_type'); echo $result->row()->id;
**select_min():**
$result = DB::select_max('id')->get('example_type'); echo $result->row()->id;
**select_avg():**
$result = DB::select_avg('age')->get('example_type'); echo $result->row()->age;
**select_sum():**
$result = DB::select_sum('total')->get('example_type'); echo $result->row()->total;
**distinct():**
$result = DB::distinct('city')->get('example_type'); echo $result->row()->city;
FROM:
from():
$result = DB::select('*')->from('example_table')->get(); echo $result->row()->total;
WHERE
$result = DB::where('city','Istanbul')->get('users'); print_r $result->result_array();
Where you can pass parameters to the method in 3 ways.
Method 1:
$result = DB::where('city !=','Istanbul')->get('users'); print_r $result->result_array();
$result = DB::where('age >',19)->get('users'); print_r $result->result_array();
$result = DB::where('age <',19)->get('users'); print_r $result->result_array();
$result = DB::where('age <>',18)->get('users'); print_r $result->result_array();
$result = DB::where('city','Istanbul')->get('users'); print_r $result->result_array();
Method 2:
$result = DB::where(array('city' => 'Istanbul'))->get('users'); print_r $result->result_array();
$result = DB::where(array('age >' => 19))->get('users'); print_r $result->result_array();
$result = DB::where(array('age <' => 19))->get('users'); print_r $result->result_array();
$result = DB::where(array('age <>' => 18))->get('users'); print_r $result->result_array();
Method 3:
$result = DB::where("city => 'Istanbul'")->get('users'); print_r $result->result_array();
suc as.
If we want we can create a query like:
$result = DB::where('id',1) ->where(array('city' => 'Istanbul')) ->where("age <> '18'")->get('users'); print_r $result->result_array();
**or_where():** ```sh $result = DB::where('id',1)->or_where('age',18)->get('users'); ```
**where_in():** ```sh $result = DB::where_in('age',18)->get('users'); ``` a different use: ```sh $result = DB::where_in('age',array(18,20,22,23))->get('users'); ``` > **Note:** > This combination can be used on all **where_in**
**or_where_in():** ```sh $result = DB::where('city','Istanbul')->or_where_in('age',18)->get('users'); ```
**where_not_in():** ```sh $result = DB::where_not_in('age',18)->get('users'); ```
**or_where_not_in():** ```sh $result = DB::where('city','Istanbul')->or_where_not_in('age',18)->get('users'); ```
or_where_not_in():
$result = DB::where('city','Istanbul')->or_where_not_in('age',18)->get('users');
or_where_not_in():
$result = DB::where('city','Istanbul')->or_where_not_in('age',18)->get('users');
LIKE COMBINATION
like():
$result = DB::like('name','Ali')->get('users');
$result = DB::like(array('name' => 'Ali', 'city' => Ist))->get('users');
You can also locate the reference point by sending a third parameter:
before: $result = DB::like('name', 'Ali','before')->get('users'); print out: //users.name LIKE '%Ali' after: $result = DB::like('name', 'Ali','after')->get('users'); print out: //users.name LIKE 'Ali%'
**or_like():** ```sh $result = DB::like('name','Ali')->or_like('city','Ist')->get('users'); ```
**not_like():** ```sh $result = DB::not_like('name','Ali')->get('users'); ```
**or_not_like():** ```sh $result = DB::not_like('name','Ali')->or_not_like('city','Ist')->get('users'); ```
ORDER BY
order_by():
$result = DB::->order_by('name','DESC')->get('users');
**order_by('random'):** ```sh $result = DB::->order_by('name','random')->get('users'); ```
GROUP BY
group_by():
$result = DB::group_by('name')->get('users');
HAVING
having():
$result = DB::group_by('name')->having("name = 'Ali'")->get('users');
**or_having():** ```sh $result = DB::group_by('name') ->having("name = 'Ali'")->or_having('age',18)->get('users'); ```
LIMIT
limit():
$result = DB::limit(1)->get('users');
instead of the offset method is also useful for:
$result = DB::limit(2,1)->get('users');
OFFSET (skip data)
offset():
$result = DB::offset(5)->get('users');
JOIN TABLES
As simple as possible to join tables.
First example:
DB::select('t1.name, t2.city') ->from(DB::dbprefix('users') . ' t1') ->join(DB::dbprefix('cities') . ' t2',"t2.id = t1.city_id",'inner') ->where('t1.age >',18) ->get();
We combine the member table where the city table. And we have defined the coming of the age of 18 and where the.
Note: We have sent the left marked as the third parameter in the join method. Parameters that are available here:
- inner (INNER JOIN)
- left (LEFT JOIN)
- right (RIGHT JOIN)
- left outer join (LEFT OUTER JOIN)
- right outer join (RIGHT OUTER JOIN)
- cross (CROSS JOIN)
inner parameters will work as default.
Let's make different example:
DB::select('t1.name, t2.city') ->from(DB::dbprefix('users') . ' t1') ->join(DB::dbprefix('cities') . ' t2',"t2.id = t1.city_id",'inner') ->join(DB::dbprefix('countries') . ' t3','t3.id = t2.country_id','left') ->where('t1.age <',30) ->where('t1.age >',18) ->get();
INSERT
There are several ways to add data to the table.
insert():
First:
DB::insert('users',array( 'name' => 'Ali', 'city' => 'Istanbul', 'age' => 21 ) )
Another use: ```sh DB::set('name','Ali'); DB::set('city','Istanbul'); DB::set('age','18'); DB::insert('users'); ``` ```sh DB::set( array( 'name' => 'Ali', 'city' => 'Istanbul/Turkey', 'age' => 18 ) );
DB::insert('users');
<br >
and another use than:
```sh
class User {
public $name = 'Ali';
public $city = 'Istanbul';
public $age = 18;
}
DB::insert('users', new User());
**insert_batch():** ```sh DB::insert_batch('users',array( array( 'name' => 'Ali', 'city' => 'Istanbul', 'age' => 21 ), array( 'name' => 'Erkan', 'city' => 'Ankara', 'age' => 20 ), array( 'name' => 'Emre', 'city' => 'Izmir', 'age' => 19 ) ) ) ```
**insert_id():**
After adding to retrieve the last record id:
DB::insert_id();
UPDATE
Relatively simple processing such as insert, update
update():
DB::where('id',1) ->update('users',array( 'name' => 'Ali', 'city' => 'Istanbul/Turkey', 'age' => 18 ) )
or
DB::set('name','Ali'); DB::set('city','Istanbul/Turkey'); DB::set('age',18); DB::update('users');
or
DB::set( array( 'name' => 'Ali', 'city' => 'Istanbul/Turkey', 'age' => 18 ) ); DB::update('users');
**update_batch():**
Sometimes we want to do multiple updates.
$data = array( array( 'id' => 1, 'name' => 'Ali', 'city' => 'Izmir', 'age' => 19 ), array( 'id' => 2, 'name' => 'Ahmet', 'city' => 'Bursa', 'age' => 21 ), array( 'id' => 3, 'name' => 'Adem', 'city' => 'Antalya', 'age' => 22 ) ); DB::update_batch('users',data, 'id');
DELETE
delete():
DB::where('id',1)->delete('users');
COUNT
Get the number of records in the table are also able to do a fairly simple way.
count_all():
DB::count_all('users');
This method will return us to the number of records in the specified table
**count_all_results():** ```sh DB::from('users') ->where('age >',18) ->or_where('city','Istanbul') ->count_all_results(); ``` > **Note:** as much as possible when you want to use this method of total records
Native Query:
if you say you want to run native SQL.
query():
DB::query("SELECT * FROM users WHERE age > 18");
GET:
Is a method that will run our query. If you wish you can send your query table names get method. If you wish, you can choose the method from.
get():
DB::get('users');
or
DB::from('users')->get();
get_where():
$limit = 1; $offset = 2; DB::get_where('users',array('id' => 1),$limit,$offset);
DB PREFIX
We use our unique method we want to use the prefix table.
DB::dbprefix('users');
Num Rows
We can use it to get the number of rows of query results.
num_rows():
$result = DB::get('users'); echo $result->num_rows();
Row
Allows access to a single row in the query results.
row():
The result will be the object.
$result = DB::get('users'); print_r $result->row();
or it can be done in specifying the number of rows you want to access
print_r $result->row(5);
**row_array():**
The result will be the array.
$result = DB::get('users'); print_r $result->row_array();
or it can be done in specifying the number of rows you want to access
print_r $result->row_array(5);
Processing the query results
If we want to use queries in a loop we run it we can do in two ways.
result():
$result = DB::get('users'); print_r $result->result();
Note: results will become an object
**result_array():**
$result = DB::get('users'); print_r $result->result_array();
Note: results will become an array
Affected Rows
affected_rows():
echo DB::affected_rows();
SQL Dump
When running under the URL of a page request is sent to all queries will return the string and working duration.
dump():
one will give way listed in a table.
echo DB::dump();
If we want we can also take in a number of.
print_r DB::dump('array');
hopefully be helpful to you!
Please errors and parts you do not understand that you can discuss open issues identified under the project.