PHP 8.4.2 Released!

    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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    1
    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"
    up
    0
    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
    To Top