Windows CLI native support for PHP
Color constants can be use in combination with the Bright flag.
Ex: wcli_echo("Hello World!", Black, Red|Bright);
const Red = 4; // Red color
const Green = 2; // Green color
const Blue = 1; // Blue color
const Yellow = 14; // Yellow color
const Purple = 5; // Purple color
const Aqua = 3; // Aqua color
const White = 7; // White color
const Black = 0; // Black color
const Grey = 8; // Grey color
const Bright = 8; // Bright Flag/**
* Get the console output handle.
*
* @return int|bool Output handle
*/
function wcli_get_output_handle(): int|bool {}/**
* Get the console input handle.
*
* @return int|bool Input handle
*/
function wcli_get_input_handle(): int|bool {}/**
* Get the console window handle.
*
* @return int|bool Window handle
*/
function wcli_get_window_handle(): int|bool {}/**
* Return the console title.
*
* @return string|bool The console title, otherwise false.
*/
function wcli_get_console_title(): string|bool {}/**
* Set the console title.
*
* @param string $title The console title
*
* @return bool True if success, else false.
*/
function wcli_set_console_title(string $title): bool {}/**
* Retrieve the size and the scrolling in characters of the console.
* Return an array [w, h, x, y]
*
* @return array|bool Return the console size or FALSE.
*/
function wcli_get_console_size(): array|bool {}/**
* Set the console size in characters.
* Set the $force parameter to true to force the buffer at the same size.
*
* @param int $w Width of the console in characters
* @param int $h Height of the console in characters
* @param bool $force Default false.
*
* @return bool True if success, else false.
*/
function wcli_set_console_size(int $w, int $h, bool $force = false): bool {}/**
* Retrieve console buffer size in characters.
* Return an array [w, h]
*
* @return array|bool Return the buffer size or FALSE.
*/
function wcli_get_buffer_size(): array|bool {}/**
* Set the console buffer size in characters.
* The buffer size need to be bigger than the console size.
* Otherwise, set the console size before the buffer size.
*
* @param int $w Width of the buffer in characters
* @param int $h Height of the buffer in characters
*
* @return bool True if success, else false.
*/
function wcli_set_buffer_size(int $w, int $h): bool {}/**
* Retrieves the input code page used by the console.
* See: https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers
*
* @return int Code Page ID
*/
function wcli_get_code_page(): int {}/**
* Set the input code page used by the console.
* See: https://learn.microsoft.com/en-us/windows/win32/intl/code-page-identifiers
*
* @param int $cpID Code Page ID
*
* @return bool True if success, else false.
*/
function wcli_set_code_page(int $cpID): bool {}/**
* Retrieve console font size in pixels.
* Return an array [width, height]
*
* @return array|bool The font size, otherwise false.
*/
function wcli_get_font_size(): array|bool {}/**
* Get the foreground color.
*
* @return int Color Constant
*/
function wcli_get_foreground_color(): int {}/**
* Set the foreground color.
*
* @param int $color Color Constant
*
* @return bool True if success, else false.
*/
function wcli_set_foreground_color(int $color): bool {}/**
* Get the background color.
*
* @return int Color Constant
*/
function wcli_get_background_color(): int {}/**
* Set the background color.
*
* @param int $color Color constant
*
* @return bool True if success, else false.
*/
function wcli_set_background_color(int $color): bool {}/**
* Retrieve console foreground and background colors.
* Return an array [foreColor, backColor]
*
* @return array|bool The array of colors or False
*/
function wcli_get_colors(): array|bool {}/**
* Set the foreground and background color at once.
*
* @param int $fore Foreground color constant
* @param int $back Background color constant
*
* @return bool True if success, else false.
*/
function wcli_set_colors(int $fore, int $back): bool {}/**
* Swap foreground and background colors.
*
* @return bool True if success, else false.
*/
function wcli_inverse_colors(): bool {}/**
* Reset console colors to default.
*
* @return bool True if success, else false.
*/
function wcli_reset_colors(): bool {}/**
* Hide console cursor.
*
* @return bool True if success, else false.
*/
function wcli_hide_cursor(): bool {}/**
* Show console cursor.
*
* @return bool True if success, else false.
*/
function wcli_show_cursor(): bool {}/**
* Retrieve cursor visibility.
*
* @return bool True if visible, else false.
*/
function wcli_get_cursor_visibility(): bool {}/**
* Set cursor visibility.
*
* @param bool $visible True to show, false to hide.
*
* @return bool True if success, else false.
*/
function wcli_set_cursor_visibility(bool $visible): bool {}/**
* Retrieve cursor size.
* The size value is between 0 and 100.
*
* @return int|bool The cursor size if success, else false.
*/
function wcli_get_cursor_size(): int|bool {}/**
* Set cursor size.
*
* @param int $size Cursor size between 0 and 100.
*
* @return bool True if success, else false.
*/
function wcli_set_cursor_size(int $size): bool {}/**
* Retrieve cursor position.
* Return an array [x, y]
*
* @return array|bool The cursor position or false.
*/
function wcli_get_cursor_position(): array|bool {}/**
* Set cursor position.
*
* @param int $x X position in characters
* @param int $y Y position in characters
*
* @return bool True if success, else false.
*/
function wcli_set_cursor_position(int $x, int $y): bool {}/**
* Move cursor position relatively to the current cursor position.
*
* @param int $x X move in characters
* @param int $y Y move in characters
*
* @return bool True if success, else false.
*/
function wcli_move_cursor(int $x, int $y): bool {}/**
* Echo string with colors. Foreground and background colors are optionals.
*
* @param string $str String to be echo.
* @param int $fore Foreground color constant
* @param int $back Background color constant
*
* @return bool True if success, else false.
*/
function wcli_echo(string $str, int $fore = null, int $back = null): bool {}/**
* Print string with colors at the x-y position without changing cursor position.
*
* @param string $str String to be print
* @param int $x X position in characters
* @param int $y Y position in characters
* @param int $fore Foreground color constant
* @param int $back Background color constant
*
* @return bool True if success, else false.
*/
function wcli_print(string $str, int $x = null, int $y = null, int $fore = null, int $back = null): bool {}/**
* Method fill rect with character and colors.
*
* @param int $c Character to fill
* @param int $x X position of the rect
* @param int $y Y position of the rect
* @param int $w Width of the rect
* @param int $h Height of the rect
* @param int $fore Foreground color constant
* @param int $back Background color constant
*
* @return bool True if success, else false.
*/
function wcli_fill(int $c, int $x, int $y, int $w, int $h, int $fore = null, int $back = null): bool {}/**
* Clear the console.
*
* @return bool True if succe
5D32
ss, else false.
*/
function wcli_clear(): bool {}/**
* Pause process and wait for a keyboard input.
*
* @return int|bool The input character otherwise false.
*/
function wcli_get_key(): int|bool {}/**
* Get an async keyboard input.
*
* @return int|bool The input character otherwise false.
*/
function wcli_get_key_async(): int|bool {}/**
* Flush console input buffer.
*
* @return bool True if success, else false.
*/
function wcli_flush_input_buffer(): bool {}/**
* Verify if console window is on top.
*
* @return bool True if window is on top, otherwise false.
*/
function wcli_is_on_top(): bool {}/**
* Verify if console window is visible.
*
* @return bool True if window is visible, otherwise false.
*/
function wcli_is_visible(): bool {}/**
* Retrieve console window area.
* Return an array [x, y, width, height]
*
* @return array|bool The console window area array, otherwise false.
*/
function wcli_get_window_area(): array|bool {}/**
* Retrieve console window inner area.
* Return an array [x, y, width, height]
*
* @return array|bool The console window inner area array, otherwise false.
*/
function wcli_get_client_area(): array|bool {}/**
* Minimize console window.
*
* @return bool True if success, else false.
*/
function wcli_minimize(): bool {}/**
* Maximize console window.
*
* @return bool True if success, else false.
*/
function wcli_maximize(): bool {}/**
* Restore console window.
*
* @return bool True if success, else false.
*/
function wcli_restore(): bool {}/**
* Force console window to activate.
*
* @return bool True if success, else false.
*/
function wcli_activate(): bool {}/**
* Flash console window.
*
* @param bool $invert If TRUE, the window is flashed from one state to the other.
*
* @return bool True if success, else false.
*/
function wcli_flash(bool $invert = false): bool {}/**
* Bring console window to front.
*
* @return bool True if success, else false.
*/
function wcli_bring_to_front(): bool {}/**
* Set console window position.
*
* @param int $x X position in pixels
* @param int $y Y position in pixels
*
* @return bool True if success, else false.
*/
function wcli_set_position(int $x, int $y): bool {}/**
* Return module/executable full path.
* Usefull for SAPI.
*
* @return string Module full path
*/
function wcli_get_module_path(): string {}/**
* Get parent process ID.
*
* @return int|bool Parent process ID, otherwise false.
*/
function wcli_get_parent_pid(): int|bool {}/**
* Know if the process was lunch by a terminal.
*
* @return bool True if yes, otherwise false.
*/
function wcli_is_cmd_call(): bool {}