PHP嵌入链接失败通常因cURL、openssl等扩展未启用，需通过phpinfo()定位缺失模块，再依Linux、Windows、Docker或宝塔面板对应方法开启并重启服务。
如果您在网页中嵌入 PHP 链接时出现失败现象，例如页面直接显示 PHP 代码、提示“500 内部服务器错误”或“Call to undefined function”，则很可能是服务器未启用必需的 PHP 扩展模块。以下是开启相关模块的具体方法：
一、确认缺失的扩展模块
PHP 嵌入链接失败常与 cURL、file_get_contents、openssl、mbstring 或 json 等基础扩展未启用有关。需先定位实际缺失模块，再针对性开启。
1、创建一个名为 info.php 的文件，内容为 <?php phpinfo(); ?>，上传至网站根目录。
2、通过浏览器访问该文件（如 http://yourdomain.com/info.php），查找“Loaded Configuration File”路径及各扩展模块状态。
立即学习“PHP免费学习笔记（深入）”；
3、在页面中搜索关键词如 curl、openssl、mbstring，确认其右侧是否显示 enabled。
二、Linux 系统下通过 php.ini 启用模块
适用于 Apache 或 Nginx + PHP-FPM 环境，通过编辑主配置文件激活扩展。
1、使用命令 php --ini 查看当前生效的 php.ini 路径。
2、用文本编辑器打开该文件，如 sudo nano /etc/php/8.1/apache2/php.ini（路径依 PHP 版本和 Web 服务而异）。
3、查找形如 ;extension=curl 的行，删除开头的分号 ;，确保变为 extension=curl。
4、对 openssl、mbstring、json 等必要模块执行相同操作。
5、保存文件后，重启 Web 服务：sudo systemctl restart apache2 或 sudo systemctl restart php8.1-fpm nginx。
三、Windows 系统下启用 PHP 扩展
适用于本地开发环境（如 XAMPP、WAMP、PHPStudy），通过图形界面或配置文件修改扩展状态。
1、打开 PHP 安装目录下的 php.ini 文件（通常位于 C:\xampp\php\php.ini 或类似路径）。
2、搜索 extension_dir，确认其值指向正确的扩展目录（如 "ext"），且路径无误。
3、取消注释以下行：extension=php_curl.dll、extension=php_openssl.dll、extension=php_mbstring.dll。
4、检查 Windows 系统变量 PATH 是否包含 PHP 目录，避免 DLL 加载失败。
5、重启 Apache 或 Nginx 服务，刷新 info.php 页面验证模块状态。
四、Docker 环境中启用 PHP 扩展
适用于基于官方 php 镜像构建的容器，需在 Dockerfile 或 docker-compose.yml 中声明扩展安装指令。
1、若使用自定义 Dockerfile，在 FROM php:8.1-apache 后添加：RUN docker-php-ext-install curl mbstring openssl。
2、对于需编译的扩展（如 redis、pdo_mysql），追加对应命令：RUN pecl install redis && docker-php-ext-enable redis。
3、若使用 docker-compose.yml，通过 build 指令引用含上述命令的 Dockerfile。
4、重建并启动容器：docker-compose down && docker-compose up -d --build。
五、宝塔面板用户快速开启扩展
适用于使用宝塔 Linux 面板管理 PHP 环境的用户，提供可视化操作路径，避免手动编辑配置文件出错。
1、登录宝塔面板，进入 软件商店 → 已安装 → PHP → 设置（选择对应版本）。
2、切换至 配置修改 标签页，点击右上角 安装扩展 按钮。
3、在弹出窗口中勾选 cURL、OpenSSL、Mbstring、JSON 等选项，点击提交。
4、安装完成后，返回 服务 标签页，点击 重载配置 按钮。
5、刷新 info.php 页面，确认各模块状态栏显示绿色“已启用”。
