Modelos y base de datos

<?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';

    // Solo estos campos se asignan con create(), fill() y update()
    protected $fillable = ['cat_codigo', 'prd_nombre', 'prd_precio', 'prd_destacado', 'prd_alta', 'prd_datos'];

    protected $dates = ['prd_alta'];   // se muestran como dd/mm/aaaa y se guardan como aaaa-mm-dd
    protected $json  = ['prd_datos'];  // se decodifica a arreglo al leer

    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')                  // agrega cat_codigo + clave foránea
            ->addKey('idx_prd_nombre', 'prd_nombre');
    }

    // Método propio: se usa como $producto->precioConIva()
    public function precioConIva() {
        return round($this->prd_precio * 1.21, 2);
    }
}

Koshkil::UsesModel('productos');            // incluye el archivo y crea el alias TMProductos
Koshkil::UsesModel('noticias.noticias');    // modelo de un plugin -> TMNoticias

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

// Crear: devuelve el registro creado (con su clave primaria)
$producto = TMProductos::create([
    'prd_nombre' => 'Notebook 14"',
    'prd_precio' => 850000,
    'prd_alta'   => date('d/m/Y H:i:s'),
]);

// Leer
$producto = TMProductos::find(15);                   // por clave primaria, o null
$producto->prd_nombre;                               // como propiedad
$producto['prd_nombre'];                             // o como arreglo
$producto->record();                                 // todos los campos en un arreglo

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

// Borrar
$producto->delete();                                 // respeta readOnly y comportamientos
if ($categoria->canDelete()) {                       // ¿tiene registros dependientes?
    $categoria->cascadeDelete();                     // borra también los dependientes
}

// Operaciones masivas (una sola sentencia, sin eventos)
TMProductos::updateAll(['prd_destacado' => '0'], ['cat_codigo' => 3]);
TMProductos::deleteAll(['cat_codigo' => [7, 8]]);    // un arreglo se convierte en 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 por where()
TMProductos::where('prd_nombre', 'like', "%{$this->Request->q}%")->get();
TMProductos::where('cat_codigo', [$a, $b, $c])->get();                    // cada elemento se escapa

$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));

// En TModelProductos: cada producto pertenece a una categoría
$this->table->belongsTo('categorias');
// crea la columna cat_codigo (entero, clave primaria de categorías), su clave
// foránea y el método $producto->categoria() (nombre del modelo en singular)

// En TModelCategorias: una categoría tiene muchos productos
$this->table->hasMany('productos', ['foreignKey' => 'cat_codigo', 'virtualMethodName' => 'productos', 'orderBy' => ['prd_nombre' => 'ASC']]);

// Uno a uno con condiciones extra
$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';     // la columna la agrega el 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");
$fila = $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);                  // con PDO devuelve el valor ya entre comillas
Koshkil::escapeString($texto);        // igual con cualquier driver, sin comillas
Koshkil::quote($texto);               // 'texto'
$db->lastInsertId();