入门指南：curl_init POST 请求

cURL 是「Client for URLs」的缩写，为开发人员提供了一整套管理数据传输的功能，以两种不同的模式运行：

用于基本交互的用户友好的命令行界面
无缝集成到编程项目中的强大库

🦊

借助适用于整个 API 生命周期的完整工具 Apifox ，可以在单个应用程序中构建、测试、模拟和记录 API，为自己获取最好、最灵活的 API 开发工具！

Apifox - API 文档、调试、Mock、测试一体化协作平台。拥有接口文档管理、接口调试、Mock、自动化测试等功能，接口开发、测试、联调效率，提升 10 倍。最好用的接口文档管理工具，接口自动化测试工具。

Apifox = Postman + Swagger + Mock + JMeter。集接口文档工具、接口Mock工具、接口自动化测试工具、接口调试工具于一体，提升 10 倍研发效率。是最好用的API文档工具，API自动化测试工具，API Mock工具，接口文档管理工具，接口文档生成工具。

apifox

curl_init（）的定义

根据 PHP 官方网站，curl_init 函数初始化一个 cURL 会话，并返回一个 cURL 句柄，以便与 curl_setopt（）、curl_exec（）和 curl_close（）函数一起使用。

涉及参数

URL

如果提供 URL， CURLOPT_URL 选项将设置为其值，还可以使用 curl_setopt（）函数手动设置此选项。

但如果设置了 open_basedir ，则 cURL 本身会禁用 file 协议。

返回值

如果成功，curl_init() 函数会返回一个 cURL 句柄，如果出现错误，则返回 false 。

什么是 POST 请求？

在 Web 通信环境中，HTTP 充当数据交换的基础，使用的一种重要方法是 POST 请求，专门用于将数据传输到 Web 服务器。本文档深入研究了 POST 请求的复杂性，阐明了其功能并将其与对应的 GET 请求进行了对比。

POST 请求的主要特点

数据传输

POST 请求专门用于将数据发送到 Web 服务器，可用于创建新资源、更新现有信息或删除数据。

数据放置

POST 请求在请求 body 中发送数据，而不是将其包含在 URL 本身中，增强了安全性，特别是对于密码或信用卡详细信息等敏感信息，这些信息不会在 URL 中公开。

改变状态

POST 请求通常会导致服务器端发生修改，可能涉及创建新用户帐户、上传文件、将新产品添加到购物车或删除评论。

不可缓存

由于 POST 请求会修改数据，因此 Web 浏览器通常不会缓存它们。这可确保始终将最新信息发送到服务器，从而防止使用过时的数据。

curl_init() POST 请求的代码示例

如果要使用 curl_init() 函数发出 POST 请求，可以参考以下一些 PHP 编码示例：

示例 1：发送简单文本数据

将基本用户名和密码发送到登录脚本：

<?php

$url = "https://www.example.com/login.php";
$username = "your_username";
$password = "your_password";

$data = array(
  "username" => $username,
  "password" => $password
);

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POST, 1);  // Set request method to POST
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));  // Set POST data
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  // Return the response

$response = curl_exec($ch);

curl_close($ch);

if($response) {
  echo "Login successful!";
} else {
  echo "Error: " . curl_error($ch);
}

?>

代码解读：

定义目标 URL、用户名和密码。
创建一个包含用户名和密码的数组 $data 。
用 curl_init($url) 初始化句柄。
使用 curl_setopt($ch, CURLOPT_POST, 1) 将请求方法设置为 POST。
使用 curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data)) 设置 POST 数据。 http_build_query 将数据数组转换为 URL 编码的字符串。
将 CURLOPT_RETURNTRANSFER 设置为 1 以捕获响应。
使用 curl_exec($ch) 执行请求并将响应存储在 $response 中。
用 curl_close($ch) 关闭 curl 句柄。
检查响应是否存在并显示成功消息或错误。

示例2：发送 JSON 数据

将包含用户信息的 JSON 对象发送到注册脚本：

<?php

$url = "https://www.example.com/register.php";

$user_data = array(
  "name" => "John Doe",
  "email" => "john.doe@example.com",
  "password" => "your_password"
);

$data_json = json_encode($user_data);

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POST, 1);  // Set request method to POST
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_json);  // Set POST data as JSON
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  // Return the response

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'Content-Type: application/json',   // Set content type to JSON
));

$response = curl_exec($ch);

curl_close($ch);

if($response) {
  echo "Registration successful!";
} else {
  echo "Error: " . curl_error($ch);
}

?>

代码解读：

定义目标 URL 和用户数据数组。
使用 json_encode 将用户数据转换为 JSON 字符串。
初始化curl句柄并将请求方法设置为POST。
使用 curl_setopt($ch, CURLOPT_POSTFIELDS, $data_json) 设置 POST 数据。
将 CURLOPT_RETURNTRANSFER 设置为 1 以捕获响应。
设置一个自定义 header Content-Type: application/json 来通知服务器数据是 JSON 格式。
执行请求并关闭 curl 句柄，如前面的示例所示。
检查响应并显示成功消息或错误。

示例3：设置自定义标头并遵循重定向

发送带有自定义标头的 POST 请求并遵循重定向：

<?php

$url = "https://www.example.com/login.php";

$data = array(
  "username" => "your_username",
  "password" => "your_password"
);

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POST, 1);  // Set request method to POST
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);  // Return the response

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'Authorization: Bearer YOUR_API_KEY',  // Set custom header
));

// Follow redirects up to 3 times
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt($ch, CURLOPT_MAXREDIRS, 3);

$response = curl_exec($ch);

curl_close($ch);

if($response) {
  echo "Login successful!";
} else {
  echo "Error: " . curl_error($ch);
}

?>

代码解读：