手动编译安装PHP扩展需五步：一、确认PHP版本及phpize路径，下载匹配源码并初始化；二、用phpize生成configure脚本；三、执行configure并指定php-config及依赖参数；四、make编译后make install安装so文件；五、在php.ini中添加extension=extname.so并验证加载。
如果您需要在PHP环境中添加特定功能，但当前PHP未包含所需扩展，则需要手动编译安装该扩展。以下是针对源码方式编译安装PHP扩展的标准步骤：
一、确认PHP源码路径与phpize位置
编译扩展前必须确保已安装PHP源码包，并能调用对应版本的phpize工具，否则无法生成正确的配置脚本和编译环境。
1、执行 php -v 查看当前PHP版本号。
2、执行 which phpize 获取phpize所在路径，若提示未找到，需先安装php-dev或php-devel包。
3、前往PHP官方下载页匹配相同版本的源码包，解压至本地目录（如 /usr/src/php-8.2.12）。
4、进入扩展源码目录（如 /path/to/extname），执行 /path/to/phpize 初始化构建系统。
二、使用phpize生成configure脚本
phpize会扫描PHP安装信息并生成适用于当前环境的configure脚本，这是后续
编译的前提条件，缺失将导致make失败。
1、切换至扩展源码根目录（如 cd /path/to/php-src/ext/redis）。
2、运行 /usr/bin/phpize（路径以实际为准），输出应包含 Configuring for... 提示。
3、检查当前目录是否生成 configure 文件及 autom4te.cache 目录。
4、若报错 Cannot find config.m4，说明扩展目录结构异常或缺少必要文件。
三、执行configure并指定PHP配置参数
configure脚本用于检测依赖库、头文件路径及编译选项，必须传入正确的PHP配置参数才能适配当前运行环境。
1、执行 ./configure --with-php-config=/usr/bin/php-config（路径需与实际php-config一致）。
2、若扩展依赖外部库（如cURL、OpenSSL），需追加对应参数，例如 --with-curl=/usr 或 --with-openssl=/usr。
3、观察输出末尾是否出现 checking if compiling with clang... no 及 creating libtool 等成功标识。
4、若提示 configure: error: xxx not found，需安装对应开发包（如 libcurl4-openssl-dev）。
四、编译并安装扩展模块
make命令依据Makefile调用gcc完成对象文件编译，make install则将生成的so文件复制到PHP扩展目录，供动态加载使用。
1、运行 make 开始编译，过程中不应出现 error: 字样。
2、运行 make install，成功后输出类似 Installing shared extensions: /usr/lib/php/20250829/ 的路径信息。
3、检查目标目录是否存在新生成的 extname.so 文件（如 redis.so、xdebug.so）。
4、若提示 cp: cannot create regular file ... Permission denied，需加 sudo 权限重试。
五、启用扩展并验证加载状态
扩展模块文件需通过php.ini显式声明才能被PHP识别，且必须确保配置生效范围覆盖当前SAPI（CLI/FPM/Apache）。
1、执行 php --ini 查看当前生效的php.ini路径。
2、编辑该php.ini，在末尾添加 extension=extname.so（不带路径，仅文件名）。
3、若扩展需额外配置，如opcache，还需添加类似 opcache.enable=1 的指令。
4、执行 php -m | grep extname，若返回扩展名即表示加载成功；执行 php -i | grep extname 可查看详细配置项。
