เอกสารประกอบการใช้งาน Kotchasan Framework

Kotchasan Framework เป็นเฟรมเวิร์ก PHP ที่ทรงพลังและยืดหยุ่น ออกแบบมาเพื่อพัฒนาเว็บแอปพลิเคชันประสิทธิภาพสูง รองรับระบบฐานข้อมูลหลายประเภท ได้แก่ MySQL, PostgreSQL, MSSQL และ SQLite

ภาพรวมเฟรมเวิร์ก

คุณสมบัติเด่นของ Kotchasan Framework:

• สถาปัตยกรรม MVC - รูปแบบสถาปัตยกรรมที่ชัดเจนและเป็นมาตรฐาน
• Database Abstraction - รองรับฐานข้อมูลหลากหลายประเภท
• ความปลอดภัยเป็นอันดับแรก - มีฟีเจอร์ความปลอดภัยในตัวที่แข็งแกร่ง
• เพิ่มประสิทธิภาพสูงสุด - ออกแบบมาเพื่อให้ทำงานได้รวดเร็ว
• เป็นมิตรกับนักพัฒนา - เรียนรู้และใช้งานง่าย

คู่มือเริ่มต้นใช้งาน

📚 คู่มือพื้นฐานที่จำเป็น

• การติดตั้งและการตั้งค่า
• คู่มือการใช้งานฐานข้อมูล
• คู่มือสถาปัตยกรรม MVC
• บทช่วยสอนการพัฒนาเว็บเบื้องต้น
• ตัวอย่างการนำไปใช้งานจริง (แนะนำ)

🏗️ สถาปัตยกรรมและรูปแบบ

• รูปแบบ MVC - Model-View-Controller
• เลเยอร์ฐานข้อมูล - การจัดการฐานข้อมูล
• การจัดการ Request/Response - การจัดการ HTTP
• ระบบ Routing - การจัดการ URL Routing

ข้อมูลอ้างอิง API

🗄️ ระบบฐานข้อมูล

• Database - คลาสหลักของฐานข้อมูล
• DB - ตัวช่วย (Helper) จัดการฐานข้อมูล
• Model - คลาส Model พื้นฐาน
• QueryBuilder - เครื่องมือสร้างคำสั่ง SQL
  • SelectBuilder
  • InsertBuilder
  • UpdateBuilder
  • DeleteBuilder

🔗 การเชื่อมต่อฐานข้อมูล

• Connection - การเชื่อมต่อฐานข้อมูล
• ConnectionManager - การจัดการการเชื่อมต่อ
• MySQL Driver
• PostgreSQL Driver
• MSSQL Driver
• SQLite Driver

🚀 ระบบ Cache

• ภาพรวม Cache - ภาพรวมระบบ Cache
• CacheFactory - โรงงานสร้าง Cache
• FileCache - Cache แบบไฟล์
• MemoryCache - Cache ในหน่วยความจำ
• RedisCache - Redis Cache
• QueryCache - Cache ผลการค้นหาข้อมูล

🌐 HTTP และ Web

• Controller - Controller พื้นฐาน
• ApiController - ตัวควบคุม API
• View - การจัดการมุมมอง (View)
• Request - คำขอ HTTP (Request)
• Response - การตอบกลับ HTTP (Response)
• Router - การจัดการเส้นทาง URL

🔐 ความปลอดภัยและการยืนยันตัวตน

• Login - ระบบเข้าสู่ระบบ
• Password - การจัดการรหัสผ่าน
• Session - การจัดการ Session
• JWT - JSON Web Token

📝 แบบฟอร์มและการตรวจสอบข้อมูล

• Form - การสร้างฟอร์ม
• Input - การจัดการข้อมูลนำเข้า
• Validator - การตรวจสอบความถูกต้องของข้อมูล (Validation)

🛠️ เครื่องมือและยูทิลิตี้

• ArrayTool - เครื่องมือจัดการอาร์เรย์
• Collection - คลาส Collection
• Text - การประมวลผลข้อความ
• Date - การจัดการวันที่และเวลา
• Number - การประมวลผลตัวเลข
• File - การจัดการไฟล์
• Files - การจัดการไฟล์หลายไฟล์
• Image - การประมวลผลรูปภาพ
• Template - ระบบเทมเพลต
• Menu - การสร้างเมนู
• Tab - อินเทอร์เฟซแบบแท็บ
• ListItem - การจัดการรายการ

📧 การสื่อสารและการส่งออกข้อมูล

• Email - การส่งอีเมล
• Pdf - การสร้าง PDF
• Csv - การจัดการ CSV
• Curl - HTTP Client
• Barcode - การสร้างบาร์โค้ด

🌍 การแปลภาษาและข้อมูลท้องถิ่น

• Language - การจัดการภาษา
• Country - ข้อมูลประเทศ
• Province - ข้อมูลจังหวัด
• Currency - การจัดการสกุลเงิน

📋 การบันทึกและการตรวจสอบ (Logging)

• Logger Overview - ภาพรวมระบบ Logger
• Logger - คลาส Logger
  • FileLogger
  • ConsoleLogger
  • QueryLogger
  • SystemLogger

การติดตั้ง

ความต้องการของระบบ

• PHP 7.4 ขึ้นไป
• Web Server (Apache, Nginx)
• Database (MySQL, PostgreSQL, MSSQL, หรือ SQLite)
• Composer

การติดตั้งด้วยตนเอง (แนะนำ)

1. ดาวน์โหลดไฟล์จาก GitHub
2. แตกไฟล์ไปยังโฟลเดอร์เว็บของคุณ
3. ตั้งค่าสิทธิ์การเขียนสำหรับโฟลเดอร์ datas/ ให้สามารถเขียนได้ (Write permissions)

ติดตั้งผ่าน Composer

composer create-project kotchasan/kotchasan myproject
cd myproject

การตั้งค่าเริ่มต้น

// settings/database.php
return [
    'default' => [
        'driver' => 'mysql',
        'host' => 'localhost',
        'database' => 'mydatabase',
        'username' => 'root',
        'password' => 'password',
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
    ]
];

การใช้งานพื้นฐาน

การสร้าง Database Instance

use Kotchasan\Database;

// Create database instance
$db = Database::create();

// Fetch data
$users = $db->select('*')
    ->from('users')
    ->where('status', '=', 'active')
    ->execute();

การสร้าง Controller

namespace MyApp\Home;

use Kotchasan\Http\Request;

class Controller extends \Kotchasan\Controller
{
    public function render(Request $request)
    {
        $view = new View();
        return $view->render();
    }
}

การสร้าง Model

namespace MyApp\User;

use Kotchasan\Model;

class Model extends \Kotchasan\Model
{
    protected $table = 'users';

    public function getAllUsers()
    {
        return $this->db->select('*')
            ->from($this->table)
            ->where('status', '=', 'active')
            ->execute();
    }
}

ตัวอย่างการใช้งาน

การทำงานกับ CRUD (Create, Read, Update, Delete)

use Kotchasan\Database;

$db = Database::create();

// Create
$userId = $db->insert('users')
    ->values([
        'name' => 'John Doe',
        'email' => 'john@example.com'
    ])
    ->execute();

// Read
$user = $db->select('*')
    ->from('users')
    ->where('id', '=', $userId)
    ->first();

// Update
$db->update('users')
    ->set(['name' => 'Jane Doe'])
    ->where('id', '=', $userId)
    ->execute();

// Delete
$db->delete('users')
    ->where('id', '=', $userId)
    ->execute();

การใช้งาน Cache

use Kotchasan\Cache\FileCache;

$cache = new FileCache(['path' => ROOT_PATH . '/datas/cache/']);

// Store cache
$cache->set('user_list', $users, 3600);

// Retrieve cache
$cachedUsers = $cache->get('user_list');

การทำ Transaction

$db->beginTransaction();

try {
    $db->insert('users')->values(['name' => 'John'])->execute();
    $db->update('accounts')->set(['balance' => 100])->execute();

    $db->commit();
} catch (\Exception $e) {
    $db->rollback();
    throw $e;
}

การจัดการข้อผิดพลาด (Error Handling)

use Kotchasan\Exception\DatabaseException;

try {
    $result = $db->select('*')->from('users')->execute();
} catch (DatabaseException $e) {
    echo "Error: " . $e->getMessage();
    echo "SQL: " . $e->getQuery();
}

แหล่งข้อมูลเพิ่มเติม

• 🌐 เว็บไซต์อย่างเป็นทางการ
• 📖 เอกสารออนไลน์
• 💬 ชุมชนผู้ใช้
• 🐛 แจ้งปัญหาการใช้งาน
• 📧 ติดต่อฝ่ายสนับสนุน

การสนับสนุน

หากคุณต้องการความช่วยเหลือ:

1. อ่านเอกสารนี้และ FAQ
2. ค้นหาคำตอบในชุมชนผู้ใช้
3. สร้าง Issue บน GitHub
4. ติดต่อทีมพัฒนา

หมายเหตุ: เอกสารนี้ได้รับการอัปเดตสำหรับ Kotchasan Framework เวอร์ชันล่าสุด หากคุณพบข้อผิดพลาดหรือต้องการเพิ่มข้อมูล โปรดแจ้งให้เราทราบ