当前位置:首页 > 文章列表 > 文章 > 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推荐
  • ChatExcel酷表:告别Excel难题,北大团队AI助手助您轻松处理数据
    ChatExcel酷表
    ChatExcel酷表是由北京大学团队打造的Excel聊天机器人,用自然语言操控表格,简化数据处理,告别繁琐操作,提升工作效率!适用于学生、上班族及政府人员。
    4015次使用
  • Any绘本:开源免费AI绘本创作工具深度解析
    Any绘本
    探索Any绘本(anypicturebook.com/zh),一款开源免费的AI绘本创作工具,基于Google Gemini与Flux AI模型,让您轻松创作个性化绘本。适用于家庭、教育、创作等多种场景,零门槛,高自由度,技术透明,本地可控。
    4352次使用
  • 可赞AI:AI驱动办公可视化智能工具,一键高效生成文档图表脑图
    可赞AI
    可赞AI,AI驱动的办公可视化智能工具,助您轻松实现文本与可视化元素高效转化。无论是智能文档生成、多格式文本解析,还是一键生成专业图表、脑图、知识卡片,可赞AI都能让信息处理更清晰高效。覆盖数据汇报、会议纪要、内容营销等全场景,大幅提升办公效率,降低专业门槛,是您提升工作效率的得力助手。
    4230次使用
  • 星月写作:AI网文创作神器,助力爆款小说速成
    星月写作
    星月写作是国内首款聚焦中文网络小说创作的AI辅助工具,解决网文作者从构思到变现的全流程痛点。AI扫榜、专属模板、全链路适配,助力新人快速上手,资深作者效率倍增。
    5525次使用
  • MagicLight.ai:叙事驱动AI动画视频创作平台 | 高效生成专业级故事动画
    MagicLight
    MagicLight.ai是全球首款叙事驱动型AI动画视频创作平台,专注于解决从故事想法到完整动画的全流程痛点。它通过自研AI模型,保障角色、风格、场景高度一致性,让零动画经验者也能高效产出专业级叙事内容。广泛适用于独立创作者、动画工作室、教育机构及企业营销,助您轻松实现创意落地与商业化。
    4598次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码