(PHP 4, PHP 5, PHP 7, PHP 8)
posix_isatty — Ermittelt, ob ein Dateideskriptor ein interaktives Terminal ist
Ermittelt, ob der Dateideskriptor file_descriptor
auf ein gültiges terminalartiges Gerät verweist.
Gibt true zurück, falls file_descriptor ein
offener Deskriptor ist, der mit einem Terminal verbunden ist, und
andernfalls false.
| Version | Beschreibung |
|---|---|
| 8.4.0 |
Wenn der übergebene Dateideskriptor/-stream ungültig ist, wird errno
(die Fehlernummer) auf EBADF gesetzt.
|
| 8.3.0 |
Wenn ein Integer zwangsweise umgewandelt wird (coercive typing), wird
nun ein Typfehler der Stufe E_WARNING ausgelöst,
der der üblichen PHP-Semantik für Typzwang entspricht.
|
Can be useful to determine whether output is being piped elsewhere, for PHP shell scripts, for example;#!/usr/local/bin/php<?phpif ( !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 > outfileoutfile will contain "Invalid TTY"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');?>