Overview

Namespaces

  • Kotchasan
    • Cache
    • Database
    • Http
    • Log
    • Orm
  • None
  • PHP
  • Psr
    • Cache
    • Http
      • Message
    • Log

Classes

  • Db
  • DbCache
  • Driver
  • PdoMysqlDriver
  • Query
  • QueryBuilder
  • Schema
  • Sql

Exceptions

  • Exception
  • Overview
  • Namespace
  • Class
  • Tree

Class Driver

Kotchasan Database driver Class (base class)

Kotchasan\KBase
Extended by Kotchasan\Database\Db
Extended by Kotchasan\Database\Query
Extended by Kotchasan\Database\Driver

Direct known subclasses

Kotchasan\Database\PdoMysqlDriver
Abstract
Namespace: Kotchasan\Database
Author: Goragod Wiriya admin@goragod.com
Since: 1.0
Located at Kotchasan/Database/Driver.php
Methods summary
public
# __construct( )

Class constructor

Class constructor

Overrides

Kotchasan\Database\Db::__construct()
public integer
# cacheGetAction( )

อ่านสถานะของแคช 0 ไม่ใช้แคช 1 โหลดและบันทึกแคชอัตโนมัติ 2 โหลดข้อมูลจากแคชได้ แต่ไม่บันทึกแคชอัตโนมัติ

อ่านสถานะของแคช 0 ไม่ใช้แคช 1 โหลดและบันทึกแคชอัตโนมัติ 2 โหลดข้อมูลจากแคชได้ แต่ไม่บันทึกแคชอัตโนมัติ

Returns

integer
public static
# cacheOn( boolean $auto_save = true )

เปิดการใช้งานแคช จะมีการตรวจสอบจากแคชก่อนการสอบถามข้อมูล

เปิดการใช้งานแคช จะมีการตรวจสอบจากแคชก่อนการสอบถามข้อมูล

Parameters

$auto_save
(options) true (default) บันทึกผลลัพท์อัตโนมัติ, false ต้องบันทึกแคชเอง

Returns

static
public boolean
# cacheSave( array $datas )

ฟังก์ชั่นบันทึก Cache สำเร็จคืนค่า true ไม่สำเร็จคืนค่า false

ฟังก์ชั่นบันทึก Cache สำเร็จคืนค่า true ไม่สำเร็จคืนค่า false

Parameters

$datas
ข้อมูลที่จะบันทึก

Returns

boolean
public
# close( )

close database

close database
public resource
# connection( )

ฟังก์ชั่นอ่านค่า resource ID ของการเชื่อมต่อปัจจุบัน

ฟังก์ชั่นอ่านค่า resource ID ของการเชื่อมต่อปัจจุบัน

Returns

resource
public Kotchasan\Database\QueryBuilder
# createQuery( )

ฟังก์ชั่นสร้าง query builder

ฟังก์ชั่นสร้าง query builder

Returns

Kotchasan\Database\QueryBuilder
public array
# customQuery( string $sql, boolean $toArray = false, array $values = array() )

ฟังก์ชั่นประมวลผลคำสั่ง SQL สำหรับสอบถามข้อมูล คืนค่าผลลัพท์เป็นแอเรย์ของข้อมูลที่ตรงตามเงื่อนไข คืนค่าผลการทำงานเป็น record ของข้อมูลทั้งหมดที่ตรงตามเงื่อนไข ไม่พบคืนค่าแอเรย์ว่าง

ฟังก์ชั่นประมวลผลคำสั่ง SQL สำหรับสอบถามข้อมูล คืนค่าผลลัพท์เป็นแอเรย์ของข้อมูลที่ตรงตามเงื่อนไข คืนค่าผลการทำงานเป็น record ของข้อมูลทั้งหมดที่ตรงตามเงื่อนไข ไม่พบคืนค่าแอเรย์ว่าง

Parameters

$sql
query string
$toArray
default false คืนค่าผลลัทเป็น Object, true คืนค่าเป็น Array
$values
ถ้าระบุตัวแปรนี้จะเป็นการบังคับใช้คำสั่ง prepare แทน query

Returns

array
public boolean
# databaseExists( string $database )

ฟังก์ชั่นตรวจสอบว่ามี database หรือไม่ คืนค่า true หากมีฐานข้อมูลนี้อยู่ ไม่พบคืนค่า false

ฟังก์ชั่นตรวจสอบว่ามี database หรือไม่ คืนค่า true หากมีฐานข้อมูลนี้อยู่ ไม่พบคืนค่า false

Parameters

$database
ชื่อฐานข้อมูล

Returns

boolean
public integer|boolean
# delete( string $table_name, mixed $condition, integer $limit = 1, string $operator = 'AND' )

ฟังก์ชั่นลบ record สำเร็จคืนค่าจำนวนแถวที่มีผล ไม่สำเร็จคืนค่า false

ฟังก์ชั่นลบ record สำเร็จคืนค่าจำนวนแถวที่มีผล ไม่สำเร็จคืนค่า false

Parameters

$table_name
ชื่อตาราง
$condition
query WHERE
$limit
จำนวนรายการที่ต้องการลบ 1 (default) รายการแรกที่เจอ, หมายถึงลบทุกรายการ
$operator
AND (default) หรือ OR

Returns

integer|boolean
public boolean
# emptyTable( string $table_name )

ฟังก์ชั่นลบข้อมูลทั้งหมดในตาราง คืนค่า true ถ้าสำเร็จ.

ฟังก์ชั่นลบข้อมูลทั้งหมดในตาราง คืนค่า true ถ้าสำเร็จ.

Parameters

$table_name
table name

Returns

boolean
public mixed
# execQuery( array $sqls, array $values = array(), boolean $debugger = false )

ฟังก์ชั่นประมวลผลคำสั่ง SQL จาก query builder

ฟังก์ชั่นประมวลผลคำสั่ง SQL จาก query builder

Parameters

$sqls
$values
ถ้าระบุตัวแปรนี้จะเป็นการบังคับใช้คำสั่ง prepare แทน query
$debugger
แสดงผล Query

Returns

mixed
abstract public integer
# fieldCount( )

จำนวนฟิลด์ทั้งหมดในผลลัพท์จากการ query

จำนวนฟิลด์ทั้งหมดในผลลัพท์จากการ query

Returns

integer
public boolean
# fieldExists( string $table_name, string $column_name )

ตรวจสอบคอลัมน์ของตารางว่ามีหรือไม่ คืนค่า true ถ้ามี คืนค่า false ถ้าไม่มี.

ตรวจสอบคอลัมน์ของตารางว่ามีหรือไม่ คืนค่า true ถ้ามี คืนค่า false ถ้าไม่มี.

Parameters

$table_name
ชื่อตาราง
$column_name
ชื่อคอลัมน์

Returns

boolean
public array
# find( string $table_name, mixed $condition, array $sort = array() )

ฟังก์ชั่น query ข้อมูล คืนค่าข้อมูลทุกรายการที่ตรงตามเงื่อนไข คืนค่า แอเรย์ของ object ไม่พบคืนค่าแอรย์ว่าง.

ฟังก์ชั่น query ข้อมูล คืนค่าข้อมูลทุกรายการที่ตรงตามเงื่อนไข คืนค่า แอเรย์ของ object ไม่พบคืนค่าแอรย์ว่าง.

Parameters

$table_name
ชื่อตาราง
$condition
query WHERE
$sort
เรียงลำดับ

Returns

array
public object|boolean
# first( string $table_name, mixed $condition )

ฟังก์ชั่น query ข้อมูล คืนค่าข้อมูลรายการเดียว คืนค่า object ของข้อมูล ไม่พบคืนค่า false

ฟังก์ชั่น query ข้อมูล คืนค่าข้อมูลรายการเดียว คืนค่า object ของข้อมูล ไม่พบคืนค่า false

Parameters

$table_name
ชื่อตาราง
$condition
query WHERE

Returns

object|boolean
public string
# getError( )

คืนค่าข้อความผิดพลาดของฐานข้อมูล

คืนค่าข้อความผิดพลาดของฐานข้อมูล

Returns

string
abstract public array
# getFields( )

รายชื่อฟิลด์ทั้งหมดจากผลัพท์จองการ query

รายชื่อฟิลด์ทั้งหมดจากผลัพท์จองการ query

Returns

array
public integer
# getNextId( string $table_name, string $primary_key = 'id' )

ฟังก์ชั่นคืนค่า ID ล่าสุดของตาราง + 1 ใช้สำหรับอ่าน ID ถัดไปของตาราง (Auto Increment)

ฟังก์ชั่นคืนค่า ID ล่าสุดของตาราง + 1 ใช้สำหรับอ่าน ID ถัดไปของตาราง (Auto Increment)

Parameters

$table_name
ชื่อตาราง
$primary_key
ชื่อคอลัมน์ที่ต้องการอ่าน

Returns

integer
public boolean
# indexExists( string $database_name, string $table_name, string $index )

ตรวจสอบว่ามี $index ในตารางหรือไม่ คืนค่า true ถ้ามี คืนค่า false ถ้าไม่มี

ตรวจสอบว่ามี $index ในตารางหรือไม่ คืนค่า true ถ้ามี คืนค่า false ถ้าไม่มี

Parameters

$database_name
$table_name
$index

Returns

boolean
abstract public integer|boolean
# insert( string $table_name, array $save )

ฟังก์ชั่นเพิ่มข้อมูลใหม่ลงในตาราง สำเร็จ คืนค่า id ที่เพิ่ม ผิดพลาด คืนค่า false

ฟังก์ชั่นเพิ่มข้อมูลใหม่ลงในตาราง สำเร็จ คืนค่า id ที่เพิ่ม ผิดพลาด คืนค่า false

Parameters

$table_name
ชื่อตาราง
$save
ข้อมูลที่ต้องการบันทึก

Returns

integer|boolean
abstract public integer|null
# insertOrUpdate( string $table_name, array|object $save )

ฟังก์ชั่นเพิ่มข้อมูลใหม่ลงในตาราง ถ้ามีข้อมูลเดิมอยู่แล้วจะเป็นการอัปเดต (ข้อมูลเดิมตาม KEY ที่เป็น UNIQUE) insert คืนค่า id ที่เพิ่ม update คืนค่า 0 ผิดพลาด คืนค่า null

ฟังก์ชั่นเพิ่มข้อมูลใหม่ลงในตาราง ถ้ามีข้อมูลเดิมอยู่แล้วจะเป็นการอัปเดต (ข้อมูลเดิมตาม KEY ที่เป็น UNIQUE) insert คืนค่า id ที่เพิ่ม update คืนค่า 0 ผิดพลาด คืนค่า null

Parameters

$table_name
ชื่อตาราง
$save
ข้อมูลที่ต้องการบันทึก รูปแบบ array('key1'=>'value1', 'key2'=>'value2', ...)

Returns

integer|null
abstract public string
# makeQuery( array $sqls )

ฟังก์ชั่นสร้างคำสั่ง sql query คืนค่า sql command

ฟังก์ชั่นสร้างคำสั่ง sql query คืนค่า sql command

Parameters

$sqls
คำสั่ง sql จาก query builder

Returns

string
abstract protected array|boolean
# doCustomQuery( string $sql, array $values = array() )

ประมวลผลคำสั่ง SQL สำหรับสอบถามข้อมูล คืนค่าผลลัพท์เป็นแอเรย์ของข้อมูลที่ตรงตามเงื่อนไข คืนค่าผลการทำงานเป็น record ของข้อมูลทั้งหมดที่ตรงตามเงื่อนไข หรือคืนค่า false หามีข้อผิดพลาด.

ประมวลผลคำสั่ง SQL สำหรับสอบถามข้อมูล คืนค่าผลลัพท์เป็นแอเรย์ของข้อมูลที่ตรงตามเงื่อนไข คืนค่าผลการทำงานเป็น record ของข้อมูลทั้งหมดที่ตรงตามเงื่อนไข หรือคืนค่า false หามีข้อผิดพลาด.

Parameters

$sql
query string
$values
ถ้าระบุตัวแปรนี้จะเป็นการบังคับใช้คำสั่ง prepare แทน query

Returns

array|boolean
abstract protected integer|boolean
# doQuery( string $sql, array $values = array() )

ประมวลผลคำสั่ง SQL ที่ไม่ต้องการผลลัพท์ เช่น CREATE INSERT UPDATE สำเร็จคืนค่าจำนวนแถวที่มีผล ไม่สำเร็จคืนค่า false.

ประมวลผลคำสั่ง SQL ที่ไม่ต้องการผลลัพท์ เช่น CREATE INSERT UPDATE สำเร็จคืนค่าจำนวนแถวที่มีผล ไม่สำเร็จคืนค่า false.

Parameters

$sql
$values
ถ้าระบุตัวแปรนี้จะเป็นการบังคับใช้คำสั่ง prepare แทน query

Returns

integer|boolean
public boolean
# optimizeTable( string $table_name )

ปรับปรุงตาราง คืนค่า true ถ้าสำเร็จ

ปรับปรุงตาราง คืนค่า true ถ้าสำเร็จ

Parameters

$table_name
table name

Returns

boolean
public boolean
# query( string $sql, array $values = array() )

ฟังก์ชั่นประมวลผลคำสั่ง SQL ที่ไม่ต้องการผลลัพท์ เช่น CREATE INSERT UPDATE สำเร็จคืนค่า true ไม่สำเร็จคืนค่า false

ฟังก์ชั่นประมวลผลคำสั่ง SQL ที่ไม่ต้องการผลลัพท์ เช่น CREATE INSERT UPDATE สำเร็จคืนค่า true ไม่สำเร็จคืนค่า false

Parameters

$sql
$values
ถ้าระบุตัวแปรนี้จะเป็นการบังคับใช้คำสั่ง prepare แทน query

Returns

boolean
public static integer
# queryCount( )

ฟังก์ชั่นอ่านจำนวน query ทั้งหมดที่ทำงาน.

ฟังก์ชั่นอ่านจำนวน query ทั้งหมดที่ทำงาน.

Returns

integer
public boolean
# repairTable( string $table_name )

ซ่อมแซมตาราง คืนค่า true ถ้าสำเร็จ.

ซ่อมแซมตาราง คืนค่า true ถ้าสำเร็จ.

Parameters

$table_name
table name

Returns

boolean
abstract public array
# select( string $table_name, mixed $condition, array $sort = array(), integer $limit = 0 )

เรียกดูข้อมูล คืนค่าผลลัพท์ในรูป array ถ้าไม่สำเร็จ คืนค่าแอเรย์ว่าง.

เรียกดูข้อมูล คืนค่าผลลัพท์ในรูป array ถ้าไม่สำเร็จ คืนค่าแอเรย์ว่าง.

Parameters

$table_name
ชื่อตาราง
$condition
query WHERE
$sort
เรียงลำดับ
$limit
จำนวนข้อมูลที่ต้องการ

Returns

array
abstract public boolean
# selectDB( string $database )

เลือกฐานข้อมูล คืนค่า false หากไม่สำเร็จ.

เลือกฐานข้อมูล คืนค่า false หากไม่สำเร็จ.

Parameters

$database

Returns

boolean
public boolean
# tableExists( string $table_name )

ฟังก์ชั่นตรวจสอบว่ามีตาราง หรือไม่ คืนค่า true หากมีตารางนี้อยู่ ไม่พบคืนค่า false.

ฟังก์ชั่นตรวจสอบว่ามีตาราง หรือไม่ คืนค่า true หากมีตารางนี้อยู่ ไม่พบคืนค่า false.

Parameters

$table_name
ชื่อตาราง

Returns

boolean
abstract public boolean
# update( string $table_name, mixed $condition, array $save )

ฟังก์ชั่นแก้ไขข้อมูล สำเร็จ คืนค่า true, ผิดพลาด คืนค่า false.

ฟังก์ชั่นแก้ไขข้อมูล สำเร็จ คืนค่า true, ผิดพลาด คืนค่า false.

Parameters

$table_name
ชื่อตาราง
$condition
query WHERE
$save
ข้อมูลที่ต้องการบันทึก รูปแบบ array('key1'=>'value1', 'key2'=>'value2', ...)

Returns

boolean
public boolean
# updateAll( string $table_name, array $save )

อัปเดตข้อมูลทุก record สำเร็จ คืนค่า true, ผิดพลาด คืนค่า false.

อัปเดตข้อมูลทุก record สำเร็จ คืนค่า true, ผิดพลาด คืนค่า false.

Parameters

$table_name
table name
$save
ข้อมูลที่ต้องการบันทึก array('key1'=>'value1', 'key2'=>'value2', ...)

Returns

boolean
protected
# log( string $type, string $sql, array $values = array() )

ฟังก์ชั่นบันทึกการ query sql.

ฟังก์ชั่นบันทึกการ query sql.

Parameters

$type
$sql
$values
(options)
Methods inherited from Kotchasan\Database\Query
aliasName(), buildGroup(), buildJoin(), buildOrder(), buildSelect(), buildValue(), buildWhere(), buildWhereValues(), debug(), fieldName(), fieldValue(), getFullTableName(), getTableName(), groupAnd(), groupOr(), quoteTableName(), text()
Methods inherited from Kotchasan\Database\Db
db(), getSetting()
Properties summary
protected Kotchasan\Database\DbCache $cache

cache class

cache class
#
protected Kotchasan\Cache\CacheItem $cache_item

Cacheitem

Cacheitem
#
protected object $connection

database connection

database connection
# null
protected string $error_message

database error message

database error message
# ''
protected static integer $query_count

นับจำนวนการ query

นับจำนวนการ query
# 0
protected resource|object $result_id

เก็บ Object ที่เป็นผลลัพท์จากการ query

เก็บ Object ที่เป็นผลลัพท์จากการ query
#
protected array $sqls

ตัวแปรเก็บ query สำหรับการ execute

ตัวแปรเก็บ query สำหรับการ execute
#
Properties inherited from Kotchasan\Database\Query
$debugger
Properties inherited from Kotchasan\Database\Db
$db
Properties inherited from Kotchasan\KBase
$cfg, $request
Kotchasan API documentation generated by ApiGen