PHP Extension for Windows CLI native support.
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 FlagAll the VK_* constants defined here:
https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes
Additionally we defines keys from 0x30 to 0x5A.
const VK_0 = 0x30; // 0 key
const VK_1 = 0x31; // 1 key
const VK_2 = 0x32; // 2 key
const VK_3 = 0x33; // 3 key
const VK_4 = 0x34; // 4 key
const VK_5 = 0x35; // 5 key
const VK_6 = 0x36; // 6 key
const VK_7 = 0x37; // 7 key
const VK_8 = 0x38; // 8 key
const VK_9 = 0x39; // 9 key
const VK_A = 0x41; // A key
const VK_B = 0x42; // B key
const VK_C = 0x43; // C key
const VK_D = 0x44; // D key
const VK_E = 0x45; // E key
const VK_F = 0x46; // F key
const VK_G = 0x47; // G key
const VK_H = 0x48; // H key
const VK_I = 0x49; // I key
const VK_J = 0x4A; // J key
const VK_K = 0x4B; // K key
const VK_L = 0x4C; // L key
const VK_M = 0x4D; // M key
const VK_N = 0x4E; // N key
const VK_O = 0x4F; // O key
const VK_P = 0x50; // P key
const VK_Q = 0x51; // Q key
const VK_R = 0x52; // R key
const VK_S = 0x53; // S key
const VK_T = 0x54; // T key
const VK_U = 0x55; // U key
const VK_V = 0x56; // V key
const VK_W = 0x57; // W key
const VK_X = 0x58; // X key
const VK_Y = 0x59; // Y key
const VK_Z = 0x5A; // Z key/**
* 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 success, 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 {}/**
* Search filename in environment path.
*
* @param string $filename Filename to search for.
*
* @return string|bool The full path of the file, otherwise false.
*/
function wcli_where(string $filename): string|bool {}