必须分平台处理PHP 8.4扩展开发：Windows用VS2022补全phpize.bat和.def文件，Linux/macOS用对应phpize路径且注意so/dylib后缀不兼容；需先验证php -v为8.4.x且php-config --includes返回有效路径，否则编译必败。
要在 Windows、Linux 和 macOS 上为 PHP 8.4 开发并编译扩展，必须针对各平台特性分别处理依赖、工具链和加载机制——Windows 用 VS2022 编译需手动补全 phpize.bat 和 .def 文件，Linux/macOS 必须用对应系统的 phpize 和 configure 路径，且 macOS 的 dylib 后缀与 Linux 的 so 不兼容，混用会导致 extension= 加载失败。
确认 PHP 8.4 开发环境就绪
先验证当前系统中 PHP 8.4 是否已安装且含开发头文件：【php -v 输出必须含 8.4.x，且 php-config --includes 返回非空路径】。若返回 No such file 或路径指向 8.3，则后续所有编译必失败。
Linux/macOS 执行：php-config --includes；Windows 执行：php-config.bat --includes。输出应类似 -I/usr/include/php/20240801（Linux）或 -I"C:\php-sdk\phpdev\vc17\x64\php-8.4.16\include"（Windows），否则需重装 php-dev 或 php-devel 包。
Ubuntu/Debian 用户注意：apt install php8.4-dev 是必须步骤，仅装 php8.4-cli 不含 ext_skel 和头文件。
立即学习“PHP免费学习笔记（深入）”；
生成扩展骨架（三平台统一操作）
进入 PHP 源码的 ext 目录后，运行 ext_skel 脚本创建基础结构：
Linux/macOS：./ext_skel --extname=myext
Windows（需在 PHP SDK 环境下）：ext_skel.bat --extname=myext
这一步会生成 config.m4（Linux/macOS）、config.w32（Windows）、php_myext.h 和 myext.c 四个核心文件。其中 config.w32 是 Windows 专属配置，【Linux/macOS 下不可删 config.w32，否则 phpize 会报错 missing config.w32】，但 Windows 下可删 config.m4。
平台差异化编译流程
方法一：Linux（Debian/Ubuntu/Rocky）
① 进入扩展目录：cd myext
② 执行 phpize：/usr/bin/phpize（必须用绝对路径，避免调到旧版 phpize）
③ 配置：./configure --with-php-config=/usr/bin/php-config
④ 编译安装：make && sudo make install
生成的 myext.so 会被复制到 /usr/lib/php/20240801/，此时 extension=myext 写入 php.ini 即可生效。
方法二：macOS（Apple Silicon 或 Intel）
第一步：用 Homebrew 安装匹配的 php@8.4：brew install php@8.4
第二步：确保 phpize 来自该版本：$(brew --prefix php@8.4)/bin/phpize
第三步：configure 时必须加 【--enable-shared】，否则生成 .dylib 但无法被 PHP 动态加载；不加此参数默认静态链接，extension=myext 会静默失效。
第四步：make && make install 后，扩展路径通常是 $(brew --prefix php@8.4)/lib/php/20240801/，注意 .dylib 后缀不可改为 .so。
方法三：Windows（VS2022 + PHP SDK）
这一步不能跳过：下载并解压与 PHP 8.4 版本完全一致的 【PHP SDK Binary Tools（如 php-sdk-binary-tools-2.4.15）】，否则 phpize.bat 会缺失或报错 unknown option --with-php-config。
打开“x64 Native Tools Command Prompt for VS 2022”，cd 到扩展目录，执行：
phpize.bat
configure.bat --disable-all --enable-myext=shared --with-php-build=C:\php-sdk\phpdev\vc17\x64
运行 nmake，成功后得到 myext.dll。把它放进 C:\php\ext\，并在 php.ini 中写 extension=myext（不带 .dll 后缀）。
