国产系统PHP常见问题有四类：一是扩展编译缺dlopen需加-ldl链接；二是/proc/cpuinfo适配需用uname -m和正则匹配；三是国密需PHP8.2+OpenSSL3.0+启用SM2或调用gmssl命令；四是Composer须切国内源、禁Git协议。
PHP扩展编译报undefined reference to `dlopen'链接错误
统信UOS和麒麟等国产系统默认使用musl libc或精简版glibc，且部分镜像禁用libdl动态加载支持。PHP扩展（尤其是pdo_mysql、redis、swoole）在./configure后make阶段常因找不到dlopen符号失败。
解决方法不是换系统，而是补全链接依赖：
- 确认已安装
libdl-dev（Debian系）或glibc-static（UOS 20+基于openEuler内核时需此包） - 编译扩展时显式加
-ldl：phpize && ./configure LDFLAGS="-ldl" && make
- 若用
pecl install失败，改用源码编译，并在configure后检查config.log里ac_cv_func_dlopen是否为yes
PHP读取/proc/cpuinfo返回空或格式异常
国产CPU平台（鲲鹏、飞腾、海光）的/proc/cpuinfo字段与x86不同，例如没有model name，而是CPU implementer、CPU part等。PHP用file_get_contents('/proc/cpuinfo')直接解析会丢关键信息，sys_getloadavg()也可能返回0（因内核补丁未合入）。
适配要点：
立即学习“PHP免费学习笔记（深入）”；
- 别硬匹配
model name，改用preg_grep('/^processor|^CPU.*/i', file('/proc/cpuinfo'))粗筛 - 查CPU型号优先走
uname -m：shell_exec('uname -m')→ 返回aarch64（鲲鹏/飞腾）或x86_64（海光） - 负载值不可靠时，用
sys_getloadavg()前先file_exists('/proc/loadavg')校验，否则fallback到ps aux --sort=-%cpu | head -n 2
openssl扩展调用国密SM2/SM4失败
UOS桌面版默认PHP不带国密支持，即使装了openssl命令行工具，PHP的openssl_encrypt()仍只认AES-128-CBC等国际算法，sm4-cbc会抛Unknown cipher错误。
真实可行路径只有两条：
- 升级到PHP 8.2+ + OpenSSL 3.0+，并确认编译时启用了
enable-sm2（需源码配置--with-openssl=/usr/local/openssl，且该OpenSSL已编译国密模块） - 绕过PHP原生扩展，用
shell_exec('gmssl enc -sm4 -cbc -in data.txt -out enc.bin')调用系统gmssl命令（UOS应用商店可装） - 注意：
openssl_pkey_new(['curve_name' => 'sm2p256v1'])在未启用国密的PHP里必然失败，不要尝试“打补丁”式修复
Composer install卡在git clone或提示failed to open stream: Connection refused
国产系统镜像常默认屏蔽GitHub、Packagist等境外源，且DNS解析走本地运营商缓存，导致Composer元数据拉取超时或失败，不是网络问题，是策略限制。
必须做三件事：
- 切国内镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com
（注意：该地址已停，实际应换为https://mirrors.aliyun.com/composer/） - 禁用Git协议（避免触发SSH握手）：
composer config -g gitlab-protocol https
- 若仍失败，临时设代理（仅限开发机）：
export HTTP_PROXY=http://127.0.0.1:7890; export HTTPS_PROXY=$HTTP_PROXY
，但生产环境禁止此操作
国产系统对TLS握手更敏感，PHP 7.4以下版本在UOS上可能因OpenSSL版本差异无法验证新CA证书，遇到SSL certificate problem错误时，优先升级PHP而非关校验。
