php SerialPort和HID（Human Interface Device）使用方法

封面图 • 2025-09-24 • PHP

在 PHP 中，直接操作 **Serial Port（串口）** 和 **HID（Human Interface Device）** 是比较困难的，因为 PHP 本身并不是为底层硬件交互设计的语言。不过，可以通过一些扩展或外部工具来实现。

---

## 一、PHP 操作 Serial Port（串口）

### 1. 使用 `php_serial` 扩展（推荐）
这是一个经典的 PHP 串口通信库，适用于 Windows 和 Linux。

#### 安装方法：
```bash
composer require phpserial/phpserial
```

#### 示例代码：
```php
<?php
require 'vendor/autoload.php';

use PhpSerial\Serial;

$serial = new Serial();

// 设置串口设备路径（Linux 下是 /dev/ttyUSB0，Windows 下是 COM3）
$serial->deviceSet("/dev/ttyUSB0");

// 设置波特率
$serial->baudRateSet(9600);

// 打开串口
$serial->deviceOpen();

// 写入数据
$serial->write("Hello from PHP!");

// 读取数据
$data = $serial->readPort();
echo "Received: " . $data;

// 关闭串口
$serial->deviceClose();
```

> ⚠️ 注意：在 Linux 上可能需要 `sudo` 权限才能访问串口设备。

---

## 二、PHP 操作 HID（Human Interface Device）

HID 设备（如游戏手柄、键盘、鼠标等）通常通过 USB 接口与计算机连接。PHP 本身没有内置的 HID 支持，但可以通过以下方式实现：

### 方法一：使用 `hidapi` 库（C/C++ 扩展）

#### 1. 安装 hidapi

- 在 Linux 上：
  ```bash
  sudo apt-get install libhidapi-dev
  ```

- 在 Windows 上：
  下载 [hidapi](https://github.com/felipefialho/hidapi) 的 Windows 版本并配置。

#### 2. 使用 PHP 扩展 `php-hidapi`

目前 PHP 并没有官方的 HID API 扩展，但可以使用 C 扩展（例如 [php-hidapi](https://github.com/philippkeller/php-hidapi)）或者通过调用系统命令。

---

### 方法二：使用系统命令 + PHP 调用（Linux）

在 Linux 系统中，HID 设备通常位于 `/dev/hidrawX`（如 `/dev/hidraw0`）。你可以使用 `libusb` 或 `hidraw` 接口读写设备。

#### 示例：使用 `libusb` 读取 HID 设备（需编译 C 代码）

```c
#include <libusb-1.0/libusb.h>
#include <stdio.h>

int main() {
    libusb_context *ctx = NULL;
    libusb_device_handle *dev_handle = NULL;
    int ret;

ret = libusb_init(&ctx);
    if (ret < 0) {
        fprintf(stderr, "Init error\n");
        return 1;
    }

dev_handle = libusb_open_device_with_vid_pid(ctx, 0x1234, 0x5678); // 替换为你的设备 VID/PID
    if (!dev_handle) {
        fprintf(stderr, "Device not found\n");
        libusb_exit(ctx);
        return 1;
    }

unsigned char buf[64];
    int actual;
    ret = libusb_interrupt_transfer(dev_handle, 0x81, buf, sizeof(buf), &actual, 0);
    if (ret == 0 && actual > 0) {
        printf("Received %d bytes:\n", actual);
        for (int i = 0; i < actual; i++) {
            printf("%02x ", buf[i]);
        }
        printf("\n");
    }

libusb_close(dev_handle);
    libusb_exit(ctx);
    return 0;
}
```

然后在 PHP 中调用这个程序：

```php
<?php
$output = shell_exec('./my_hid_program');
echo $output;
```

---

### 方法三：使用 Python 脚本 + PHP 调用（推荐）

如果你不想编写 C 代码，可以使用 Python 的 `pyhid` 或 `hid` 库来处理 HID 设备，然后通过 PHP 调用 Python 脚本。

#### Python 示例（使用 `hid` 库）：
```python
import hid

h = hid.device()
h.open(0x1234, 0x5678)  # 替换为你的设备 VID/PID
data = h.read(64)
print(data)
```

#### PHP 调用 Python 脚本：
```php
<?php
$output = shell_exec('python3 hid_script.py');
echo $output;
```

---

## 三、总结对比

| 功能         | Serial Port       | HID               |
|--------------|-------------------|-------------------|
| PHP 原生支持 | ✅（通过扩展）     | ❌（需第三方）     |
| Linux 支持   | ✅                | ✅（需 libusb）   |
| Windows 支持 | ✅（COM 口）       | ✅（需驱动）       |
| 复杂度       | 中等              | 高（需 C/Python） |

---

## 四、推荐方案

| 场景                 | 推荐方案                             |
|----------------------|--------------------------------------|
| 串口通信             | `php_serial` 扩展                    |
| HID 设备读写         | 使用 Python + `hid` 库 + PHP 调用   |
| 自定义 HID 控制      | 使用 C 编写 libusb 程序 + PHP 调用  |

---