使用PHP获取Timmy TM20指纹机考勤数据遇连接错误求替代方案

先解决当前连接错误 #

你遇到的socket_sendto(): Host lookup failed [11001]错误是主机解析失败，先做以下排查：

• 给设备设静态IP：TM20默认可能用动态IP，在设备操作界面设置和笔记本同网段的静态IP（比如笔记本是192.168.1.100，设备设为192.168.1.101）
• 验证连通性：用ping 设备静态IP测试，不通的话检查网线、设备网络开关
• 检查端口：这类设备默认用TCP 4370端口，确认笔记本防火墙没拦截该端口，可临时关闭防火墙测试

替代PHP方案 #

1. 原生Socket直接实现 #

基于ZKTeco通用协议，用PHPsocket扩展手动实现通信，核心步骤是握手、发送指令、解析二进制返回数据：

$deviceIp = '192.168.1.101';
$devicePort = 4370;

// 创建TCP连接
$socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
if (!socket_connect($socket, $deviceIp, $devicePort)) {
    die("连接失败: " . socket_strerror(socket_last_error()));
}

// 发送握手包（ZKTeco协议固定格式）
$handshake = hex2bin('50500018000000000000000000000000000000000000000000000000');
socket_write($socket, $handshake);
$handshakeResp = socket_read($socket, 1024);

// 发送获取考勤记录的指令
$getAttCmd = hex2bin('50500028000000000000000200000000000000000000000000000000000000000000000000000000');
socket_write($socket, $getAttCmd);
$attData = socket_read($socket, 4096);

// 解析二进制数据：按ZKTeco协议格式提取考勤时间、用户ID等字段
socket_close($socket);

2. 轻量ZKTeco PHP库 #

选择无框架依赖的纯PHP实现库（优先选维护活跃的），这类库封装了协议握手、指令发送和数据解析逻辑，只需传入设备IP和端口即可调用，适配大部分ZKTeco兼容指纹机（包括TM20）。

3. 离线导出+PHP解析 #

如果不需要实时获取数据，可在TM20设备上把考勤、用户数据导出到U盘（设备支持该功能），再用PHP读取U盘里的TXT/CSV文件，解析成结构化数据，适合小批量场景。

内容的提问来源于stack exchange，提问作者Sriyan Arosha