LXIX. Ncurses Terminal Screen Control Functions
Introduction
ncurses (new curses) is a free software emulation of curses
in System V Rel 4.0 (and above). It uses terminfo format,
supports pads, colors, multiple highlights, form characters
and function key mapping. Because of the interactive nature
of this library, it will be of little use for writing Web
applications, but may be useful when writing scripts meant
using PHP from the command line.
Warning
This extension is EXPERIMENTAL. The behaviour of this extension
-- including the names of its functions and anything else
documented about this extension -- may change without notice
in a future release of PHP. Use this extension at your own
risk.
Ncurses is available for the following platforms:
AIX
BeOS
Cygwin
Digital Unix (aka OSF1)
FreeBSD
GNU/Linux
HPUX
IRIX
OS/2
SCO OpenServer
Solaris
SunOS
Requirements
You need the ncurses libraries and headerfiles. Download
the latest version from the ftp://ftp.gnu.org/pub/gnu/ncurses/
or from an other GNU-Mirror.
Installation
To get these functions to work, you have to compile the
CGI or CLI version of PHP with --with-ncurses[=DIR].
Runtime Configuration
The behaviour of these functions is affected by settings
in php.ini.
Table 1. Ncurses configuration options
Name Default Changeable
ncurses.value "42" PHP_INI_ALL
ncurses.string "foobar" PHP_INI_ALL
For further details and definition of the PHP_INI_* constants
see ini_set().
Resource Types
This extension has no resource types defined.
Predefined Constants
The constants below are defined by this extension, and will
only be available when the extension has either been compiled
into PHP or dynamically loaded at runtime.
Error codes
On error ncurses functions return NCURSES_ERR.