kingbes/phprobot

Desktop automation for PHP Windows

Maintainers

Details

github.com/KingBes/php-windows-robot

Source

Issues

Installs: 15

Dependents: 0

Suggesters: 0

Security: 0

Stars: 17

Watchers: 2

Forks: 3

Open Issues: 2

Language:V

pkg:composer/kingbes/phprobot

v0.0.4 2024-08-08 07:34 UTC

Requires

  • php: >=8.1.0
  • ext-ffi: *

Apache-2.0 4c3ebe919c41a9c5f20a4ae67e4328627b11017c

  • kingbes <1164601554.woop@qq.com>

phpwindowsDesktop automation

This package is auto-updated.

Last update: 2025-10-08 10:26:53 UTC

README

PHP Windows的桌面自动化

composer

composer require kingbes/phprobot

要求

php >=8.1.0

拓展 FFI

系统 Windows

文档

鼠标

use KingBes\PhpRobot\Mouse;

$Mouse = new Mouse();
/**
 * 鼠标指针位置 function
 *
 * @return array
 */
public function mouse_pos(): array
{}

/**
 * 鼠标单击 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_click(string $button): self
{}

/**
 * 鼠标双击 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_double_click(string $button): self
{}

/**
 * 将鼠标(左)拖动到指定位置。 function
 *
 * @param integer $x
 * @param integer $y
 * @return self
 */
public function mouse_left_drag(int $x, int $y): self
{}

/**
 * 相对于当前位置拖动鼠标(左)。 function
 *
 * @param integer $offset_x
 * @param integer $offset_y
 * @return self
 */
public function mouse_drag_rel(int $offset_x, int $offset_y): self
{}

/**
 * 移动鼠标到 x y function
 *
 * @param integer $x
 * @param integer $y
 * @return self
 */
public function mouse_move_mouse(int $x, int $y): self
{}

/**
 * 相对于当前位置移动鼠标。 function
 *
 * @param integer $offset_x
 * @param integer $offset_y
 * @return self
 */
public function move_mouse_rel(int $offset_x, int $offset_y): self
{}

/**
 * 鼠标平滑移动指定位置 function
 *
 * @param integer $x
 * @param integer $y
 * @param integer $duration_ms 毫秒
 * @param string $tween 预览补间 参数请看下面 `预览补间` 说明
 * @return self
 */
public function move_mouse_smooth(int $x, int $y, int $duration_ms, string $tween): self
{}

/**
 * 当前平滑移动鼠标 function
 *
 * @param integer $offset_x
 * @param integer $offset_y
 * @param integer $duration_ms 毫秒
 * @param string $tween 预览补间 参数请看下面 `预览补间` 说明
 * @return self
 */
public function move_mouse_smooth_rel(int $offset_x, int $offset_y, int $duration_ms, string $tween): self
{}

/**
 * 鼠标按下 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_down(string $button): self
{}

/**
 * 鼠标弹起 function
 *
 * @param string $button left right middle
 * @return self
 */
public function mouse_up(string $button): self
{}

屏幕

use KingBes\PhpRobot\Screen;

$Screen = new Screen();
/**
 * 获取屏幕指定位置的颜色rgb function
 *
 * @param integer $x
 * @param integer $y
 * @return array
 */
public function pixel_color(int $x, int $y): array
{}

/**
 * 获取屏幕大小 function
 *
 * @return array
 */
public function screen_size(): array
{}

键盘

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;
/**
 * 是否点击键盘某键 function
 *
 * @param integer $key 整数键码值
 * @return boolean
 */
public function isKeyPressed(int $key): bool
{}

/**
 * 点击键盘某键 function
 *
 * @param integer $key 整数键码值
 * @return void
 */
public function onClickKey(int $key): void
{}

/**
 * 按下键盘某键 function
 *
 * @param integer $key
 * @return self
 */
public function pressKey(int $key): self
{}

/**
 * 弹起键盘某键 function
 *
 * @param integer $key
 * @return self
 */
public function releaseKey(int $key): self
{}

实例一 获取当前鼠标位置

// 引入
use KingBes\PhpRobot\Mouse;

// 实例
$Mouse = new Mouse();
// 获取鼠标当前指针位置
$pos = $Mouse->mouse_pos();

var_dump($pos);

实例一点二 鼠标按下和弹起

// 引入
use KingBes\PhpRobot\Mouse;

sleep(3);// 等待
// 按下 左键
$Mouse->mouse_down("left");

sleep(3);// 等待
// 弹起 左键
$Mouse->mouse_up("left");

实例二 监听键盘A键

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

while (true) {
    if ($Keyboard->isKeyPressed(65)) {
        echo "点击了键盘A \n";
    }
    usleep(100); // 减轻负担
}

实例三 按下键盘A键

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

sleep(5); //延迟5秒

$Keyboard->onClickKey(65)

实例三点二 按下和弹起键盘某键

use KingBes\PhpRobot\Keyboard;

$Keyboard = new Keyboard;

sleep(3);// 等待
// 按下
$Keyboard->pressKey(65);

sleep(3);// 等待
// 弹起
$Keyboard->releaseKey(65);

预览补间 可用的鼠标补间

你可以在这里预览补间: https://easings.net/

  • linear
  • ease_in_quad
  • ease_out_quad
  • ease_in_out_quad
  • ease_in_cubic
  • ease_out_cubic
  • ease_in_out_cubic
  • ease_in_quart
  • ease_out_quart
  • ease_in_out_quart
  • ease_in_quint
  • ease_out_quint
  • ease_in_out_quint
  • ease_in_sine
  • ease_out_sine
  • ease_in_out_sine
  • ease_in_expo
  • ease_out_expo
  • ease_in_out_expo
  • ease_in_circ
  • ease_out_circ
  • ease_in_out_circ
  • ease_in_elastic
  • ease_out_elastic
  • ease_in_out_elastic
  • ease_in_back
  • ease_out_back
  • ease_in_out_back
  • ease_in_bounce
  • ease_out_bounce
  • ease_in_out_bounce

键盘的整数键码值

在 Windows 操作系统中，键盘上的一些按键对应着特定的整数键码值（keyCode）。以下是一些常见的 win 键盘按键及其对应的十进制数字：

  • 字母和数字键：
    • a：65
    • b：66
    • c：67
    • d：68
    • e：69
    • f：70
    • g：71
    • h：72
    • i：73
    • j：74
    • k：75
    • l：76
    • m：77
    • n：78
    • o：79
    • p：80
    • q：81
    • r：82
    • s：83
    • t：84
    • u：85
    • v：86
    • w：87
    • x：88
    • y：89
    • z：90
    • 0：48
    • 1：49
    • 2：50
    • 3：51
    • 4：52
    • 5：53
    • 6：54
    • 7：55
    • 8：56
    • 9：57
  • 控制键：
    • Backspace：8
    • Tab：9
    • Clear：12
    • Enter：13
    • Shift：16
    • Control：17
    • Alt：18
    • Caps Lock：20
    • Esc：27
    • Spacebar：32
    • Page Up：33
    • Page Down：34
    • End：35
    • Home：36
    • Left Arrow：37
    • Up Arrow：38
    • Right Arrow：39
    • Down Arrow：40
    • Insert：45
    • Delete：46
    • Num Lock：144
  • 数字键盘上的键：
    • 0：96
    • 1：97
    • 2：98
    • 3：99
    • 4：100
    • 5：101
    • 6：102
    • 7：103
    • 8：104
    • 9：105
    • *：106
    • +：107
    • Enter：108
    • -：109
    • .：110
    • /：111
  • 其他键：
    • Left Windows 键：91
    • Right Windows 键：92
    • Applications 键（右 Ctrl 左边键，点击相当于点击鼠标右键，会弹出快捷菜单）：93