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"
posix_isatty
(PHP 4, PHP 5, PHP 7)
posix_isatty — Determine if a file descriptor is an interactive terminal
Descrierea
posix_isatty
( resource|int
$file_descriptor
) : bool
Determines if the file descriptor file_descriptor refers to a valid
terminal type device.
Parametri
-
fd -
Descriptorul fișierului, care trebuie să fie o resource de fișier, sau un integer. Un integer se va presupune a fi un descriptor de fișier care poate fi transmis direct către apelul de sistem ce stă la bază.
În majoritatea cazurilor veți dori să utilizați o resource de fișier.
Valorile întoarse
Returns true if file_descriptor is an open descriptor connected
to a terminal and false otherwise.
A se vedea și
- posix_ttyname() - Determine terminal device name
- stream_isatty() - Check if a stream is a TTY
add a note
User Contributed Notes 2 notes
hfuecks at phppatterns dot com ¶
19 years ago
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');
?>
