错误现象与根本原因
在源码编译PHP时，configure阶段可能会突然中断，抛出类似这样的错误：checking for libssl... configure: error: Cannot find libssl。很多人的第一反应是系统里没有安装OpenSSL，于是跑去用包管理器安装，结果发现OpenSSL明明已经存在，版本也符合要求，但编译依旧失败。这个现象在手动编译OpenSSL并安装到自定义路径时尤其常见，例如你把OpenSSL装到了/usr/local/openssl，而不是系统默认的/usr目录。
问题的核心在于PHP的openssl扩展从7.x版本开始，不再简单地通过--with-openssl-dir去猜测头文件和库文件的位置，而是优先使用pkg-config工具来获取OpenSSL的编译参数。pkg-config会读取.pc文件，这些文件通常存放在lib/pkgconfig目录下。默认情况下，pkg-config只搜索系统路径，比如/usr/lib/pkgconfig和/usr/share/pkgconfig。如果你的OpenSSL安装在自定义目录，它的openssl.pc文件就不会被找到，于是configure脚本误以为缺少libssl。
可以通过一条命令快速验证：pkg-config --modversion openssl。如果终端返回版本号，说明pkg-config能找到OpenSSL；如果提示未找到包，就需要手动指定搜索路径。这就是设置PKG_CONFIG_PATH的意义。
设置PKG_CONFIG_PATH的详细步骤
首先确认OpenSSL的实际安装位置以及openssl.pc文件是否存在。如果OpenSSL是通过源码编译安装的，默认前缀通常是/usr/local/ssl或你在configure时指定的--prefix路径。进入该目录，查找lib/pkgconfig子目录，里面应该有openssl.pc文件。例如：
ls /usr/local/openssl/lib/pkgconfig # 输出应包含 openssl.pc
确认文件存在后，将PKG_CONFIG_PATH指向这个目录。执行以下命令：
export PKG_CONFIG_PATH=/usr/local/openssl/lib/pkgconfig:$PKG_CONFIG_PATH pkg-config --modversion openssl
如果此时能正常输出版本号，比如1.1.1k，说明路径配置成功。这个环境变量只在当前终端会话中有效，重新打开终端后需要重新设置。如果希望永久生效，可以把export命令写入~/.bashrc或~/.profile文件。设置完成后，重新回到PHP源码目录，先清理之前的configure缓存，再重新执行configure：
make clean ./configure --with-openssl --with-openssl-dir=/usr/local/openssl
需要注意的是，--with-openssl-dir仍然建议与PKG_CONFIG_PATH保持一致。虽然新版PHP更依赖pkg-config，但部分旧版逻辑仍会使用该选项进行辅助定位。执行configure后，关注输出中的OpenSSL部分，如果显示checking for OpenSSL... yes而不是错误信息，就说明问题已经解决。
其他解决方案与常见坑
如果设置PKG_CONFIG_PATH后仍然报错，需要检查几个常见细节。第一，确认系统是否安装了pkg-config工具本身。在Debian或Ubuntu上可以运行apt install pkg-config，在CentOS或RHEL上运行yum install pkgconfig。没有这个工具，设置环境变量也无济于事。第二，检查openssl.pc文件中的prefix字段是否与OpenSSL实际安装路径一致。有时手动移动了目录，.pc文件里记录的路径还是旧的，这会导致pkg-config报头文件或库文件找不到。
另一种更直接的方案是使用系统包管理器安装OpenSSL开发包。对于Debian/Ubuntu：apt install libssl-dev；对于CentOS/RHEL：yum install openssl-devel。这种方式会把头文件和.pc文件安装到系统默认路径，无需手动设置PKG_CONFIG_PATH。缺点是版本可能不是最新，如果你需要特定版本的OpenSSL来编译PHP，还是得用源码编译并配合环境变量。
多版本OpenSSL共存时还要注意优先级。比如系统自带OpenSSL 1.0.2，你又手动编译了OpenSSL 1.1.1，那么pkg-config --modversion openssl返回的值取决于PKG_CONFIG_PATH的先后顺序。建议把需要的版本路径放在最前面。最后，编译完成后可以用php -m | grep openssl确认扩展已加载，或者运行一段简单的PHP代码测试openssl_encrypt函数是否可用。
