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

149
src/Libs/Router.php
View File

@@ -1,4 +1,7 @@
<?php
namespace Libs;
/**
* Router - DuckBrain
*
@@ -10,17 +13,15 @@
* @website https://kj2.me
* @licence MIT
*/
namespace Libs;
class Router {
class Router
{
private static $get = [];
private static $post = [];
private static $put = [];
private static $patch = [];
private static $delete = [];
private static $last;
public static $notFoundCallback = 'Libs\Router::defaultNotFound';
public static $notFoundCallback = 'Libs\Router::defaultNotFound';
/**
* Función callback por defectio para cuando
@@ -28,7 +29,7 @@ class Router {
*
* @return void
*/
public static function defaultNotFound (): void
public static function defaultNotFound(): void
{
header("HTTP/1.0 404 Not Found");
echo '<h2 style="text-align: center;margin: 25px 0px;">Error 404 - Página no encontrada</h2>';
@@ -37,21 +38,23 @@ class Router {
/**
* __construct
*/
private function __construct() {}
private function __construct()
{
}
/**
* Parsea para deectar las pseudovariables (ej: {variable})
*
* @param string $path
* Ruta con pseudovariables.
* Ruta con pseudovariables.
*
* @param callable $callback
* Callback que será llamado cuando la ruta configurada en $path coincida.
* Callback que será llamado cuando la ruta configurada en $path coincida.
*
* @return array
* Arreglo con 2 índices:
* path - Contiene la ruta con las pseudovariables reeplazadas por expresiones regulares.
* callback - Contiene el callback en formato Namespace\Clase::Método.
* Arreglo con 2 índices:
* path - Contiene la ruta con las pseudovariables reeplazadas por expresiones regulares.
* callback - Contiene el callback en formato Namespace\Clase::Método.
*/
private static function parse(string $path, callable $callback): array
{
@@ -62,12 +65,13 @@ class Router {
$path = preg_replace(
['/\\\{\w+\\\}/s'],
['([^\/]+)'],
$path);
$path
);
return [
'path' => $path,
'callback' => [$callback],
'paramNames' => $paramNames
'paramNames' => $paramNames,
];
}
@@ -82,8 +86,9 @@ class Router {
*/
public static function basePath(): string
{
if (defined('SITE_URL') && !empty(SITE_URL))
return rtrim(parse_url(SITE_URL, PHP_URL_PATH), '/').'/';
if (defined('SITE_URL') && !empty(SITE_URL)) {
return rtrim(parse_url(SITE_URL, PHP_URL_PATH), '/') . '/';
}
return str_replace($_SERVER['DOCUMENT_ROOT'], '/', ROOT_DIR);
}
@@ -91,7 +96,7 @@ class Router {
* Redirije a una ruta relativa interna.
*
* @param string $path
* La ruta relativa a la ruta base.
* La ruta relativa a la ruta base.
*
* Ej: Si nuesto sistema está en "https://ejemplo.com/duckbrain"
* llamamos a Router::redirect('/docs'), entonces seremos
@@ -100,7 +105,7 @@ class Router {
*/
public static function redirect(string $path): void
{
header('Location: '.static::basePath().ltrim($path, '/'));
header('Location: ' . static::basePath() . ltrim($path, '/'));
exit;
}
@@ -109,25 +114,27 @@ class Router {
* Solo se puede usar un middleware a la vez.
*
* @param callable $callback
* @param int $prioriry
* @param int $prioriry
*
* @return static
* Devuelve la instancia actual.
* Devuelve la instancia actual.
*/
public static function middleware(callable $callback, ?int $priority = null): static
{
if (!isset(static::$last))
if (!isset(static::$last)) {
return new static();
}
$method = static::$last[0];
$index = static::$last[1];
if (isset($priority) && $priority <= 0)
if (isset($priority) && $priority <= 0) {
$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;
else {
} else {
static::$$method[$index]['callback'] = array_merge(
array_slice(static::$$method[$index]['callback'], 0, $priority),
[$callback],
@@ -147,8 +154,9 @@ class Router {
*/
public static function reconfigure(callable $callback): static
{
if (empty(static::$last))
if (empty(static::$last)) {
return new static();
}
$method = static::$last[0];
$index = static::$last[1];
@@ -165,10 +173,10 @@ class Router {
* solo configura la ruta como la última configurada
* siempre y cuando la misma haya sido configurada previamente.
*
* @param string $method
* Método http.
* @param string $path
* Ruta con pseudovariables.
* @param string $method
* Método http.
* @param string $path
* Ruta con pseudovariables.
* @param callable|null $callback
*
* @return
@@ -181,32 +189,34 @@ class Router {
$path = preg_replace(
['/\\\{\w+\\\}/s'],
['([^\/]+)'],
$path);
$path
);
foreach(static::$$method as $index => $router)
foreach (static::$$method as $index => $router) {
if ($router['path'] == $path) {
static::$last = [$method, $index];
break;
}
}
return new static();
}
static::$$method[] = static::parse($path, $callback);
static::$last = [$method, count(static::$$method)-1];
static::$last = [$method, count(static::$$method) - 1];
return new static();
}
/**
* Define los routers para el método GET.
*
* @param string $path
* Ruta con pseudovariables.
* @param string $path
* Ruta con pseudovariables.
* @param callable|null $callback
* Callback que será llamado cuando la ruta configurada en $path coincida.
* Callback que será llamado cuando la ruta configurada en $path coincida.
*
* @return static
* Devuelve la instancia actual.
* Devuelve la instancia actual.
*/
public static function get(string $path, ?callable $callback = null): static
{
@@ -216,13 +226,13 @@ class Router {
/**
* Define los routers para el método POST.
*
* @param string $path
* Ruta con pseudovariables.
* @param string $path
* Ruta con pseudovariables.
* @param callable|null $callback
* Callback que será llamado cuando la ruta configurada en $path coincida.
* Callback que será llamado cuando la ruta configurada en $path coincida.
*
* @return static
* Devuelve la instancia actual.
* Devuelve la instancia actual.
*/
public static function post(string $path, ?callable $callback = null): static
{
@@ -232,13 +242,13 @@ class Router {
/**
* Define los routers para el método PUT.
*
* @param string $path
* Ruta con pseudovariables.
* @param string $path
* Ruta con pseudovariables.
* @param callable|null $callback
* Callback que será llamado cuando la ruta configurada en $path coincida.
* Callback que será llamado cuando la ruta configurada en $path coincida.
*
* @return static
* Devuelve la instancia actual
* Devuelve la instancia actual
*/
public static function put(string $path, ?callable $callback = null): static
@@ -249,13 +259,13 @@ class Router {
/**
* Define los routers para el método PATCH.
*
* @param string $path
* Ruta con pseudovariables.
* @param string $path
* Ruta con pseudovariables.
* @param callable|null $callback
* Callback que será llamado cuando la ruta configurada en $path coincida.
* Callback que será llamado cuando la ruta configurada en $path coincida.
*
* @return static
* Devuelve la instancia actual
* Devuelve la instancia actual
*/
public static function patch(string $path, ?callable $callback = null): static
{
@@ -265,13 +275,13 @@ class Router {
/**
* Define los routers para el método DELETE.
*
* @param string $path
* Ruta con pseudovariables
* @param string $path
* Ruta con pseudovariables
* @param callable|null $callback
* Callback que será llamado cuando la ruta configurada en $path coincida.
* Callback que será llamado cuando la ruta configurada en $path coincida.
*
* @return static
* Devuelve la instancia actual
* Devuelve la instancia actual
*/
public static function delete(string $path, ?callable $callback = null): static
{
@@ -283,10 +293,14 @@ class Router {
*
* @return string
*/
public static function currentPath() : string
public static function currentPath(): string
{
return preg_replace('/'.preg_quote(static::basePath(), '/').'/',
'/', strtok($_SERVER['REQUEST_URI'], '?'), 1);
return preg_replace(
'/' . preg_quote(static::basePath(), '/') . '/',
'/',
strtok($_SERVER['REQUEST_URI'], '?'),
1
);
}
/**
@@ -299,7 +313,7 @@ class Router {
public static function apply(?string $path = null): void
{
$path = $path ?? static::currentPath();
$routers = match($_SERVER['REQUEST_METHOD']) { // Según el método selecciona un arreglo de routers
$routers = match ($_SERVER['REQUEST_METHOD']) { // Según el método selecciona un arreglo de routers
'POST' => static::$post,
'PUT' => static::$put,
'PATCH' => static::$patch,
@@ -308,7 +322,7 @@ class Router {
};
foreach ($routers as $router) { // revisa todos los routers para ver si coinciden con la ruta actual
if (preg_match_all('/^'.$router['path'].'\/?$/si',$path, $matches, PREG_PATTERN_ORDER)) {
if (preg_match_all('/^' . $router['path'] . '\/?$/si', $path, $matches, PREG_PATTERN_ORDER)) {
unset($matches[0]);
// Objtener un reflection del callback
@@ -316,14 +330,16 @@ class Router {
if ($lastCallback instanceof \Closure) { // si es función anónima
$reflectionCallback = new \ReflectionFunction($lastCallback);
} else {
if (is_string($lastCallback))
if (is_string($lastCallback)) {
$lastCallback = preg_split('/::/', $lastCallback);
}
// 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]);
else
} else {
$reflectionCallback = new \ReflectionFunction($lastCallback[0]);
}
}
// Obtener los parámetros
@@ -334,22 +350,23 @@ class Router {
// Verificamos si la clase está o no tipada
if (empty($argumentClass)) {
$request = new Request;
$request = new Request();
} else {
$request = new $argumentClass;
$request = new $argumentClass();
// Verificamos que sea instancia de Request (requerimiento)
if (!($request instanceof Request))
if (!($request instanceof Request)) {
throw new \Exception('Bad argument type on router callback.');
}
}
} else {
$request = new Request;
$request = new Request();
}
// Comprobando y guardando los parámetros variables de la ruta
if (isset($matches[1])) {
foreach ($matches as $index => $match) {
$paramName = $router['paramNames'][$index-1];
$paramName = $router['paramNames'][$index - 1];
$request->params->$paramName = urldecode($match[0]);
}
}
@@ -369,6 +386,6 @@ class Router {
}
// 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()]);
}
}