posix_isatty

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_isatty — Determinar si un descriptor de fichero es un terminal interactiva

Descripción

posix_isatty(mixed $fd): bool

Determina si el descriptor de fichero fd hace referencia a un dispositivo tipo terminal válido.

Parámetros

fd

El descriptor del fichero, el cual se prevee que sea o un resource de fichero o un integer. Se asumirá que un integer sea un descriptor de fichero que pueda pasarse directamente a la llamada del sistema subyacente.

En la mayoría de los casos se proporcionará un resource de fichero.

Valores devueltos

Devuelve true si fd es un descriptor abierto conectado a una terminal, y false de lo contrario.

Ver también

posix_ttyname() - Determinar el nombre del dispositivo terminal

add a note

User Contributed Notes 2 notes

down

hfuecks at phppatterns dot com ¶

20 years ago


Can be useful to determine whether output is being piped elsewhere, for PHP shell scripts, for example;

#!/usr/local/bin/php
<?php
if ( !posix_isatty(STDOUT) ) {
    fwrite(STDOUT, "Invalid TTY\n");
    exit(2);
}
fwrite(STDOUT, "Enter you name\n");
$name = fgets(STDIN);
fwrite(STDOUT,"Hello $name\n");
exit(0);
?>

If this script is like:

script.php > outfile

outfile will contain "Invalid TTY"

down

KEINOS ¶

3 years ago


It's quite complicated to understand its movements. But it determines if the file_descriptor is open AND connected to a terminal.

Thus, while receiving data from the STDIN, for example, it will return false.

This move is useful to optionally pipe STDIN to a PHP script, to avoid hanging when nothing is from STDIN.

<?php

// Simply echoes the contents from STDIN if any
// and "no stdin" if not.
echo (posix_isatty(STDIN)) ? 'no stdin' . PHP_EOL : file_get_contents('php://stdin');
?>

add a note