How do I use arrays in cURL POST requests

When working with arrays in a cURL POST request, the most common approach is to convert the array into a string formatted as an HTTP query string. Here is a step-by-step guide and example demonstrating how to include arrays in a cURL POST request.

Step 1: Define the Array Data

First, you need to define the array you want to send via a cURL POST request. For example, consider a shopping cart application where users select multiple products; you need to send the product IDs and quantities.

php
$products = [
    ['id' => 101, 'quantity' => 2],
    ['id' => 102, 'quantity' => 5],
    ['id' => 103, 'quantity' => 1]
];

Step 2: Convert the Array to a Query String

Next, convert the array into an HTTP query string format. In PHP, you can use the http_build_query() function to achieve this.

php
$post_fields = http_build_query([
    'products' => $products
]);

This will generate a string similar to:

shell
products[0][id]=101&products[0][quantity]=2&products[1][id]=102&products[1][quantity]=5&products[2][id]=103&products[2][quantity]=1

Step 3: Create the cURL Request

Now, use the generated query string as the POST fields to create and execute the cURL request.

php
$ch = curl_init('http://example.com/api/add_products');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_fields);
$response = curl_exec($ch);
curl_close($ch);

Example

Suppose you are sending a POST request to an e-commerce platform's API containing the user's shopping cart products. The server-side API expects to receive product IDs and quantities, which it then processes (e.g., updating inventory or calculating the cart total).

This is a basic method for including arrays in a cURL POST request. Using http_build_query() effectively handles the conversion of arrays to strings, ensuring data is sent to the server in the appropriate format.