Campos de la tabla `conexion` que pueden viajar al navegador.
public
mixed
CAMPOS_CONEXION_PUBLICOS
= ['id', 'nombre', 'host', 'puerto', 'descripcion']
Lista blanca a propósito: esa tabla guarda credenciales de las bases de explotación (usuario, password) y estas fichas se sirven tal cual al selector de conexiones. Todo lo que no esté aquí no sale del servidor.
Marca la petición como perteneciente a la API. La red de fatales de bootstrap.php la consulta para decidir si responde en JSON: en las páginas web no debe hacerlo, o el navegador mostraría el objeto en crudo.
public
mixed
CONTEXTO_API
= \true
Debe definirse ANTES de incluir el bootstrap.
public
mixed
DIR_FRONTEND
= __DIR__ . '/../../frontend'
public
mixed
DIR_RUTAS
= __DIR__ . '/../api/v2_test/rutas'
Acciones cuyo handler modifica $_SESSION. Deben declarar escribeSesion: true, o el despachador liberará el bloqueo de sesión antes de ejecutarlas y sus escrituras no se persistirán.
public
mixed
ESCRIBEN_SESION
= ['login', 'cambiar_campania', 'update_user_permisos']
Lista mantenida a mano, pero convierte un fallo silencioso —el caso del token CSRF que el servidor nunca llega a guardar— en un error visible.
Directorios que no forman parte del código propio.
public
mixed
EXCLUIDOS
= '#[\\\\/](node_modules|dist|vendor|\.git|\.idea)[\\\\/]#'
Páginas cuyo acceso NO depende de la tabla `permisos` sino del rol.
public
mixed
PAGINAS_ROL_MINIMO
= [
'paneladministrador' => 1,
// admin y super
'panelpaginas' => 1,
// admin y super
'panelconexiones' => 2,
// solo super
'panelconfiguracion' => 2,
]
Funcionan estén o no dadas de alta en la tabla paginas.
Clave = ruta canónica (minúsculas, sin carpeta ni .php).
Formas en que el frontend puede declarar la acción. La primera cubre el objeto literal de $.ajax; la segunda, las subidas con FormData; la tercera, las cadenas de consulta construidas a mano.
public
mixed
PATRONES_ACCION
= ['/[\'"]?action[\'"]?\s*[:=]\s*[\'"]([a-zA-Z0-9_]+)[\'"]/', '/append\(\s*[\'"]action[\'"]\s*,\s*[\'"]([a-zA-Z0-9_]+)[\'"]/', '/action=([a-zA-Z0-9_]+)/']
public
mixed
PERMISOS_TTL
= 300
public
mixed
PERMISOS_TTL_REINTENTO
= 30
Prefijos que delatan una acción de escritura por su nombre.
public
mixed
PREFIJOS_ESCRITURA
= ['crear_', 'insert_', 'eliminar_', 'delete_', 'modificar_', 'update_', 'actualizar_', 'anadir_', 'add_', 'ajuste_', 'ajustar_', 'asignar_', 'deshabilitar_', 'habilitar_', 'reajustar_', 'cambio_', 'set_']
public
mixed
RID
= \bin2hex(\random_bytes(4))
public
mixed
SESSION_TIMEOUT_SECONDS
= 30 * 60
Combina los módulos detectando colisiones.
registrarRutas(array<string, Ruta> ...$modulos) : array<string, Ruta>
array_merge sobrescribiría en silencio una acción declarada dos veces, y podría prevalecer la que tiene el nivel de acceso más permisivo.
jsonResponse(mixed $data[, int $status = 200 ]) : never
Valida sesión activa + binding IP/UA.
requireAuthApi() : void
Aborta con 401 si no supera la comprobación.
Renombrada respecto a auth_guard::requireAuthPage para diferenciar:
Valida que el usuario tiene permiso para una página sobre TODAS las conexiones recibidas. Aborta con 403 si falla.
requirePermisos() : array{paginaId: int, conexionIds: int[]}
Lee pagina_id y conexion_ids (JSON array) del POST.
Devuelve la fecha y hora actuales en formato MySQL.
obtenerFechaActual() : string
Registra una acción en la tabla `log` de la base de datos tracking.
writeLog(string $frase, int $conexionId) : void
Descripción de la acción realizada.
Comprueba que la sesion está abierta o sino la abre
_agSesion() : void
Normaliza cualquier forma de ruta a una única clave.
rutaCanonica(string $ruta) : string
Crea una cache vacia con un error por parametro
_agCacheVacia([string|null $error = null ]) : array<string|int, mixed>
Devuelve la caché, construyéndola o revalidándola si toca.
permisosCache() : array<string|int, mixed>
Conexiones sobre las que el usuario puede operar en esa página.
conexionesDePagina(string $ruta) : array<string|int, int>
: ruta de la pagina a la que se quiere acceder
vacío = sin acceso
¿Puede el usuario ver la página? Basta con 1 permiso.
puedeAccederPagina(string $ruta) : bool
Conexiones de la página ya "hidratadas" con su ficha (id, nombre, host…).
conexionesDisponibles(string $ruta) : array<int, array<string|int, mixed>>
Es lo que consume conexion-selector.js.
: ruta de la que se quiere obtener sus conexiones
Árbol de menú ya filtrado por permisos, listo para renderizar.
menuSidebar() : array<string|int, mixed>
Ruta canónica de la primera página accesible (destino tras el login).
paginaPrincipal() : string|null
Primera conexión sobre la que el usuario tiene algún permiso.
conexionPorDefecto() : int|null
Fuerza la reconstrucción en la PRÓXIMA lectura (solo de la sesión actual).
invalidarCachePermisos() : void
Comprueba si el usuario tiene acceso a la pagina que lo invoca
requireAuthPage(string $ruta) : void
: ruta de la pagina invocante
Timeout por INACTIVIDAD. true = expirada.
sesionExpiradaPorInactividad([bool $renovar = true ]) : bool
Construccion de la cache Se construye al hacer loggin y se renueva segune el TTL definido al principio del archivo
_construirCachePermisos(int $userId, int $rol) : array<string|int, mixed>
: id del usuario solicitante
: rol del usuario solicitante
: estructura de permisos
Coloca una página en el árbol categoria → subcategoria → subsubcategoria.
_agInsertarEnMenu(array<string|int, mixed> &$menu, array<string|int, mixed> $p, string $clave) : void
prompt(string $label[, string|null $default = null ][, bool $required = true ]) : string
promptInt(string $label, int $default) : int
promptBool(string $label, bool $default) : bool
Lee una contraseña ocultando el eco en sistemas Unix.
promptPassword(string $label) : string
En Windows muestra el texto en claro (limitación de stty).
Escapa una cadena para inclusión segura en una sentencia SQL como literal.
sqlEscape(string $s) : string
Solo para uso de presentación (el INSERT que muestra el script).