Mac M1环境下构建的Zephir PHP扩展无法在Ubuntu服务器运行的问题排查与解决咨询

这个问题本质是架构兼容性导致的，我之前在帮团队排查跨平台扩展编译问题时遇到过几乎一样的场景，给你拆解下原因和解决办法：

问题成因 #

Mac M1系列设备采用的是ARM64（aarch64）架构，而你的目标Ubuntu服务器是传统的x86_64架构。当你在M1上运行x86_64的Ubuntu Docker镜像时，Docker默认是通过Apple的Rosetta 2来模拟x86_64环境的——这种模拟环境下编译出的.so扩展文件，虽然表面标识是x86_64，但可能携带了依赖Rosetta模拟层的隐性指令，或者编译过程中某些工具链（比如GCC、Zephir）偷偷引入了ARM相关的优化/依赖，导致真正的x86_64服务器无法正常加载。

而Windows设备本身就是x86_64架构，Docker是原生运行x86_64的Ubuntu镜像，编译出的扩展是纯x86_64环境下的产物，和目标服务器完全匹配，所以能正常运行。

解决方法 #

1. 强制Docker以原生x86_64模式运行容器 #

这是最直接有效的方法，跳过Rosetta模拟，让容器真正跑在x86_64架构的模拟环境（QEMU）下。运行容器时加上--platform linux/amd64参数：

docker run --platform linux/amd64 -it ubuntu:21.10 bash

进入容器后，先执行uname -m确认输出是x86_64，再进行后续的Zephir/PHP扩展编译步骤。

2. 验证编译产物的架构 #

编译完成后，用file命令检查你的扩展文件，确保它是纯x86_64架构：

file your_extension.so

正常输出应该包含：ELF 64-bit LSB shared object, x86-64, version 1 (SYSV), dynamically linked，如果出现aarch64相关的描述，说明编译环境还是有问题。

3. 清理缓存后重新编译 #

之前在Rosetta环境下的编译缓存可能残留了ARM相关的文件，一定要先清理再重新构建：

# 清理Zephir缓存
zephir clean
# 清理PHP扩展编译目录
rm -rf ext/.libs/
# 重新编译
zephir build

如果是手动编译PHP扩展，就执行：

phpize && ./configure && make clean && make && make install

4. 备选：使用交叉编译（不推荐，仅当上述方法失效时） #

如果强制平台参数的方法不行，可以尝试在M1上安装x86_64的交叉编译工具链，指定目标架构编译。比如安装gcc-multilib：

apt-get update && apt-get install gcc-multilib

然后在编译时通过./configure的参数指定目标架构：

./configure --build=x86_64-linux-gnu

不过这种方法配置起来比较繁琐，优先推荐前面的平台指定方案。

内容的提问来源于stack exchange，提问作者Mark Smith