Modelos e banco de dados

<?php
// src/Models/productos.php
Koshkil::Uses('sys.db.model');
Koshkil::UsesModel('categorias');

class TModelProductos extends TModel {

    protected $tableName = 'tbl_productos';
    public $primaryKeyColumn = 'prd_codigo';

    // Somente estes campos são atribuídos com create(), fill() e update()
    protected $fillable = ['cat_codigo', 'prd_nombre', 'prd_precio', 'prd_destacado', 'prd_alta', 'prd_datos'];

    protected $dates = ['prd_alta'];   // exibidos como dd/mm/aaaa e gravados como aaaa-mm-dd
    protected $json  = ['prd_datos'];  // decodificado para array na leitura

    protected function setupTableStructure() {
        $this->table->id('prd_codigo')
            ->varchar('prd_nombre', 120, false, '')
            ->decimal('prd_precio', 10, 2, false, 0)
            ->enum('prd_destacado', ['0', '1'], false, '0')
            ->datetime('prd_alta')
            ->text('prd_datos')
            ->belongsTo('categorias')                  // adiciona cat_codigo + chave estrangeira
            ->addKey('idx_prd_nombre', 'prd_nombre');
    }

    // Método próprio: usado como $producto->precioConIva()
    public function precioConIva() {
        return round($this->prd_precio * 1.21, 2);
    }
}

Koshkil::UsesModel('productos');            // inclui o arquivo e cria o apelido TMProductos
Koshkil::UsesModel('noticias.noticias');    // modelo de um plugin -> TMNoticias

$this->table
    ->addKey('idx_email', 'usr_email')
    ->addKey('idx_composta', ['cat_codigo', 'prd_nombre'])
    ->engine('InnoDB')
    ->charset('utf8mb4')
    ->collate('utf8mb4_unicode_ci')
    ->initialRecords([
        ['cat_nombre' => 'Geral'],
        ['cat_nombre' => 'Ofertas'],
    ]);

// Criar: retorna o registro criado (com sua chave primária)
$producto = TMProductos::create([
    'prd_nombre' => 'Notebook 14"',
    'prd_precio' => 850000,
    'prd_alta'   => date('d/m/Y H:i:s'),
]);

// Ler
$producto = TMProductos::find(15);                   // pela chave primária, ou null
$producto->prd_nombre;                               // como propriedade
$producto['prd_nombre'];                             // ou como array
$producto->record();                                 // todos os campos em um array

// Atualizar
$producto->fill(['prd_precio' => 799000])->update();
$producto->prd_destacado = '1';
$producto->update();

// Apagar
$producto->delete();                                 // respeita readOnly e comportamentos
if ($categoria->canDelete()) {                       // tem registros dependentes?
    $categoria->cascadeDelete();                     // apaga também os dependentes
}

// Operações em massa (uma única instrução, sem eventos)
TMProductos::updateAll(['prd_destacado' => '0'], ['cat_codigo' => 3]);
TMProductos::deleteAll(['cat_codigo' => [7, 8]]);    // um array vira IN (…)

$lista = TMProductos::where('prd_destacado', '1')
    ->where('prd_precio', '<', 100000)
    ->order('prd_nombre', 'ASC')
    ->take(12)
    ->get();                         // TCollection de TMProductos

foreach ($lista as $producto) {
    echo $producto->prd_nombre;
}

$pagina  = TMProductos::order('prd_nombre')->pageSize(20)->page(2)->get();
$paginas = ceil($pagina->totalRecords / 20);

TMUsuarios::where('usr_email', $this->Request->email)->first();          // escapado pelo where()
TMProductos::where('prd_nombre', 'like', "%{$this->Request->q}%")->get();
TMProductos::where('cat_codigo', [$a, $b, $c])->get();                    // cada elemento é escapado

$q = Koshkil::escapeString($this->Request->q);
$qb->where("MATCH(prd_nombre) AGAINST ('{$q}')");
$qb->where("FIND_IN_SET(" . intval($this->Request->grupo) . ", prd_grupos)");
$qb->where('p.cat_codigo = ' . Koshkil::quote($this->Request->categoria));

// Em TModelProductos: cada produto pertence a uma categoria
$this->table->belongsTo('categorias');
// cria a coluna cat_codigo (inteiro, chave primária de categorias), sua chave
// estrangeira e o método $producto->categoria() (nome do modelo no singular)

// Em TModelCategorias: uma categoria tem muitos produtos
$this->table->hasMany('productos', ['foreignKey' => 'cat_codigo', 'virtualMethodName' => 'productos', 'orderBy' => ['prd_nombre' => 'ASC']]);

// Um para um com condições extras
$this->table->hasOne('galeria', [
    'foreignKey'        => 'gal_relacionado',
    'columnName'        => 'usr_codigo',
    'virtualMethodName' => 'imagenPerfil',
    'where'             => [['gal_grupo', 'usuarios'], ['gal_uso', 'profile']],
]);

$categoria = TMCategorias::find(3);
foreach ($categoria->productos() as $producto) { … }
$foto = $usuario->imagenPerfil();

class TModelProductos extends TModel {
    public function productos_event_precreate($record) {
        $record->prd_alta = date('d/m/Y H:i:s');
        return $record;
    }
}

Koshkil::uses('sys.db.traits.hierarchy');
Koshkil::uses('sys.db.traits.ownable');

class TModelCategorias extends TModel {
    use THierarchyTrait, TOwnableTrait;

    protected function setupTableStructure() {
        $this->parentField = 'cat_parent';     // a coluna é adicionada pelo trait
        $this->textField   = 'cat_nombre';
        $this->table->id('cat_codigo')->varchar('cat_nombre', 45, false, '');
    }
}

<?php
// src/Models/Behaviors/Publicable.php
Koshkil::uses('sys.db.behavior');

class PublicableBehavior extends Behavior {
    public function publicar() {
        $this->record->fill(['pub_estado' => '1'])->update();
    }
}

class TModelArticulos extends TModel {
    protected $behaviors = ['publicable'];
}

TMArticulos::find(4)->publicar();

<?php
// src/Migrations/20260425120000_create_personal_negocios_table.php
class Migration20260425120000 {
    public function up() {
        Koshkil::$db->execute("CREATE TABLE IF NOT EXISTS `tbl_personal_negocios` (…)");
    }
    public function down() {
        Koshkil::$db->execute("DROP TABLE IF EXISTS `tbl_personal_negocios`");
    }
}

$db = Koshkil::getDatabase();
$db->execute("UPDATE tbl_productos SET prd_precio = prd_precio * 1.1");
$linha = $db->getRow("SELECT COUNT(*) AS total FROM tbl_productos");
$res   = $db->getRecords("SELECT * FROM tbl_productos WHERE cat_codigo = 3"); // ['data' => […], 'records' => N]
$db->performTransaction([$sql1, $sql2]);
$db->escape($texto);                  // com PDO retorna o valor já entre aspas
Koshkil::escapeString($texto);        // igual com qualquer driver, sem aspas
Koshkil::quote($texto);               // 'texto'
$db->lastInsertId();