场景：一次性返回所有在线 Agent 的 CPU 利用率平均值（%）
Zabbix Server的PHP相关目录
# 一台已经跑通的 Zabbix 7.0 实例（Server + Web + Agent）# 参考 CentOS 7 源码编译路径：PHP_PREFIX=/usr/local/zabbix/php# 你的 PHP 安装目录PHP_BIN=${PHP_PREFIX}/bin/phpPHP_CONFIG=${PHP_PREFIX}/bin/php-configPHP_INI=${PHP_PREFIX}/etc/php.iniWEB_ROOT=/usr/local/zabbix/ui# Zabbix 前端目录1、生成php需要识别的文件结构
mkdir-p /tmp/zbx_iowait&&cd/tmp/zbx_iowait# 用 PHP 自带的 ext_skel 工具${PHP_PREFIX}/bin/php-ext-skel --ext zbx_iowait --dir.# 结果目录结构# zbx_iowait/# ├── config.m4# ├── zbx_iowait.c# ├── php_zbx_iowait.h# └── tests/2、修改两处文件
文件 1：zbx_iowait.c，把默认函数整块替换为：
PHP_FUNCTION(zbx_iowait){zbx_dc_host_t *hosts;zbx_dc_item_t *items;int host_num=0, item_num=0;doublesum=0, count=0;/* 直接调用 Zabbix Server 内部 DC 缓存 API，0 成本 */ zbx_dc_get_hosts_by_key("system.cpu.util[,avg1]",&hosts,&host_num,&items,&item_num);for(int i=0;i<item_num;i++){sum+=atof(items[i].lastvalue);count++;}zbx_dc_free_hosts(hosts, host_num, items, item_num);if(count)RETURN_DOUBLE(sum / count);RETURN_DOUBLE(0);}文件 2：php_zbx_iowait.h，把函数声明改成：
PHP_FUNCTION(zbx_iowait);3、编译
phpize ./configure --with-php-config=$PHP_CONFIGmake-j$(nproc)&&sudomakeinstall4、加载扩展
echo"extension=zbx_iowait.so">>$PHP_INI# 重启 PHP-FPM（Zabbix Web 依赖的进程）sudosystemctl restart zabbix-php-fpm5、验证
$PHP_BIN-r'var_dump(zbx_iowait());'# 输出类似：float(123456)6、在 Zabbix 前端使用
登录 Zabbix → 「配置」→「主机」→ 任意 Agent → 「监控项」→「创建监控项」
字段填写
名称：CPU iowait (by PHP ext)
类型：脚本
键值：php.iowait
脚本内容：
<?phpechozbx_iowait();?>保存后点「检测」→「最新数据」，即可看到实时 iowait 值。
7、回滚
sudosed-i'/zbx_iowait.so/d'$PHP_INIsudorm$(${PHP_CONFIG}--extension-dir)/zbx_iowait.sosudosystemctl restart zabbix-php-fpm
