登录
首页 >  文章 >  php教程

PHP发送POST请求的简单示例代码如下:<?php$url='https://example.com/api/endpoint';//目标URL$data=array('username'=>'testuser','password'=>'testpass');//初始化curl$ch=curl_init($url);//设置选项curl_setopt($ch,CURLOPT_

时间:2026-02-14 10:14:41 440浏览 收藏

本文深入解析了PHP中发送POST请求的最佳实践,重点推荐使用curl_init()作为最稳妥、兼容性最强且可控性最高的原生方案,详细对比了其与file_get_contents()等替代方式的优劣;文章不仅提供了标准表单提交和JSON数据发送的完整代码示例,还系统梳理了常见陷阱——如遗漏CURLOPT_RETURNTRANSFER导致返回true而非响应体、未正确设置Content-Type致使JSON被后端忽略、禁用SSL验证带来的上线风险,以及忽略错误检查引发的静默失败,并强调必须始终校验curl_exec返回值、调用curl_error获取底层错误信息,为开发者提供了一套兼顾安全性、健壮性与可维护性的生产级HTTP客户端实践指南。

php代码示例如何发送post请求_php发送post请求代码示例【示例】

curl_init() 发送 POST 请求最稳妥

PHP 原生发 POST,curl_init() 是目前兼容性最好、控制力最强的方式,比 file_get_contents()stream_context_create() 更直观,也比废弃的 http_post_data() 可靠得多。

常见错误是没设 CURLOPT_RETURNTRANSFER,导致返回 bool(true) 而不是响应体;或者漏掉 CURLOPT_POSTCURLOPT_POSTFIELDS,请求变成 GET 或直接空发。

  • 必须显式设置 CURLOPT_POST => true
  • CURLOPT_POSTFIELDS 接收数组(自动编码为 application/x-www-form-urlencoded)或字符串(需手动设 Content-Type
  • 建议始终开启 CURLOPT_RETURNTRANSFERCURLOPT_HEADER(调试时设为 true,上线前关掉)
  • 超时务必设,比如 CURLOPT_TIMEOUT => 10,避免阻塞
$ch = curl_init('https://api.example.com/login');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['username' => 'admin', 'password' => '123']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

发送 JSON 数据要手动处理 Content-Type

如果目标接口要求 Content-Type: application/json(比如多数 REST API),不能直接传数组给 CURLOPT_POSTFIELDS,否则会发成表单格式,后端收不到 json_decode(file_get_contents('php://input')) 的数据。

必须把数组 json_encode() 成字符串,并显式设置请求头。

  • json_encode(['key' => 'val']) 构造请求体
  • 通过 CURLOPT_HTTPHEADER 加入 Content-Type: application/json
  • 注意检查 json_last_error(),避免空数组或非法字符导致编码失败
$data = json_encode(['email' => 'user@example.com', 'token' => 'abc123']);
$ch = curl_init('https://api.example.com/webhook');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

file_get_contents() 发 POST 很容易出错

虽然语法更短,但 stream_context_create() 对参数名和嵌套层级敏感,稍不注意就发不出数据,而且错误提示极不友好(常返回 false 且无日志)。

典型问题包括:http 数组写成顶层键而非子数组、content 没做 http_build_query()json_encode()、漏掉 method 设置。

  • method 必须大写,如 'POST'
  • content 必须是字符串,不能是数组
  • 若发 JSON,记得加 header 项并包含 Content-Type
  • 不推荐在生产环境用这种方式,调试困难,异常难捕获
$opts = [
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/json\r\n",
        'content' => json_encode(['id' => 123])
    ]
];
$result = file_get_contents('https://api.example.com/item', false, stream_context_create($opts));

别忽略 HTTPS 证书验证和重定向

本地开发时用 CURLOPT_SSL_VERIFYPEER => false 看似省事,但上线后会因证书校验失败而静默失败;同样,不处理重定向(CURLOPT_FOLLOWLOCATION)可能导致 302 后拿不到真实响应。

  • 线上环境必须保留 CURLOPT_SSL_VERIFYPEER => true(PHP 5.6+ 默认开启)
  • 如需跟随跳转,加上 CURLOPT_FOLLOWLOCATION => true,但注意某些 API 明确禁止重定向
  • curl_error($ch)curl_errno($ch) 检查底层错误,比如 CURLE_SSL_CACERT 表示证书路径不对
  • 自建 CA 或内网环境,可通过 CURLOPT_CAINFO 指定证书路径
实际项目里,curl_init() 的容错和可观测性远高于其他方式。最容易被忽略的是:没检查 curl_exec() 返回值是否为 false,以及没用 curl_error() 捕获连接层失败——这些不会抛异常,但会导致逻辑误判。

今天关于《PHP发送POST请求的简单示例代码如下:'testuser','password'=>'testpass');//初始化curl$ch=curl_init($url);//设置选项curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);curl_setopt($ch,CURLOPT_POST,true);curl_setopt($ch,CURLOPT_POSTFIELDS,http_build_query($data));//执行请求$response=curl_exec($ch);//关闭curlcurl_close($ch);//输出响应结果echo$response;?>说明:curl_init():初始化一个curl会话。curl_setopt():设置curl的选项,如POST方法、数据等。http_build_query():将数组转换为URL编码的字符串,适用于application/x-www-form-urlencoded格式的数据。curl_exec():执行curl会话并获取响应。curl_close():关闭curl会话。注意事项:确保服务器支持cURL扩展(通常默认开启)。如果需要发送JSON数据,可以使用json_encode()代替http_build_query(),并设置Content-Type头:curl_setopt($ch,CURLOPT_HTTPHEADER,array('Content-Type:application/json'));curl_setopt($》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>