Componentes

Los componentes de Shieldon son un conjunto de controladores que te permiten agregar reglas personalizadas para permitir o denegar antes de detectar el comportamiento del usuario.

TrustedBot

El componente TrustedBot permite que los motores de búsqueda populares rastreen tu sitio sin restricciones. Carga este componente al menos.

Ip

El componente Ip te permite establecer IPs individuales o rangos de IPs en la lista blanca o negra.

UserAgent

El componente UserAgent bloquea de forma predeterminada a los bots maliciosos conocidos. Puedes agregar tu propia lista en la lista negra de UserAgent.

Header

El componente Header bloquea a los visitantes que no tienen información de encabezado común en modo estricto.

Rdns

El componente Rdns bloquea a los visitantes sin registros Rdns o cuando el Rdns no coincide con la dirección IP en modo estricto.

setStrict($bool)

  • param bool $bool - Establece como verdadero para activar el modo estricto, falso para desactivarlo.
  • return void
$component->setStrict(true);

Rasgo de Denegado (Denied Trait)

  • setDeniedItem
  • setDeniedItems
  • getDeniedItem
  • getDeniedItems
  • removeDeniedItem
  • removeDeniedItems
  • hasDeniedItem
  • getDenyWithPrefix
  • removeDenyWithPrefix
  • isDenied

setDeniedItem($value, $key)

  • param string|array $value - El valor de los datos.
  • param string $key - La clave de los datos.
  • return void

Añade un elemento a la lista negra.

Ejemplo:

$component->setDeniedItem($string);

setDeniedItems($itemList)

  • param array $itemList - Lista de cadenas.
  • return void

Añade elementos a la lista negra.

Ejemplo:

$component->setDeniedItems($stringList);

getDeniedItem($key)

  • param string $key - La clave del campo de datos.
  • return string|array

Obtiene un elemento de la lista negra.

Ejemplo:

$item = $component->getDeniedItems('this_item');

getDeniedItems()

  • return array

Obtiene los elementos de la lista negra.

$list = $component->getDeniedItems();

removeDeniedItem($key)

  • param string $key - La clave de los datos.
  • return void

Elimina un elemento denegado si existe.

$component->removeDeniedItem($string);

removeDeniedItems()

  • return void

Elimina todos los elementos denegados.

$component->removeDeniedItems();

hasDeniedItem($key)

  • param string $key - La clave de los datos.
  • return bool

Verifica si existe un elemento denegado.

Ejemplo:

if ($component->hasDeniedItem('test')) {
    echo 'elemento existe';
} else {
    echo 'elemento no existe';
}

getDenyWithPrefix($key)

  • param string $key - La clave de los datos.
  • return array

Verifica si existen elementos denegados con el mismo prefijo.

Ejemplo:

$deniedList = $component->getDenyWithPrefix('test');

removeDenyWithPrefix($key)

  • param string $key - La clave de los datos.
  • return void

Elimina los elementos denegados con el mismo prefijo.

$component->removeDenyWithPrefix('test');

isDenied()

  • return bool

Este método debe ajustarse en la clase extendida si es necesario.


if ($component->isDenied()) {
    echo 'Este usuario ha sido denegado.';
}

Rasgo de Permitido (Allowed Trait)

  • setAllowedItem
  • setAllowedItems
  • getAllowedItem
  • getAllowedItems
  • removeAllowedItem
  • removeAllowedItems
  • hasAllowedItem
  • getDenyWithPrefix
  • removeDenyWithPrefix
  • isAllowed

setAllowedItem($value, $key)

  • param string|array $value - El valor de los datos.
  • param string $key - La clave de los datos.
  • return void

Añade un elemento a la lista blanca.

Ejemplo:

$component->setAllowedItem($string);

setAllowedItems($itemList)

  • param array $itemList - Lista de cadenas.
  • return void

Añade elementos a la lista blanca.

Ejemplo:

$component->setAllowedItems($stringList);

getAllowedItem($key)

  • param string $key - La clave del campo de datos.
  • return string|array

Obtiene un elemento de la lista blanca.

Ejemplo:

$item = $component->getAllowedItems('this_item');

getAllowedItems()

  • return array

Obtiene los elementos de la lista blanca.

$list = $component->getAllowedItems();

removeAllowedItem($key)

  • param string $key - La clave de los datos.
  • return void

Elimina un elemento permitido si existe.

$component->removeAllowedItem($string);

removeAllowedItems()

  • return void

Elimina todos los elementos permitidos.

$component->removeAllowedItems();

hasAllowedItem($key)

  • param string $key - La clave de los datos.
  • return bool

Verifica si existe un elemento permitido.

Ejemplo:

if ($component->hasAllowedItem('test')) {
    echo 'elemento existe';
} else {
    echo 'elemento no existe';
}

getDenyWithPrefix($key)

  • param string $key - La clave de los datos.
  • return array

Verifica si existe un elemento permitido con el mismo prefijo.

Ejemplo:

$allowedList = $component->getDenyWithPrefix('test');

removeDenyWithPrefix($key)

  • param string $key - La clave de los datos.
  • return void

Elimina los elementos permitidos con el mismo prefijo.

$component->removeDenyWithPrefix('test');

isAllowed()

  • return bool

Este método debe ajustarse en la clase extendida si es necesario.


if ($component->isAllowed()) {
    echo 'Este usuario ha sido permitido.';
}