PHP cURL HTTP POST Example: Sending Form Data and Reading the Response

By the end of this page, you will understand how to use PHP cURL to send an HTTP POST request, attach form data, receive the response, and handle common mistakes such as forgetting CURLOPT_RETURNTRANSFER or posting data in the wrong format.

In PHP, cURL is a library used to make HTTP requests from your code. It is commonly used to talk to APIs, submit forms programmatically, send login data, upload files, or communicate with other web services.

An HTTP POST request sends data to a server in the request body. This is different from a GET request, which usually sends data in the URL.

When you use cURL in PHP for a POST request, you usually do these things:

1. Initialize a cURL session.
2. Set the target URL.
3. Tell cURL to use the POST method.
4. Attach the data you want to send.
5. Ask cURL to return the response as a string.
6. Execute the request.
7. Close the cURL session.

This matters in real programming because many systems require server-to-server communication. For example:

• submitting payment details to a gateway
• logging in to an external service
• sending form data to an API
• posting JSON or form fields to another application

For your example, the data looks like standard form fields, so the most common format is application/x-www-form-urlencoded, which is what regular HTML forms use by default.

Think of a cURL POST request like mailing a form to an office.

• The URL is the office address.
• The POST method means you are sending information inside the envelope.
• The POST fields are the form values you put in the envelope.
• The response is the letter the office sends back.

In PHP, cURL is the mail carrier. You tell it where to go, what method to use, what data to carry, and whether you want the reply handed back to your code.

The basic PHP cURL POST pattern looks like this:

<?php
$url = 'https://www.example.com';

$data = [
    'username' => 'user1',
    'password' => 'passuser1',
    'gender' => '1'
];

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);

What this code does

Consider this example:

<?php
$data = [
    'username' => 'user1',
    'password' => 'passuser1',
    'gender' => '1'
];

$ch = curl_init('https://www.example.com');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Step by step

1. PHP creates an array named $data.

   • It contains three fields: username, password, and gender.

PHP cURL POST requests are used in many practical situations:

• Submitting login credentials

  • Send a username and password to an authentication endpoint.

• Calling third-party APIs

  • Send search parameters, order details, or customer data to another service.

• Webhook delivery

  • Post event data from your application to another system.

• Payment and billing integrations

  • Send checkout or transaction data securely to a payment provider.

• Internal microservice communication

  • One backend service sends data to another backend service.

• Form automation

  • Simulate a form submission without a browser.

Example scenario:

<?php
$data = [
    'email' => 'customer@example.com',
    'plan' => 'pro'
];

This kind of data might be posted to a subscription API when a user upgrades their account.

In real projects, developers usually wrap cURL logic in reusable functions or service classes instead of writing raw cURL code everywhere.

Common patterns

• Validation before sending

  • Check required fields before making the request.

• Guard clauses

  • Return early if important data is missing.

• Error handling

  • Handle cURL errors and bad HTTP status codes separately.

• Configuration-driven URLs

  • Store API base URLs in config files or environment variables.

• Response parsing

  • Convert JSON responses into arrays with json_decode().

• Timeouts

  • Prevent requests from hanging too long.

Example helper function

<?php
function postForm(string $url, array $data): array
{
    if (empty($url)) {
         [ => ,  => ];
    }

     = ();

    (, CURLOPT_POST, );
    (, CURLOPT_POSTFIELDS, ());
    (, CURLOPT_RETURNTRANSFER, );
    (, CURLOPT_TIMEOUT, );

     = ();
     = ();
     = (, CURLINFO_HTTP_CODE);

    ();

     ( === ) {
         [ => ,  => ];
    }

     ( >= ) {
         [ => ,  =>  . ,  => ];
    }

     [ => ,  => ];
}

Here are some common beginner mistakes when using PHP cURL for POST requests.

1. Forgetting CURLOPT_RETURNTRANSFER

Broken code:

<?php
$ch = curl_init('https://www.example.com');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, 'username=user1');
$response = curl_exec($ch);

Problem:

• The response may be printed directly instead of stored properly.
• $response may be true instead of the actual response body.

Fix:

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

2. Sending an array when the server expects URL-encoded form data

Sometimes this works, but not always in the format you expect.

Safer approach:

(, CURLOPT_POSTFIELDS, ());

Here is a quick comparison of related request formats and options.

<?php
$data = [
    'username' => 'user1',
    'password' => 'passuser1',
    'gender' => '1'
];

$ch = curl_init('https://www.example.com');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {
    echo curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);

Quick rules

• Use curl_init() to start.
• Use CURLOPT_POST for POST requests.

How do I send POST data with PHP cURL?

Use CURLOPT_POST to enable POST and CURLOPT_POSTFIELDS to send the data.

How do I get the response body instead of printing it directly?

Set CURLOPT_RETURNTRANSFER to true. Then curl_exec() returns the response as a string.

Should I pass an array or use http_build_query()?

For simple form fields, http_build_query() is usually the safest and clearest choice.

How do I know whether the request failed?

Check whether curl_exec() returns false, then read the error with curl_error($ch).

Can I send JSON instead of form data?

Yes. Use json_encode() and set the Content-Type: application/json header.

Why is my server not receiving the posted values?

Common causes include using the wrong content type, forgetting http_build_query(), using the wrong URL, or sending to an endpoint that expects a different format.

• HTTP methods — Helps you understand the difference between GET, POST, PUT, and DELETE.
• HTML forms — Useful because form submissions often use the same URL-encoded format.
• Query strings — Related to how GET requests send data in the URL.
• PHP arrays — Important because POST data is often built from arrays before sending.
• http_build_query() — Directly related to converting arrays into form-encoded strings.
• JSON in PHP — Useful when an API expects JSON instead of form fields.
• API requests — cURL is commonly used to communicate with external APIs.
• Error handling in PHP — Important for safely dealing with request failures and debugging.