Forum PHP 2026 - Paris (France)

ssh2_keepalive_send

(PECL ssh2 >= 1.5.0)

ssh2_keepalive_sendEnvía un mensaje de mantenimiento de conexión

Descripción

function ssh2_keepalive_send(resource $session): int|false

Envía un mensaje de mantenimiento de conexión en la session indicada, de acuerdo con la configuración establecida con ssh2_keepalive_config().

Nota:

Esta función solo está disponible cuando la extensión se compila con una versión de libssh2 que proporciona soporte de mantenimiento de conexión.

Parámetros

session

Un identificador de enlace de conexión SSH, obtenido de una llamada a ssh2_connect().

Valores devueltos

Devuelve el número de segundos que pueden transcurrir antes de que deba enviarse otro mensaje de mantenimiento de conexión, o false en caso de error. Devuelve 0 cuando los mensajes de mantenimiento de conexión están deshabilitados.

Puesto que tanto 0 como false se evalúan como falso, debe utilizarse el operador === para distinguirlos.

Ejemplos

Ejemplo #1 Envío de un mensaje de mantenimiento de conexión

<?php
$connection = ssh2_connect('shell.example.com', 22);
ssh2_auth_password($connection, 'username', 'password');
ssh2_keepalive_config($connection, true, 30);

$seconds = ssh2_keepalive_send($connection);

if ($seconds === false) {
    echo "No se ha podido enviar el mensaje de mantenimiento de conexión", PHP_EOL;
} elseif ($seconds === 0) {
    echo "Los mensajes de mantenimiento de conexión están deshabilitados", PHP_EOL;
} else {
    echo "Próximo mensaje de mantenimiento de conexión en $seconds segundos", PHP_EOL;
}
?>

Véase también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top