posix_isatty

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

posix_isattyDetermina se um descritor de arquivo é um terminal interativo

Descrição

posix_isatty(resource|int $file_descriptor): bool

Determina se o descritor de arquivo file_descriptor se refere a um dispositivo de tipo de terminal válido.

Parâmetros

file_descriptor

O descritor de arquivo, que deve ser um resource de arquivo ou um int. Um int será interpretado como um descritor de arquivo que pode ser passado diretamente para a chamada de sistema subjacente.

Valor Retornado

Retorna true se file_descriptor for um descritor aberto conectado a um terminal e false caso contrário.

Registro de Alterações

Versão Descrição
8.4.0 Define o número de erro para EBADF quando o fluxo/descritor de arquivo informado for inválido.
8.3.0 Erros de tipo E_WARNING agora são gerados para conversões forçadas de inteiros seguindo a semântica usual de coerção de tipo do PHP.

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
1
hfuecks at phppatterns dot com
21 years ago
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"
up
0
KEINOS
4 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');?>
To Top