php mqtt 实战项目：手把手教你搭建一个物联网通信系统

发布日期： 2025-09-26 阅读量： 作者： admin

最近瞎折腾了一下PHP搞MQTT，纯粹是实践记录，分享给大家看看过程。

起因很简单，手头有个小项目，想让网页能跟几个自己搭的小硬件通个信，传点简单的指令和状态。之前听说MQTT这玩意儿挺轻量，适合物联网这种场景，想着PHP我熟，能不能用PHP来搞定？

动手前的准备

第一步，得找个MQTT的中间件，也就是所谓的Broker。这玩意儿负责消息的中转。图省事，我直接在本机用Docker跑了个Mosquitto。一条命令下去，服务就起来了，监听着默认的1883端口，挺方便。

docker run -it -p 1883:1883 eclipse-mosquitto 类似这样，具体命令网上搜搜就有。

然后是PHP这边。PHP本身肯定不行，得找个库来帮忙处理MQTT协议。搜了一圈，发现有个叫 `php-mqtt/client` 的库看起来还行，用的人也比较多。那就它了。用Composer装上：

composer require php-mqtt/client

几秒钟就装好了，依赖也一起搞定。

开始尝试：发布消息

准备工作做完，就该写代码了。先试试最基本的，用PHP发个消息出去。

写了个简单的PHP脚本：

先 `require` Composer的 `*` 文件。
然后按照库的文档，创建一个MQTT客户端实例。
配置好Broker的地址（就是我本地的 `127.0.0.1`）和端口（`1883`）。
调用连接方法。
连接成功后，调用发布（publish）方法，指定一个主题（topic），比如 `iot/device/command`，再随便写点消息内容，比如 `{"action":"turn_on"}`。
断开连接。

为了看效果，我另外开了个MQTT的客户端工具（比如MQTT Explorer）连接到同一个Broker，订阅了 `iot/device/command` 这个主题。

运行PHP脚本... 成了！客户端工具那边立马收到了我发的消息。第一次成功，感觉还挺顺畅的。

再试试：订阅消息

发消息没问题了，那接收消息？就是让PHP脚本一直听着，等Broker那边有新消息推过来。这个叫订阅（subscribe）。

我又写了个脚本，或者在之前的脚本上改：

同样是连接Broker。
连接成功后，调用订阅（subscribe）方法，告诉Broker我要监听哪个主题，比如 `iot/device/status`。
关键来了，订阅之后，得让脚本一直跑着等消息。库提供了一个循环（loop）方法，让脚本阻塞在那里，或者定期检查有没有新消息进来。
当收到消息时，会触发一个回调函数，我在这个函数里把收到的消息打印出来。

在命令行里跑这个PHP脚本：`php subscribe_*`

然后我用另一个工具或者之前的发布脚本，往 `iot/device/status` 主题发了条消息。这边PHP脚本果然收到了，打印了出来。

遇到的坎儿和思考

看起来收发都没问题了？但是，订阅这里有个麻烦事。

PHP通常是用来处理Web请求的，请求来了，执行完脚本，进程就结束了。但MQTT订阅需要脚本一直运行着，像个守护进程一样。用 `php cli` 方式跑，是可以，但总感觉不太对劲。

你想，一个PHP脚本长时间跑着，内存管理、错误处理、意外退出了怎么办？怎么保证它稳定可靠地一直监听？这跟PHP平时干的活儿不太一样。

查了查，有人用Swoole或者Workerman这种PHP的扩展来解决，它们能让PHP像*或者Go那样跑常驻内存的服务，处理异步、网络连接这些更专业。但这就引入了新的学习成本和复杂性了。

如果不用这些扩展，单纯用PHP CLI跑，就得自己写很多额外的逻辑来保证稳定性，比如用 `supervisor` 之类的工具来管理进程，或者写个循环不断重启脚本，感觉挺别扭的。

最终我的用法

折腾了一番，我的结论是：

用PHP来发布MQTT消息非常方便。比如，在网页上点个按钮，触发后端的PHP代码，PHP连上Broker发个命令出去，然后就结束了。这很符合PHP的模式。
用PHP来订阅并长期监听MQTT消息，就有点力不从心了，除非上Swoole/Workerman这类“重武器”，或者你的场景要求不高，偶尔断了也没事。

在我那个小项目里，是这样用的：

网页端的控制（比如开关灯）就用PHP直接发布MQTT命令给设备。

设备状态的上报，设备直接发MQTT消息到Broker。至于网页端怎么显示最新状态，我没用PHP去实时订阅。而是用了个折中的办法：设备把状态也存一份到数据库，或者用另一个更适合长连接的简单服务（比如Python脚本）订阅MQTT消息再写入数据库/缓存。然后我的PHP网页就定时（比如用AJAX轮询或者页面刷新时）去读数据库或缓存里的最新状态来显示。

这样就绕开了PHP长时间运行监听的那个坎儿，也能满足基本需求。虽然不是最实时，但够用了。

PHP搞MQTT是完全可行的，特别是发消息。收消息（订阅）这块儿，得看你的具体场景和接受的复杂度。对于简单的集成或者控制，PHP没问题。但要是想用PHP构建一个核心的、高性能的、需要处理大量实时消息的物联网后台，那可能得掂量掂量，或者考虑上专门的扩展，或者干脆用更适合干这活儿的语言（比如*, Go, Python等）。

这回实践就记录到这，希望能给同样想尝试的朋友一点参考。

上一篇: 华云主机常见问题解答，帮你少走弯路！

php mqtt 实战项目：手把手教你搭建一个物联网通信系统

随便看看