PHP无法直接运行于裸机微控制器,仅支持能运行Linux的嵌入式平台,如树莓派(推荐Raspberry Pi OS Bookworm)、ARM工业主板(BeagleBone、NanoPi)、x86工控机;ESP32等MCU需通过串口/MQTT与PHP主控通信。PHP 本身不直接运行在裸机微控制器(如 STM32、AVR)上,它依赖操作系统和 POSIX 环境,因此所谓“PHP 嵌入式硬件”,实际是指**能运行 Linux(或类 Unix)且资源足够启动 PHP 解释器的嵌入式单板计算机或 SoC 平台**。目前主流支持良好、社区验证充分的硬件有以下几类:
从 Pi 3 开始,Raspberry Pi OS (32/64-bit) 可原生安装 php8.2 或更高版本,无需交叉编译;GPIO 控制可通过 sysfs + file_put_contents() 或扩展如 php-ext-rpi-gpio 实现。实测 Pi 4B(2GB)运行带 Web UI 的 PHP IoT 管理后台无压力。
raspios-bookworm-arm64-lite(轻量、无桌面,节省内存)sudo raspi-config → Interface Options 开启
访问 /dev/i2c-1 需将用户加入 i2c 组:sudo usermod -aG i2c $USER
严格来说,ESP32 系列芯片本身不支持 PHP —— 但搭载了 ESP-IDF + Linux-on-LiteX 或运行 MicroPython + PHP-to-MicroPython 转译层 的实验性方案已出现;更现实的路径是:用 ESP32 做传感器节点(AT 固件或 Arduino Core),由树莓派等主控用 PHP 通过串口/UART 或 MQTT 协议与其通信。不要试图在 ESP32 上直接 apt install php,会失败。
bash: php: command not found 或 Segmentation fault (core dumped) —— 这是硬生生往 RTOS 环境塞 PHP 解释器导致的shell_exec("esptool.py --port /dev/ttyUSB0 read_mac") 管理固件,而非让 ESP32 执行 PHP这类板子出厂预装 Debian/Ubuntu,php 包可直接 apt install,且厂商通常提供设备树(DTS)补丁,方便 PHP 扩展调用 CAN、SPI、PWM 等外设。例如 NanoPi NEO3(RK3328)在 Armbian 上运行 PHP 8.3 + php-ext-spi 可直接读取 ADC 传感器数据。
spidev 设备节点可能不可见)/dev/spidev0.0 权限不足 → 需 sudo chmod 666 /dev/spidev0.0 或加 udev 规则很多工业现场仍有运行 Debian 12 的 Atom D2550 小主机,内存 2GB,完全可胜任 PHP + SQLite + Modbus TCP 网关角色。优势在于 x86 指令集兼容性好,所有 PHP 扩展(包括 php-ext-mbstring、php-ext-snmp)开箱即用,调试也比 ARM 方便得多。
date.timezone 未设导致日志时间错乱,尤其对接 PLC 时时间戳同步失败opcache.enable=1 + realpath_cache_size=4M,避免频繁文件 stat 拖慢 Modbus 请求响应dmesg | grep tty 可能看不到 ttyUSB0
/sys、/dev、ioctl)或专用扩展封装。别跳过 dmesg 和 lsmod,它们比 phpinfo() 更早告诉你硬件到底认没认出来。