必须先搭建完整开发环境:核对php -v与php-config --version严格一致(如7.4.33),下载对应源码包确保含ext_skel.php,执行phpize生成configure,再./configure --with-php-config指定路径、make && make install,最后在php.ini中extension=myext.so并重启服务。

要在PHP 7.4上从零开始开发自定义扩展,必须先搭好能编译、调试、验证的完整开发环境——不是简单装个PHP就行,而是要让phpize能识别源码结构、configure能定位php-config、gcc能链接正确头文件和库路径。宝塔面板用户常卡在php-config路径错乱或ext_skel脚本缺失,Windows用户则普遍因缺少VC工具链导致phpize失败。
确认PHP 7.4源码与运行环境严格一致
第一步不是下载,是核对版本号。登录服务器终端,执行:
php -v
输出必须包含类似 【PHP 7.4.33 (cli)】 的精确版本字符串。如果显示的是7.4.0、7.4.30或8.x,哪怕只差一个小版本,后续用phpize生成的configure脚本也会因API差异而编译失败。
第二步检查php-config是否存在且路径可访问:
which php-config
若返回空或报错“command not found”,说明当前PHP安装包未附带开发工具链——宝塔面板编译安装的PHP 7.4默认自带,极速安装则不带,必须重装为编译模式。
第三步验证php-config输出是否匹配:
/www/server/php/74/bin/php-config --version
结果必须与php -v输出的主版本号完全一致(如7.4.33),否则扩展编译后将无法加载。
下载并解压对应版本PHP源码
去windows.php.net或github.com/php/php-src找PHP 7.4.33源码包(tar.gz或zip),【绝不能下载7.4.0、7.4.30或任意其他补丁版本】。
解压到非Web根目录的安全路径,例如:
/usr/src/php-7.4.33
进入解压后的ext目录,确认存在ext_skel.php脚本:
ls /usr/src/php-7.4.33/ext/ext_skel.php
没有这个文件就说明下载的是精简版或二进制包,必须换回完整源码包。
创建扩展骨架并初始化构建系统
方法一:使用ext_skel.php(推荐)
cd /usr/src/php-7.4.33/ext
php ext_skel.php --ext myext
这一步会在当前目录下生成myext子目录,内含config.m4、php_myext.h、myext.c等基础文件。注意:不要手动新建文件夹或复制模板,ext_skel会自动注入PHP 7.4专用的ZEND_API宏和模块结构体。
方法二:手动创建(仅限极简测试)
mkdir /www/wwwroot/myext
touch /www/wwwroot/myext/config.m4 /www/wwwroot/myext/php_myext.h /www/wwwroot/myext/myext.c
但必须把PHP 7.4源码中ext/standard/config.m4内容复制到新config.m4,并替换所有“standard”为“myext”,否则./configure会跳过该扩展。
进入扩展目录执行phpize:
cd /usr/src/php-7.4.33/ext/myext
phpize
phpize会读取php-config路径并生成configure脚本。如果提示“Cannot find autoconf”,说明系统缺少autoconf工具,需先执行yum install -y autoconf。
配置、编译并安装扩展
第一步:运行configure指定PHP配置路径
./configure --with-php-config=/www/server/php/74/bin/php-config
第二步:编译生成so文件
make
第三步:安装到PHP扩展目录
make install
执行完make install后,终端会输出类似“Installing shared extensions: /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/”的路径。请立刻记下这个路径——它就是php.ini中extension_dir的真实值,后续启用扩展必须依赖它。
第四步:编辑php.ini启用扩展
vi /www/server/php/74/etc/php.ini
在文件末尾添加:
extension=myext.so
第五步:重启PHP服务使配置生效
bt reload php
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











