kj/duckbrain
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

BREAKING CHANGE: Adhere to PSR-12 coding standards.

Browse Source 
- Model: where_in method was renamed as whereIn.
This commit is contained in:
kj
2025-09-07 11:07:07 -03:00
parent 0f46848d15
commit c9f467345b
10 changed files with 480 additions and 401 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
config.php
View File

@ -1,4 +1,5 @@
<?php <?php
// Configuración de la base de datos // Configuración de la base de datos
define('DB_TYPE', 'mysql'); define('DB_TYPE', 'mysql');
define('DB_HOST', 'localhost'); define('DB_HOST', 'localhost');

7
index.php
View File

@ -1,4 +1,5 @@
<?php <?php
require_once('config.php'); require_once('config.php');
// Incluir clases // Incluir clases
@ -7,14 +8,16 @@ spl_autoload_register(function ($className) {
$name = basename($fp); $name = basename($fp);
$dir = dirname($fp); $dir = dirname($fp);
$file = ROOT_CORE . '/' . $dir . '/' . $name . '.php'; $file = ROOT_CORE . '/' . $dir . '/' . $name . '.php';
if (file_exists($file)) if (file_exists($file)) {
require_once $file; require_once $file;
}
}); });
// Incluir routers // Incluir routers
$routers = glob(ROOT_CORE . '/Routers/*.php'); $routers = glob(ROOT_CORE . '/Routers/*.php');
foreach($routers as $file) foreach ($routers as $file) {
require_once($file); require_once($file);
}
\Libs\Router::apply(); \Libs\Router::apply();

33
src/Libs/Database.php
View File

@ -1,4 +1,11 @@
<?php <?php
namespace Libs;
use Exception;
use PDO;
use PDOException;
/** /**
* Database - DuckBrain * Database - DuckBrain
* *
@ -8,38 +15,33 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
class Database extends PDO
{
private static array $databases = [];
namespace Libs; private function __construct()
{
use PDO; }
use PDOException;
use Exception;
class Database extends PDO {
static private array $databases = [];
private function __construct() {}
/** /**
* Devuelve una instancia homogénea (singlenton) de la base de datos (PDO). * Devuelve una instancia homogénea (singlenton) de la base de datos (PDO).
* *
* @return PDO * @return PDO
*/ */
static public function getInstance( public static function getInstance(
string $type = 'mysql', string $type = 'mysql',
string $host = 'localhost', string $host = 'localhost',
string $name = '', string $name = '',
string $user = '', string $user = '',
string $pass = '', string $pass = '',
): PDO ): PDO {
{
$key = $type . '/' . $host . '/' . $name . '/' . $user; $key = $type . '/' . $host . '/' . $name . '/' . $user;
if (empty(static::$databases[$key])) { if (empty(static::$databases[$key])) {
if ($type == 'sqlite') { if ($type == 'sqlite') {
$dsn = $type . ':' . $name; $dsn = $type . ':' . $name;
} else } else {
$dsn = $type . ':dbname=' . $name . ';host=' . $host; $dsn = $type . ':dbname=' . $name . ';host=' . $host;
}
try { try {
static::$databases[$key] = new PDO($dsn, $user, $pass); static::$databases[$key] = new PDO($dsn, $user, $pass);
@ -55,4 +57,3 @@ class Database extends PDO {
return static::$databases[$key]; return static::$databases[$key];
} }
} }
?>

10
src/Libs/Middleware.php
View File

@ -1,4 +1,7 @@
<?php <?php
namespace Libs;
/** /**
* Middleware - DuckBrain * Middleware - DuckBrain
* *
@ -8,11 +11,8 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
class Middleware
namespace Libs; {
class Middleware {
/** /**
* Llama al siguiente callback. * Llama al siguiente callback.
* *

239
src/Libs/Model.php
View File

@ -1,4 +1,14 @@
<?php <?php
namespace Libs;
use AllowDynamicProperties;
use Exception;
use PDO;
use PDOException;
use ReflectionClass;
use ReflectionProperty;
/** /**
* Model - DuckBrain * Model - DuckBrain
* *
@ -10,27 +20,17 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
namespace Libs;
use Libs\Database;
use PDO;
use PDOException;
use Exception;
use ReflectionClass;
use ReflectionProperty;
use AllowDynamicProperties;
#[AllowDynamicProperties] #[AllowDynamicProperties]
class Model { class Model
{
protected array $toNull = []; protected array $toNull = [];
static protected string $primaryKey = 'id'; protected static string $primaryKey = 'id';
static protected array $ignoreSave = ['id']; protected static array $ignoreSave = ['id'];
static protected array $forceSave = []; protected static array $forceSave = [];
static protected string $table; protected static string $table;
static protected string $tableSufix = 's'; protected static string $tableSufix = 's';
static protected array $queryVars = []; protected static array $queryVars = [];
static protected array $querySelect = [ protected static array $querySelect = [
'select' => ['*'], 'select' => ['*'],
'where' => '', 'where' => '',
'from' => '', 'from' => '',
@ -39,7 +39,7 @@ class Model {
'innerJoin' => '', 'innerJoin' => '',
'orderBy' => '', 'orderBy' => '',
'groupBy' => '', 'groupBy' => '',
'limit' => '' 'limit' => '',
]; ];
/** /**
@ -49,12 +49,12 @@ class Model {
*/ */
protected static function db(): PDO protected static function db(): PDO
{ {
if (DB_TYPE == 'sqlite') if (DB_TYPE == 'sqlite') {
return Database::getInstance( return Database::getInstance(
type: DB_TYPE, type: DB_TYPE,
name: DB_NAME name: DB_NAME
); );
else } else {
return Database::getInstance( return Database::getInstance(
DB_TYPE, DB_TYPE,
DB_HOST, DB_HOST,
@ -63,6 +63,7 @@ class Model {
DB_PASS DB_PASS
); );
} }
}
/** /**
* Ejecuta PDO::beginTransaction para iniciar una transacción. * Ejecuta PDO::beginTransaction para iniciar una transacción.
@ -83,11 +84,12 @@ class Model {
*/ */
public static function rollBack(): bool public static function rollBack(): bool
{ {
if ( static::db()->inTransaction()) if (static::db()->inTransaction()) {
return static::db()->rollBack(); return static::db()->rollBack();
else } else {
return true; return true;
} }
}
/** /**
* Ejecuta PDO::commit para consignar una transacción. * Ejecuta PDO::commit para consignar una transacción.
@ -97,11 +99,12 @@ class Model {
*/ */
public static function commit(): bool public static function commit(): bool
{ {
if (static::db()->inTransaction()) if (static::db()->inTransaction()) {
return static::db()->commit(); return static::db()->commit();
else } else {
return true; return true;
} }
}
/** /**
* Ejecuta una sentencia SQL en la base de datos. * Ejecuta una sentencia SQL en la base de datos.
@ -128,8 +131,9 @@ class Model {
$prepared = $db->prepare($query); $prepared = $db->prepare($query);
$prepared->execute(static::$queryVars); $prepared->execute(static::$queryVars);
} catch (PDOException $e) { } catch (PDOException $e) {
if ($db->inTransaction()) if ($db->inTransaction()) {
$db->rollBack(); $db->rollBack();
}
$vars = json_encode(static::$queryVars); $vars = json_encode(static::$queryVars);
@ -143,8 +147,9 @@ class Model {
$result = $prepared->fetchAll(); $result = $prepared->fetchAll();
if ($resetQuery) if ($resetQuery) {
static::resetQuery(); static::resetQuery();
}
return $result; return $result;
} }
@ -164,7 +169,7 @@ class Model {
'innerJoin' => '', 'innerJoin' => '',
'orderBy' => '', 'orderBy' => '',
'groupBy' => '', 'groupBy' => '',
'limit' => '' 'limit' => '',
]; ];
static::$queryVars = []; static::$queryVars = [];
} }
@ -180,31 +185,39 @@ class Model {
{ {
$sql = 'SELECT ' . join(', ', static::$querySelect['select']); $sql = 'SELECT ' . join(', ', static::$querySelect['select']);
if (static::$querySelect['from'] != '') if (static::$querySelect['from'] != '') {
$sql .= ' FROM ' . static::$querySelect['from']; $sql .= ' FROM ' . static::$querySelect['from'];
else } else {
$sql .= ' FROM ' . static::table(); $sql .= ' FROM ' . static::table();
}
if(static::$querySelect['innerJoin'] != '') if (static::$querySelect['innerJoin'] != '') {
$sql .= static::$querySelect['innerJoin']; $sql .= static::$querySelect['innerJoin'];
}
if (static::$querySelect['leftJoin'] != '') if (static::$querySelect['leftJoin'] != '') {
$sql .= static::$querySelect['leftJoin']; $sql .= static::$querySelect['leftJoin'];
}
if(static::$querySelect['rightJoin'] != '') if (static::$querySelect['rightJoin'] != '') {
$sql .= static::$querySelect['rightJoin']; $sql .= static::$querySelect['rightJoin'];
}
if (static::$querySelect['where'] != '') if (static::$querySelect['where'] != '') {
$sql .= ' WHERE ' . static::$querySelect['where']; $sql .= ' WHERE ' . static::$querySelect['where'];
}
if (static::$querySelect['groupBy'] != '') if (static::$querySelect['groupBy'] != '') {
$sql .= ' GROUP BY ' . static::$querySelect['groupBy']; $sql .= ' GROUP BY ' . static::$querySelect['groupBy'];
}
if (static::$querySelect['orderBy'] != '') if (static::$querySelect['orderBy'] != '') {
$sql .= ' ORDER BY ' . static::$querySelect['orderBy']; $sql .= ' ORDER BY ' . static::$querySelect['orderBy'];
}
if (static::$querySelect['limit'] != '') if (static::$querySelect['limit'] != '') {
$sql .= ' LIMIT ' . static::$querySelect['limit']; $sql .= ' LIMIT ' . static::$querySelect['limit'];
}
return $sql; return $sql;
} }
@ -240,18 +253,19 @@ class Model {
protected static function getInstance(array $elem = []): static protected static function getInstance(array $elem = []): static
{ {
$class = get_called_class(); $class = get_called_class();
$instance = new $class; $instance = new $class();
$reflection = new ReflectionClass($instance); $reflection = new ReflectionClass($instance);
$properties = $reflection->getProperties(); $properties = $reflection->getProperties();
$propertyNames = array_column($properties, 'name'); $propertyNames = array_column($properties, 'name');
foreach ($elem as $key => $value) { foreach ($elem as $key => $value) {
$index = array_search($key, $propertyNames); $index = array_search($key, $propertyNames);
if (is_numeric($index) && enum_exists($properties[$index]->getType()->getName())) if (is_numeric($index) && enum_exists($properties[$index]->getType()->getName())) {
$instance->$key = $properties[$index]->getType()->getName()::tryfrom($value); $instance->$key = $properties[$index]->getType()->getName()::tryfrom($value);
else } else {
$instance->$key = $value; $instance->$key = $value;
} }
}
return $instance; return $instance;
} }
@ -271,24 +285,29 @@ class Model {
$properties = $reflection->getProperties(ReflectionProperty::IS_PUBLIC); $properties = $reflection->getProperties(ReflectionProperty::IS_PUBLIC);
$result = []; $result = [];
foreach($properties as $property) foreach ($properties as $property) {
$result[$property->name] = isset($this->{$property->name}) $result[$property->name] = isset($this->{$property->name})
? $this->{$property->name} : null; ? $this->{$property->name} : null;
}
foreach (static::$ignoreSave as $del) foreach (static::$ignoreSave as $del) {
unset($result[$del]); unset($result[$del]);
}
foreach (static::$forceSave as $value) foreach (static::$forceSave as $value) {
$result[$value] = isset($this->$value) $result[$value] = isset($this->$value)
? $this->$value : null; ? $this->$value : null;
}
foreach ($result as $i => $property) { foreach ($result as $i => $property) {
if (gettype($property) == 'boolean') if (gettype($property) == 'boolean') {
$result[$i] = $property ? '1' : '0'; $result[$i] = $property ? '1' : '0';
}
if ($property instanceof \UnitEnum) if ($property instanceof \UnitEnum) {
$result[$i] = $property->value; $result[$i] = $property->value;
} }
}
return $result; return $result;
} }
@ -302,7 +321,8 @@ class Model {
public static function className(): string public static function className(): string
{ {
return substr( return substr(
strrchr(get_called_class(), '\\'), 1 strrchr(get_called_class(), '\\'),
1
); );
} }
@ -315,12 +335,14 @@ class Model {
*/ */
protected static function table(): string protected static function table(): string
{ {
if (isset(static::$table)) if (isset(static::$table)) {
return static::$table; return static::$table;
}
return strtolower( return strtolower(
preg_replace( preg_replace(
'/(?<!^)[A-Z]/', '_$0', '/(?<!^)[A-Z]/',
'_$0',
static::className() static::className()
) )
) . static::$tableSufix; ) . static::$tableSufix;
@ -336,17 +358,18 @@ class Model {
foreach ($atts as $key => $value) { foreach ($atts as $key => $value) {
if (isset($value)) { if (isset($value)) {
if (in_array($key, $this->toNull)) if (in_array($key, $this->toNull)) {
$set[] = "$key=NULL"; $set[] = "$key=NULL";
else { } else {
$set[] = "$key=:$key"; $set[] = "$key=:$key";
static::$queryVars[':' . $key] = $value; static::$queryVars[':' . $key] = $value;
} }
} else { } else {
if (in_array($key, $this->toNull)) if (in_array($key, $this->toNull)) {
$set[] = "$key=NULL"; $set[] = "$key=NULL";
} }
} }
}
$table = static::table(); $table = static::table();
$pk = static::$primaryKey; $pk = static::$primaryKey;
@ -389,17 +412,19 @@ class Model {
public function save(): void public function save(): void
{ {
$pk = static::$primaryKey; $pk = static::$primaryKey;
if (isset($this->$pk)) if (isset($this->$pk)) {
$this->update(); $this->update();
else } else {
$this->add(); $this->add();
} }
}
/** /**
* Elimina el objeto actual de la base de datos. * Elimina el objeto actual de la base de datos.
* @return void * @return void
*/ */
public function delete(): void { public function delete(): void
{
$table = static::table(); $table = static::table();
$pk = static::$primaryKey; $pk = static::$primaryKey;
$sql = "DELETE FROM $table WHERE $pk=:$pk"; $sql = "DELETE FROM $table WHERE $pk=:$pk";
@ -461,8 +486,7 @@ class Model {
string $operatorOrValue, string $operatorOrValue,
?string $value = null, ?string $value = null,
bool $no_filter = false bool $no_filter = false
): static ): static {
{
return static::and( return static::and(
$column, $column,
$operatorOrValue, $operatorOrValue,
@ -494,20 +518,21 @@ class Model {
string $operatorOrValue, string $operatorOrValue,
?string $value = null, ?string $value = null,
bool $no_filter = false bool $no_filter = false
): static ): static {
{
if (is_null($value)) { if (is_null($value)) {
$value = $operatorOrValue; $value = $operatorOrValue;
$operatorOrValue = '='; $operatorOrValue = '=';
} }
if (!$no_filter) if (!$no_filter) {
$value = static::bindValue($value); $value = static::bindValue($value);
}
if (static::$querySelect['where'] == '') if (static::$querySelect['where'] == '') {
static::$querySelect['where'] = "$column $operatorOrValue $value"; static::$querySelect['where'] = "$column $operatorOrValue $value";
else } else {
static::$querySelect['where'] .= " AND $column $operatorOrValue $value"; static::$querySelect['where'] .= " AND $column $operatorOrValue $value";
}
return new static(); return new static();
} }
@ -535,20 +560,21 @@ class Model {
string $operatorOrValue, string $operatorOrValue,
?string $value = null, ?string $value = null,
bool $no_filter = false bool $no_filter = false
): static ): static {
{
if (is_null($value)) { if (is_null($value)) {
$value = $operatorOrValue; $value = $operatorOrValue;
$operatorOrValue = '='; $operatorOrValue = '=';
} }
if (!$no_filter) if (!$no_filter) {
$value = static::bindValue($value); $value = static::bindValue($value);
}
if (static::$querySelect['where'] == '') if (static::$querySelect['where'] == '') {
static::$querySelect['where'] = "$column $operatorOrValue $value"; static::$querySelect['where'] = "$column $operatorOrValue $value";
else } else {
static::$querySelect['where'] .= " OR $column $operatorOrValue $value"; static::$querySelect['where'] .= " OR $column $operatorOrValue $value";
}
return new static(); return new static();
} }
@ -567,26 +593,27 @@ class Model {
* *
* @return static * @return static
*/ */
public static function where_in( public static function whereIn(
string $column, string $column,
array $arr, array $arr,
bool $in = true bool $in = true
): static ): static {
{
$arrIn = []; $arrIn = [];
foreach ($arr as $value) { foreach ($arr as $value) {
$arrIn[] = static::bindValue($value); $arrIn[] = static::bindValue($value);
} }
if ($in) if ($in) {
$where_in = "$column IN (" . join(', ', $arrIn) . ")"; $where_in = "$column IN (" . join(', ', $arrIn) . ")";
else } else {
$where_in = "$column NOT IN (" . join(', ', $arrIn) . ")"; $where_in = "$column NOT IN (" . join(', ', $arrIn) . ")";
}
if (static::$querySelect['where'] == '') if (static::$querySelect['where'] == '') {
static::$querySelect['where'] = $where_in; static::$querySelect['where'] = $where_in;
else } else {
static::$querySelect['where'] .= " AND $where_in"; static::$querySelect['where'] .= " AND $where_in";
}
return new static(); return new static();
} }
@ -601,7 +628,8 @@ class Model {
* Columna a comparar para hacer el join. * Columna a comparar para hacer el join.
* *
* @param string $operatorOrColumnB * @param string $operatorOrColumnB
* Operador o columna a comparar como igual para hacer el join en caso de que $columnB no se defina. * Operador o columna a comparar como igual para hacer
* el join en caso de que $columnB no se defina.
* *
* @param string|null $columnB * @param string|null $columnB
* (opcional) Columna a comparar para hacer el join. * (opcional) Columna a comparar para hacer el join.
@ -613,8 +641,7 @@ class Model {
string $columnA, string $columnA,
string $operatorOrColumnB, string $operatorOrColumnB,
?string $columnB = null ?string $columnB = null
): static ): static {
{
if (is_null($columnB)) { if (is_null($columnB)) {
$columnB = $operatorOrColumnB; $columnB = $operatorOrColumnB;
$operatorOrColumnB = '='; $operatorOrColumnB = '=';
@ -635,7 +662,8 @@ class Model {
* Columna a comparar para hacer el join. * Columna a comparar para hacer el join.
* *
* @param string $operatorOrColumnB * @param string $operatorOrColumnB
* Operador o columna a comparar como igual para hacer el join en caso de que $columnB no se defina. * Operador o columna a comparar como igual para hacer
* el join en caso de que $columnB no se defina.
* *
* @param string|null $columnB * @param string|null $columnB
* (opcional) Columna a comparar para hacer el join. * (opcional) Columna a comparar para hacer el join.
@ -647,8 +675,7 @@ class Model {
string $columnA, string $columnA,
string $operatorOrColumnB, string $operatorOrColumnB,
?string $columnB = null ?string $columnB = null
): static ): static {
{
if (is_null($columnB)) { if (is_null($columnB)) {
$columnB = $operatorOrColumnB; $columnB = $operatorOrColumnB;
$operatorOrColumnB = '='; $operatorOrColumnB = '=';
@ -669,7 +696,8 @@ class Model {
* Columna a comparar para hacer el join. * Columna a comparar para hacer el join.
* *
* @param string $operatorOrColumnB * @param string $operatorOrColumnB
* Operador o columna a comparar como igual para hacer el join en caso de que $columnB no se defina. * Operador o columna a comparar como igual para hacer
* el join en caso de que $columnB no se defina.
* *
* @param string|null $columnB * @param string|null $columnB
* (opcional) Columna a comparar para hacer el join. * (opcional) Columna a comparar para hacer el join.
@ -681,8 +709,7 @@ class Model {
string $columnA, string $columnA,
string $operatorOrColumnB, string $operatorOrColumnB,
?string $columnB = null ?string $columnB = null
): static ): static {
{
if (is_null($columnB)) { if (is_null($columnB)) {
$columnB = $operatorOrColumnB; $columnB = $operatorOrColumnB;
$operatorOrColumnB = '='; $operatorOrColumnB = '=';
@ -720,10 +747,11 @@ class Model {
*/ */
public static function limit(int $offsetOrQuantity, ?int $quantity = null): static public static function limit(int $offsetOrQuantity, ?int $quantity = null): static
{ {
if (is_null($quantity)) if (is_null($quantity)) {
static::$querySelect['limit'] = $offsetOrQuantity; static::$querySelect['limit'] = $offsetOrQuantity;
else } else {
static::$querySelect['limit'] = $offsetOrQuantity . ', ' . $quantity; static::$querySelect['limit'] = $offsetOrQuantity . ', ' . $quantity;
}
return new static(); return new static();
} }
@ -747,8 +775,9 @@ class Model {
return new static(); return new static();
} }
if (!(strtoupper($order) == 'ASC' || strtoupper($order) == 'DESC')) if (!(strtoupper($order) == 'ASC' || strtoupper($order) == 'DESC')) {
$order = 'ASC'; $order = 'ASC';
}
static::$querySelect['orderBy'] = $value . ' ' . $order; static::$querySelect['orderBy'] = $value . ' ' . $order;
@ -769,12 +798,13 @@ class Model {
*/ */
public static function count(bool $resetQuery = true, bool $useLimit = false): int public static function count(bool $resetQuery = true, bool $useLimit = false): int
{ {
if (!$resetQuery) if (!$resetQuery) {
$backup = [ $backup = [
'select' => static::$querySelect['select'], 'select' => static::$querySelect['select'],
'limit' => static::$querySelect['limit'], 'limit' => static::$querySelect['limit'],
'orderBy' => static::$querySelect['orderBy'] 'orderBy' => static::$querySelect['orderBy'],
]; ];
}
if ($useLimit && static::$querySelect['limit'] != '') { if ($useLimit && static::$querySelect['limit'] != '') {
static::$querySelect['select'] = ['1']; static::$querySelect['select'] = ['1'];
@ -784,7 +814,9 @@ class Model {
$queryResult = static::query($sql, $resetQuery); $queryResult = static::query($sql, $resetQuery);
$result = $queryResult[0]['quantity']; $result = $queryResult[0]['quantity'];
} else { } else {
static::$querySelect['select'] = ["COUNT(".static::table().".".static::$primaryKey.") as quantity"]; static::$querySelect['select'] = [
"COUNT(" . static::table() . "." . static::$primaryKey . ") as quantity",
];
static::$querySelect['limit'] = '1'; static::$querySelect['limit'] = '1';
static::$querySelect['orderBy'] = ''; static::$querySelect['orderBy'] = '';
@ -836,18 +868,22 @@ class Model {
$search = static::bindValue($search); $search = static::bindValue($search);
$where = []; $where = [];
if (DB_TYPE == 'sqlite') if (DB_TYPE == 'sqlite') {
foreach($in as $row) foreach ($in as $row) {
$where[] = "$row LIKE '%' || $search || '%'"; $where[] = "$row LIKE '%' || $search || '%'";
else }
foreach($in as $row) } else {
foreach ($in as $row) {
$where[] = "$row LIKE CONCAT('%', $search, '%')"; $where[] = "$row LIKE CONCAT('%', $search, '%')";
}
}
if (static::$querySelect['where']=='') if (static::$querySelect['where'] == '') {
static::$querySelect['where'] = join(' OR ', $where); static::$querySelect['where'] = join(' OR ', $where);
else } else {
static::$querySelect['where'] = static::$querySelect['where'] . ' AND (' . join(' OR ', $where) . ')'; static::$querySelect['where'] = static::$querySelect['where'] . ' AND (' . join(' OR ', $where) . ')';
}
return new static(); return new static();
} }
@ -904,8 +940,9 @@ class Model {
$instances = []; $instances = [];
foreach ($result as $row) foreach ($result as $row) {
$instances[] = static::getInstance($row); $instances[] = static::getInstance($row);
}
return $instances; return $instances;
} }
@ -922,14 +959,16 @@ class Model {
public function setNull(string|array $atts): void public function setNull(string|array $atts): void
{ {
if (is_array($atts)) { if (is_array($atts)) {
foreach ($atts as $att) foreach ($atts as $att) {
if (!in_array($att, $this->toNull)) if (!in_array($att, $this->toNull)) {
$this->toNull[] = $att; $this->toNull[] = $att;
}
}
return; return;
} }
if (!in_array($atts, $this->toNull)) if (!in_array($atts, $this->toNull)) {
$this->toNull[] = $atts; $this->toNull[] = $atts;
} }
} }
?> }

38
src/Libs/Neuron.php
View File

@ -1,27 +1,27 @@
<?php <?php
namespace Libs;
use AllowDynamicProperties;
/** /**
* Neuron - DuckBrain * Neuron - DuckBrain
* *
* Neuron, sirve para crear un objeto que alojará valores, pero * Neuron, sirve para crear un objeto que alojará valores.
* además tiene la característica especial de que al intentar * Además, tiene la característica especial de que al intentar
* acceder a un atributo que no está definido devolerá nulo en * acceder a una propiedad no definida, devolverá null en
* lugar de generar un error php notice que indica que se está * lugar de generar un aviso (PHP notice) por variable o propiedad no definida.
* intentando acceder a un valor no definido.
* *
* El constructor recibe un objeto o arreglo con los valores que * El constructor acepta un objeto o un arreglo que contiene los
* sí estarán definidos. * valores que estarán definidos.
* *
* @author KJ * @author KJ
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
namespace Libs;
use AllowDynamicProperties;
#[AllowDynamicProperties] #[AllowDynamicProperties]
class Neuron { class Neuron
{
/** /**
* __construct * __construct
* *
@ -29,15 +29,19 @@ class Neuron {
*/ */
public function __construct(...$data) public function __construct(...$data)
{ {
if (count($data) === 1 && if (
count($data) === 1 &&
isset($data[0]) && isset($data[0]) &&
(is_array($data[0]) || (is_array($data[0]) ||
is_object($data[0]))) is_object($data[0]))
) {
$data = $data[0]; $data = $data[0];
}
foreach($data as $key => $value) foreach ($data as $key => $value) {
$this->{$key} = $value; $this->{$key} = $value;
} }
}
/** /**
* __get * __get
@ -50,5 +54,3 @@ class Neuron {
return null; return null;
} }
} }
?>

49
src/Libs/Request.php
View File

@ -1,4 +1,7 @@
<?php <?php
namespace Libs;
/** /**
* Request - DuckBrain * Request - DuckBrain
* *
@ -9,10 +12,8 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
class Request extends Neuron
namespace Libs; {
class Request extends Neuron {
public Neuron $get; public Neuron $get;
public Neuron $post; public Neuron $post;
public Neuron $put; public Neuron $put;
@ -41,14 +42,19 @@ class Request extends Neuron {
$this->body = file_get_contents("php://input"); $this->body = file_get_contents("php://input");
$contentType = isset($_SERVER["CONTENT_TYPE"]) ? trim($_SERVER["CONTENT_TYPE"]) : ''; $contentType = isset($_SERVER["CONTENT_TYPE"]) ? trim($_SERVER["CONTENT_TYPE"]) : '';
if ($contentType === "application/json") if ($contentType === "application/json") {
$this->json = new Neuron( $this->json = new Neuron(
(object) json_decode(trim($this->body), false) (object) json_decode(trim($this->body), false)
); );
else { } else {
$this->json = new Neuron(); $this->json = new Neuron();
if (in_array($_SERVER['REQUEST_METHOD'], ['PUT', 'PATCH', 'DELETE']) && if (
preg_match('/^[^;?\/:@&=+$,]{1,255}[=]/', $this->body, $matches)) { // Con la expresión regular verificamos que sea un http query string válido y evitamos errores de memoria en caso de que el body tenga algo más grande que eso. in_array($_SERVER['REQUEST_METHOD'], ['PUT', 'PATCH', 'DELETE']) &&
preg_match('/^[^;?\/:@&=+$,]{1,255}[=]/', $this->body, $matches)
) {
// Con la expresión regular verificamos que sea un http
// query string válido y evitamos errores de memoria en caso
// de que el body tenga algo más grande que eso.
parse_str($this->body, $input_vars); parse_str($this->body, $input_vars);
$this->{strtolower($_SERVER['REQUEST_METHOD'])} = new Neuron($input_vars); $this->{strtolower($_SERVER['REQUEST_METHOD'])} = new Neuron($input_vars);
} }
@ -64,8 +70,9 @@ class Request extends Neuron {
*/ */
public function handle(): mixed public function handle(): mixed
{ {
if ($this->validate()) if ($this->validate()) {
return Middleware::next($this); return Middleware::next($this);
}
return null; return null;
} }
@ -82,15 +89,17 @@ class Request extends Neuron {
default => $this->get default => $this->get
}; };
if (Validator::validateList(static::paramRules(), $this->params) && if (
Validator::validateList(static::paramRules(), $this->params) &&
Validator::validateList(static::getRules(), $this->get) && Validator::validateList(static::getRules(), $this->get) &&
Validator::validateList(static::rules(), $actual)) Validator::validateList(static::rules(), $actual)
) {
return true; return true;
}
if (isset(static::messages()[Validator::$lastFailed])) if (isset(static::messages()[Validator::$lastFailed])) {
$error = static::messages()[Validator::$lastFailed]; $error = static::messages()[Validator::$lastFailed];
else { } else {
$error = 'Error: validation failed of ' . preg_replace('/\./', ' as ', Validator::$lastFailed, 1); $error = 'Error: validation failed of ' . preg_replace('/\./', ' as ', Validator::$lastFailed, 1);
} }
@ -103,7 +112,8 @@ class Request extends Neuron {
* *
* @return array * @return array
*/ */
public function rules(): array { public function rules(): array
{
return []; return [];
} }
@ -112,7 +122,8 @@ class Request extends Neuron {
* *
* @return array * @return array
*/ */
public function paramRules(): array { public function paramRules(): array
{
return []; return [];
} }
@ -121,7 +132,8 @@ class Request extends Neuron {
* *
* @return array * @return array
*/ */
public function getRules(): array { public function getRules(): array
{
return []; return [];
} }
@ -130,7 +142,8 @@ class Request extends Neuron {
* *
* @return array * @return array
*/ */
public function messages(): array { public function messages(): array
{
return []; return [];
} }

67
src/Libs/Router.php
View File

@ -1,4 +1,7 @@
<?php <?php
namespace Libs;
/** /**
* Router - DuckBrain * Router - DuckBrain
* *
@ -10,10 +13,8 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
class Router
namespace Libs; {
class Router {
private static $get = []; private static $get = [];
private static $post = []; private static $post = [];
private static $put = []; private static $put = [];
@ -37,7 +38,9 @@ class Router {
/** /**
* __construct * __construct
*/ */
private function __construct() {} private function __construct()
{
}
/** /**
* Parsea para deectar las pseudovariables (ej: {variable}) * Parsea para deectar las pseudovariables (ej: {variable})
@ -62,12 +65,13 @@ class Router {
$path = preg_replace( $path = preg_replace(
['/\\\{\w+\\\}/s'], ['/\\\{\w+\\\}/s'],
['([^\/]+)'], ['([^\/]+)'],
$path); $path
);
return [ return [
'path' => $path, 'path' => $path,
'callback' => [$callback], 'callback' => [$callback],
'paramNames' => $paramNames 'paramNames' => $paramNames,
]; ];
} }
@ -82,8 +86,9 @@ class Router {
*/ */
public static function basePath(): string public static function basePath(): string
{ {
if (defined('SITE_URL') && !empty(SITE_URL)) if (defined('SITE_URL') && !empty(SITE_URL)) {
return rtrim(parse_url(SITE_URL, PHP_URL_PATH), '/') . '/'; return rtrim(parse_url(SITE_URL, PHP_URL_PATH), '/') . '/';
}
return str_replace($_SERVER['DOCUMENT_ROOT'], '/', ROOT_DIR); return str_replace($_SERVER['DOCUMENT_ROOT'], '/', ROOT_DIR);
} }
@ -116,18 +121,20 @@ class Router {
*/ */
public static function middleware(callable $callback, ?int $priority = null): static public static function middleware(callable $callback, ?int $priority = null): static
{ {
if (!isset(static::$last)) if (!isset(static::$last)) {
return new static(); return new static();
}
$method = static::$last[0]; $method = static::$last[0];
$index = static::$last[1]; $index = static::$last[1];
if (isset($priority) && $priority <= 0) if (isset($priority) && $priority <= 0) {
$priority = 1; $priority = 1;
}
if (is_null($priority) || $priority >= count(static::$$method[$index]['callback'])) if (is_null($priority) || $priority >= count(static::$$method[$index]['callback'])) {
static::$$method[$index]['callback'][] = $callback; static::$$method[$index]['callback'][] = $callback;
else { } else {
static::$$method[$index]['callback'] = array_merge( static::$$method[$index]['callback'] = array_merge(
array_slice(static::$$method[$index]['callback'], 0, $priority), array_slice(static::$$method[$index]['callback'], 0, $priority),
[$callback], [$callback],
@ -147,8 +154,9 @@ class Router {
*/ */
public static function reconfigure(callable $callback): static public static function reconfigure(callable $callback): static
{ {
if (empty(static::$last)) if (empty(static::$last)) {
return new static(); return new static();
}
$method = static::$last[0]; $method = static::$last[0];
$index = static::$last[1]; $index = static::$last[1];
@ -181,13 +189,15 @@ class Router {
$path = preg_replace( $path = preg_replace(
['/\\\{\w+\\\}/s'], ['/\\\{\w+\\\}/s'],
['([^\/]+)'], ['([^\/]+)'],
$path); $path
);
foreach(static::$$method as $index => $router) foreach (static::$$method as $index => $router) {
if ($router['path'] == $path) { if ($router['path'] == $path) {
static::$last = [$method, $index]; static::$last = [$method, $index];
break; break;
} }
}
return new static(); return new static();
} }
@ -285,8 +295,12 @@ class Router {
*/ */
public static function currentPath(): string public static function currentPath(): string
{ {
return preg_replace('/'.preg_quote(static::basePath(), '/').'/', return preg_replace(
'/', strtok($_SERVER['REQUEST_URI'], '?'), 1); '/' . preg_quote(static::basePath(), '/') . '/',
'/',
strtok($_SERVER['REQUEST_URI'], '?'),
1
);
} }
/** /**
@ -316,15 +330,17 @@ class Router {
if ($lastCallback instanceof \Closure) { // si es función anónima if ($lastCallback instanceof \Closure) { // si es función anónima
$reflectionCallback = new \ReflectionFunction($lastCallback); $reflectionCallback = new \ReflectionFunction($lastCallback);
} else { } else {
if (is_string($lastCallback)) if (is_string($lastCallback)) {
$lastCallback = preg_split('/::/', $lastCallback); $lastCallback = preg_split('/::/', $lastCallback);
}
// Revisamos su es un método o solo una función // Revisamos su es un método o solo una función
if (count($lastCallback) == 2) if (count($lastCallback) == 2) {
$reflectionCallback = new \ReflectionMethod($lastCallback[0], $lastCallback[1]); $reflectionCallback = new \ReflectionMethod($lastCallback[0], $lastCallback[1]);
else } else {
$reflectionCallback = new \ReflectionFunction($lastCallback[0]); $reflectionCallback = new \ReflectionFunction($lastCallback[0]);
} }
}
// Obtener los parámetros // Obtener los parámetros
$arguments = $reflectionCallback->getParameters(); $arguments = $reflectionCallback->getParameters();
@ -334,16 +350,17 @@ class Router {
// Verificamos si la clase está o no tipada // Verificamos si la clase está o no tipada
if (empty($argumentClass)) { if (empty($argumentClass)) {
$request = new Request; $request = new Request();
} else { } else {
$request = new $argumentClass; $request = new $argumentClass();
// Verificamos que sea instancia de Request (requerimiento) // Verificamos que sea instancia de Request (requerimiento)
if (!($request instanceof Request)) if (!($request instanceof Request)) {
throw new \Exception('Bad argument type on router callback.'); throw new \Exception('Bad argument type on router callback.');
} }
}
} else { } else {
$request = new Request; $request = new Request();
} }
// Comprobando y guardando los parámetros variables de la ruta // Comprobando y guardando los parámetros variables de la ruta
@ -369,6 +386,6 @@ class Router {
} }
// Si no hay router que coincida llamamos a $notFoundCallBack // Si no hay router que coincida llamamos a $notFoundCallBack
call_user_func_array(static::$notFoundCallback, [new Request]); call_user_func_array(static::$notFoundCallback, [new Request()]);
} }
} }

15
src/Libs/Validator.php
View File

@ -1,4 +1,7 @@
<?php <?php
namespace Libs;
/** /**
* Validator - DuckBrain * Validator - DuckBrain
* *
@ -28,10 +31,8 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
class Validator
namespace Libs; {
class Validator {
public static string $lastFailed = ''; public static string $lastFailed = '';
/** /**
@ -47,8 +48,9 @@ class Validator {
foreach ($rulesList as $target => $rules) { foreach ($rulesList as $target => $rules) {
$rules = preg_split('/\|/', $rules); $rules = preg_split('/\|/', $rules);
foreach ($rules as $rule) { foreach ($rules as $rule) {
if (static::checkRule($haystack->{$target}, $rule)) if (static::checkRule($haystack->{$target}, $rule)) {
continue; continue;
}
static::$lastFailed = $target . '.' . $rule; static::$lastFailed = $target . '.' . $rule;
return false; return false;
} }
@ -71,8 +73,9 @@ class Validator {
$rule = [static::class, $arguments[0]]; $rule = [static::class, $arguments[0]];
$arguments[0] = $subject; $arguments[0] = $subject;
if (is_callable($rule)) if (is_callable($rule)) {
return call_user_func_array($rule, $arguments); return call_user_func_array($rule, $arguments);
}
throw new \Exception('Bad rule: "' . preg_split('/::/', $rule)[1] . '"'); throw new \Exception('Bad rule: "' . preg_split('/::/', $rule)[1] . '"');
} }

52
src/Libs/View.php
View File

@ -1,4 +1,7 @@
<?php <?php
namespace Libs;
/** /**
* View - DuckBrain * View - DuckBrain
* *
@ -8,11 +11,8 @@
* @website https://kj2.me * @website https://kj2.me
* @licence MIT * @licence MIT
*/ */
class View extends Neuron
namespace Libs; {
class View extends Neuron {
/** /**
* Incluye el archivo. * Incluye el archivo.
* *
@ -26,12 +26,11 @@ class View extends Neuron {
string $viewName, string $viewName,
?string $viewPath = null, ?string $viewPath = null,
string $extension = 'php' string $extension = 'php'
): void ): void {
{ if (
$view = $this; isset($viewPath) &&
file_exists("$viewPath$viewName.$extension")
if (isset($viewPath) && ) {
file_exists("$viewPath$viewName.$extension")) {
include("$viewPath$viewName.$extension"); include("$viewPath$viewName.$extension");
return; return;
} }
@ -43,8 +42,10 @@ class View extends Neuron {
* Función que "renderiza" las vistas * Función que "renderiza" las vistas
* *
* @param string $viewName Ruta relativa y el nommbre sin extensión del archivo. * @param string $viewName Ruta relativa y el nommbre sin extensión del archivo.
* @param array|Neuron $params (opcional) Arreglo que podrá ser usado en la vista mediante $view ($param['index'] se usaría así: $view->index) * @param array|Neuron $params (opcional) Arreglo que podrá ser usado en la vista
* @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se encuentre en esa ruta, se usará la ruta por defecto "src/Views/". * mediante $view ($param['index'] se usaría así: $view->index)
* @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que
* la vista no se encuentre en esa ruta, se usará la ruta por defecto "src/Views/".
* @param string $extension (opcional) Extensión del archivo. * @param string $extension (opcional) Extensión del archivo.
* *
* @return void * @return void
@ -54,8 +55,7 @@ class View extends Neuron {
array|Neuron $params = [], array|Neuron $params = [],
?string $viewPath = null, ?string $viewPath = null,
string $extension = 'php' string $extension = 'php'
): void ): void {
{
$instance = new View($params); $instance = new View($params);
$instance->html($viewName, $viewPath, $extension); $instance->html($viewName, $viewPath, $extension);
} }
@ -64,7 +64,8 @@ class View extends Neuron {
* Renderiza las vistas HTML * Renderiza las vistas HTML
* *
* @param string $viewName Ruta relativa y el nommbre sin extensión del archivo ubicado en src/Views * @param string $viewName Ruta relativa y el nommbre sin extensión del archivo ubicado en src/Views
* @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se encuentre en esa ruta, se usará la ruta por defecto "src/Views/". * @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se
* encuentre en esa ruta, se usará la ruta por defecto "src/Views/".
* @param string $extension (opcional) Extensión del archivo. * @param string $extension (opcional) Extensión del archivo.
* *
* @return void * @return void
@ -73,8 +74,7 @@ class View extends Neuron {
string $viewName, string $viewName,
?string $viewPath = null, ?string $viewPath = null,
string $extension = 'php' string $extension = 'php'
): void ): void {
{
$this->include( $this->include(
$viewName, $viewName,
$viewPath, $viewPath,
@ -86,7 +86,8 @@ class View extends Neuron {
* Renderiza código CSS. * Renderiza código CSS.
* *
* @param string $viewName Ruta relativa y el nommbre sin extensión del archivo ubicado en src/Views * @param string $viewName Ruta relativa y el nommbre sin extensión del archivo ubicado en src/Views
* @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se encuentre en esa ruta, se usará la ruta por defecto "src/Views/". * @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se
* encuentre en esa ruta, se usará la ruta por defecto "src/Views/".
* @param string $extension (opcional) Extensión del archivo. * @param string $extension (opcional) Extensión del archivo.
* *
* @return void * @return void
@ -95,8 +96,7 @@ class View extends Neuron {
string $viewName, string $viewName,
?string $viewPath = null, ?string $viewPath = null,
string $extension = 'css' string $extension = 'css'
): void ): void {
{
header("Content-type: text/css"); header("Content-type: text/css");
$this->include($viewName, $viewPath, $extension); $this->include($viewName, $viewPath, $extension);
} }
@ -105,7 +105,8 @@ class View extends Neuron {
* Renderiza código Javascript. * Renderiza código Javascript.
* *
* @param string $viewName Ruta relativa y el nommbre sin extensión del archivo ubicado en src/Views * @param string $viewName Ruta relativa y el nommbre sin extensión del archivo ubicado en src/Views
* @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se encuentre en esa ruta, se usará la ruta por defecto "src/Views/". * @param string|null $viewPath (opcional) Ruta donde se encuentra la vista. En caso de que la vista no se
* encuentre en esa ruta, se usará la ruta por defecto "src/Views/".
* @param string $extension (opcional) Extensión del archivo. * @param string $extension (opcional) Extensión del archivo.
* *
* @return void * @return void
@ -114,8 +115,7 @@ class View extends Neuron {
string $viewName, string $viewName,
?string $viewPath = null, ?string $viewPath = null,
string $extension = 'js' string $extension = 'js'
): void ): void {
{
header("Content-type: application/javascript"); header("Content-type: application/javascript");
$this->include($viewName, $viewPath, $extension); $this->include($viewName, $viewPath, $extension);
} }
@ -155,10 +155,10 @@ class View extends Neuron {
*/ */
public static function route(string $path = '/'): string public static function route(string $path = '/'): string
{ {
if (defined('SITE_URL') && !empty(SITE_URL)) if (defined('SITE_URL') && !empty(SITE_URL)) {
return rtrim(SITE_URL, '/') . '/' . ltrim($path, '/'); return rtrim(SITE_URL, '/') . '/' . ltrim($path, '/');
}
return $path; return $path;
} }
} }
?>