当前位置:首页 > 文章列表 > 文章 > 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_

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 0浏览 收藏
本文深入解析了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学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!

Python中文乱码解决方法大全Python中文乱码解决方法大全
上一篇
Python中文乱码解决方法大全
ITCSS分层管理,掌控大型项目样式权重
下一篇
ITCSS分层管理,掌控大型项目样式权重
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • ljg-skills -
    ljg-skills
    ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
    2823次使用
  • MELO音乐 - AI 音乐生成平台,支持多模态创作能力
    MELO音乐
    MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
    2618次使用
  • UniScribe - AI 免费在线音视频转文字平台
    UniScribe
    UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
    2557次使用
  • 剧云 - 免费 AI 智能中文剧本创作平台
    剧云
    剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
    2795次使用
  • 万象有声 - AI 一站式有声内容创作平台
    万象有声
    万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
    2739次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码