php GPIO 中文介绍

封面图 • 2025-10-14 • PHP

在 PHP 中使用 GPIO（General Purpose Input/Output，通用输入输出）通常用于与硬件进行交互，例如控制树莓派（Raspberry Pi）或其他嵌入式设备的引脚。由于 PHP 本身并不是为硬件控制设计的语言，因此需要借助扩展或系统命令来实现对 GPIO 的操作。

以下是对 **PHP 中 GPIO 的中文介绍**：

---

## 一、什么是 GPIO？

GPIO 是一种可以由软件控制的通用数字输入/输出引脚，常用于嵌入式系统中。通过这些引脚，你可以：

- 控制 LED 灯的亮灭
- 读取按钮的状态
- 控制电机、继电器等外设

在树莓派上，GPIO 引脚是通过 `/sys/class/gpio` 或 `/dev/gpiomem` 这样的 Linux 内核接口提供的。

---

## 二、PHP 如何操作 GPIO？

PHP 本身不支持直接操作 GPIO，但可以通过以下几种方式实现：

### 方法 1：使用 Shell 命令调用 `gpio` 工具（如 WiringPi）

WiringPi 是一个用于树莓派的 C 库，也提供了命令行工具 `gpio`，可以在 PHP 中通过 `shell_exec()` 调用。

#### 示例代码：

```php
<?php
// 设置 GPIO 17 为输出模式
shell_exec('gpio mode 17 out');

// 设置 GPIO 17 为高电平
shell_exec('gpio write 17 1');

// 设置 GPIO 17 为低电平
shell_exec('gpio write 17 0');
?>
```

> 注意：你需要先安装 WiringPi 并确保 `gpio` 命令可用。

---

### 方法 2：直接访问 Linux 的 GPIO 接口（通过文件系统）

Linux 提供了 `/sys/class/gpio` 接口，可以直接通过文件操作控制 GPIO。

#### 示例代码：

```php
<?php
$gpio = 17;

// 导出 GPIO
file_put_contents('/sys/class/gpio/export', $gpio);

// 设置方向为输出
file_put_contents("/sys/class/gpio/gpio$gpio/direction", "out");

// 设置值为高电平
file_put_contents("/sys/class/gpio/gpio$gpio/value", 1);

// 设置值为低电平
file_put_contents("/sys/class/gpio/gpio$gpio/value", 0);

// 取消导出
file_put_contents('/sys/class/gpio/unexport', $gpio);
?>
```

> ⚠️ 注意：你需要有 root 权限才能写入这些文件。

---

### 方法 3：使用 PHP 扩展（如 `gpio` 扩展）

有些第三方 PHP 扩展可以更方便地操作 GPIO，比如：

- `gpio` 扩展（可能需要自己编译）
- 使用 `exec()` 调用 Python 脚本（如使用 RPi.GPIO）

#### 示例（Python 脚本 + PHP 调用）：

```php
<?php
// 调用 Python 脚本控制 GPIO
shell_exec('python3 control_gpio.py');
?>
```

Python 脚本 `control_gpio.py` 示例：

```python
import RPi.GPIO as GPIO

GPIO.setmode(GPIO.BCM)
GPIO.setup(17, GPIO.OUT)
GPIO.output(17, GPIO.HIGH)
```

---

## 三、注意事项

1. **权限问题**：大多数 GPIO 操作需要 root 权限。
2. **安全问题**：不要随意操作 GPIO，避免损坏硬件。
3. **平台限制**：上述方法主要适用于树莓派（Raspberry Pi）等基于 Linux 的嵌入式设备。

---

## 四、推荐学习资源

- [WiringPi 官网](http://wiringpi.com/)
- [树莓派 GPIO 引脚图](https://pinout.xyz/)
- [PHP shell_exec 函数文档](https://www.php.net/manual/zh/function.shell-exec.php)

---

如果你是初学者，建议从 **使用 WiringPi 的 `gpio` 命令** 或 **调用 Python 脚本** 开始，这样更容易上手和调试。

如果你有具体的硬件环境（如树莓派型号、使用的操作系统等），我可以提供更详细的指导。