Windows搭建PHP8.4.1开发环境开启curl扩展教程-php教程-PHP中文网

windows下安装php 8.4.1并启用curl扩展，核心是确保php_curl.dll正确加载，需匹配x64架构与vs17运行库，启用extension=curl和extension=openssl，并验证php -m | findstr curl输出成功。

windows搭建php8.4.1开发环境开启curl扩展教程

Windows 下安装 PHP 8.4.1 并启用 cURL 扩展，核心是确保 PHP 二进制包自带的 php_curl.dll 能被正确加载，且依赖的 OpenSSL 和 Visual C++ 运行库已就位。PHP 8.4.1 尚未正式发布（截至 2024 年 7 月，最新稳定版为 PHP 8.3.x），若你实际使用的是预发布版或构建版，请务必确认其与 Windows 版本、架构（x64/x86）及 VC 运行时兼容。

确认 PHP 安装包来源与基础环境

官方推荐使用 windows.php.net 提供的线程安全（TS）ZIP 包（如 php-8.4.1-Win32-vs17-x64.zip）。注意：

必须匹配你的系统：64 位 Windows 请选 x64，32 位系统选 x86（极少见）
VS 版本需对应：vs17 = Visual Studio 2022 → 需提前安装 Microsoft Visual C++ 2022 Redistributable (x64)
解压后不要直接运行 php.exe，先检查 ext\php_curl.dll 是否存在，以及 libssh2.dll、ssleay32.dll、libeay32.dll（旧版）或 libcrypto-3-x64.dll、libssl-3-x64.dll（PHP 8.3+ 常用）是否在根目录或 ext 目录中

配置 php.ini 启用 cURL 扩展

复制 php.ini-development 或 php.ini-production 为 php.ini，用记事本或 VS Code 编辑：

windows-git-ops

在 Windows PowerShell 工作区执行 Git 操作时使用此技能，特别适用于创建分支、暂存、提交、合并、状态检查等。

下载

取消注释（删除分号）：extension_dir = "ext"（确保路径指向你的 ext 文件夹）
取消注释：extension=curl（PHP 7.4+ 支持无 .dll 后缀写法；若报错可试 extension=php_curl.dll）
确认 openssl 扩展也已启用（cURL 依赖 OpenSSL）：extension=openssl
保存后，在命令行执行 php -m | findstr curl，看到 curl 即表示加载成功

验证 cURL 功能与常见错误处理

新建 test_curl.php 内容如下：

<?php if (function_exists('curl_init')) {
    echo "cURL 已启用\n";
    $ch = curl_init('https://httpbin.org/get');
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $res = curl_exec($ch);
    if ($res === false) {
        echo "cURL 错误: " . curl_error($ch) . "\n";
    } else {
        echo "请求成功，响应长度：" . strlen($res) . " 字节\n";
    }
    curl_close($ch);
} else {
    echo "cURL 扩展未启用\n";
}
?>

若提示 Unable to load dynamic library 'php_curl.dll'：

检查 php.ini 中 extension_dir 路径是否拼写正确（反斜杠需双写或用正斜杠，如 ext/）
运行 php --ri curl 查看扩展详细信息，若显示 “not present”，说明 DLL 未加载；若显示 “enabled” 但 curl_init 不存在，可能是 PHP 架构与系统不匹配
缺少 DLL 依赖：用 Dependencies GUI 打开 php_curl.dll，查看红色标记的缺失模块（通常是 libssl-3-x64.dll），将其从 PHP 根目录复制到 Windows\System32（x64 系统）或 Windows\SysWOW64（仅 x86 PHP）

集成到 Web 服务器（如 Apache 或 Nginx）

若通过 Web 访问 PHP 页面仍提示 cURL 不可用，需单独检查 Web 服务器使用的 php.ini：

Apache：在 httpd.conf 中确认 PHPIniDir 指向你编辑的 php.ini 所在目录
Nginx + PHP-FPM：检查 php-fpm.conf 或 www.conf 中的 php_admin_value[php_ini] 设置
最稳妥方式：在 PHP 页面中加入 <?php phpinfo(); ?>，搜索 “Loaded Configuration File”，确认实际生效的 php.ini 路径，然后在此文件中启用 cURL

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！