PHP 7.3扩展开发必须使用对应源码树的头文件，关键路径为main/php.h和Zend/zend_API.h；需通过php-config --include-dir获取真实路径，正确包含php.h等头文件，并用phpize、configure及gcc -E验证头文件链完整性。
在PHP 7.3环境下开发自定义扩展时，头文件依赖管理直接决定编译能否通过、函数签名是否匹配、以及扩展能否被PHP内核正确加载。漏掉或错配一个头文件，轻则编译报错“unknown type name”，重则运行时崩溃。
确认PHP 7.3开发头文件路径
进入PHP源码目录（非安装目录），检查是否存在main/php.h和Zend/zend_API.h——这两个是扩展开发的基石文件。【必须使用与目标PHP 7.3二进制完全对应的源码树，混用7.3.0与7.3.28的头文件可能导致zend_object_handle结构偏移错误】
若无源码，从宝塔面板或phpstudy中提取：宝塔→软件商店→PHP 7.3→设置→“编译参数”里复制configure命令，从中提取--with-php-config=/www/server/php/73/bin/php-config路径，再执行/www/server/php/73/bin/php-config --include-dir获取真实头文件目录。
扩展工程中引入头文件的标准写法
在扩展主C文件（如myext.c）顶部，按顺序包含：
立即学习“PHP免费学习笔记（深入）”；
#include "php.h"
#include "php_ini.h"
#include "ext/standard/info.h"
#include "php_myext.h"（你的扩展头文件）
注意："php.h"必须是双引号且不带路径，它由PHP构建系统自动定位；【绝对不能写成<php.h>，否则预处理器会跳过PHP自带头文件搜索路径，导致找不到zend_string等类型定义】
处理第三方库头文件依赖
方法一：静态嵌入头文件
将所需第三方头文件（如libcurl/curl.h）整个拷贝到扩展目录下的deps/子目录，然后在config.m4中添加：
PHP_ADD_INCLUDE($ext_srcdir/deps)
方法二：系统级依赖声明
在config.m4中启用pkg-config检测：
PHP_CHECK_LIBRARY(curl, curl_global_init, [
PHP_ADD_LIBRARY_WITH_PATH(curl, /usr/lib, MYEXT_SHARED_LIBADD)
PHP_ADD_INCLUDE(/usr/include/curl)
], [AC_MSG_ERROR([curl library not found])])
这一步失败会导致./configure直接退出，比编译时报错更早暴露问题。
验证头文件链完整性
第一步：运行phpize生成构建脚本
第二步：执行./configure --enable-myext，观察输出中是否出现checking for myext support... yes及所有头文件路径被正确识别
第三步：手动触发预处理检查：gcc -E -I /www/server/php/73/include/php -I /www/server/php/73/include/php/main -I /www/server/php/73/include/php/Zend myext.c -o myext.i 2>/dev/null || echo "头文件链断裂"——若输出为空，说明头文件可连通；若报错fatal error: zend_API.h: No such file or directory，说明--include-dir路径未覆盖Zend子目录。
