Current Location: Home> Latest Articles> Complete Method for Downloading Files with curl_init and Saving Locally, Super Practical Example

Complete Method for Downloading Files with curl_init and Saving Locally, Super Practical Example

gitbox 2025-06-15

In PHP, curl is a very powerful and commonly used tool that handles various HTTP requests. By using the curl_init() function, we can easily download files and save them locally. In this article, we will provide a detailed guide on how to use curl_init to download files, along with a practical example to help you better understand the process.

Step 1: Initialize the cURL Session

First, we need to initialize a cURL session using curl_init(), which returns a cURL handle. This handle will be used for subsequent cURL operations.

$ch = curl_init();

Step 2: Set cURL Options

Once the session is initialized, we need to use curl_setopt() to set various options. Some key options include:

  • CURLOPT_URL: Set the URL of the file to be downloaded.

  • CURLOPT_RETURNTRANSFER: Set the return value method. Since we want to save the file content locally, we need to set it to true.

  • CURLOPT_FOLLOWLOCATION: Allow cURL to automatically follow redirects.

  • CURLOPT_TIMEOUT: Set the maximum execution time to avoid request hangups.

Assuming the URL of the file we want to download is https://gitbox.net/somefile.zip, here is an example of setting these options:

$url = "https://gitbox.net/somefile.zip";
$destination = "somefile.zip";  // Local save path
<p>curl_setopt($ch, CURLOPT_URL, $url);<br>
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);<br>
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);<br>
curl_setopt($ch, CURLOPT_TIMEOUT, 30);  // Set the timeout to 30 seconds<br>

Step 3: Execute the cURL Request and Retrieve File Content

After setting the cURL options, we can use curl_exec() to execute the request. This function will return the server's response, which is the file content. We will save this content to a local file.

$file_content = curl_exec($ch);
<p>if(curl_errno($ch)) {<br>
echo 'Curl error: ' . curl_error($ch);<br>
} else {<br>
// Save the downloaded file content locally<br>
file_put_contents($destination, $file_content);<br>
}<br>

Step 4: Close the cURL Session

Once the operation is complete, we should use curl_close() to close the current cURL session and release resources.

curl_close($ch);

Complete Code Example

By combining all the above steps, we get the following complete PHP script for downloading a file via cURL and saving it locally.

<?php
// Initialize the cURL session
$ch = curl_init();
<p>// Set the file download URL and local save path<br>
$url = "<a rel="noopener" target="_new" class="" href="https://gitbox.net/somefile.zip">https://gitbox.net/somefile.zip</a>";<br>
$destination = "somefile.zip";</p>
<p>// Configure cURL options<br>
curl_setopt($ch, CURLOPT_URL, $url);<br>
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);<br>
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);<br>
curl_setopt($ch, CURLOPT_TIMEOUT, 30);  // Set timeout to 30 seconds</p>
<p>// Execute the cURL request and retrieve the file content<br>
$file_content = curl_exec($ch);</p>
<p>// Error handling<br>
if(curl_errno($ch)) {<br>
echo 'Curl error: ' . curl_error($ch);<br>
} else {<br>
// Save the file locally<br>
file_put_contents($destination, $file_content);<br>
}</p>
<p>// Close the cURL session<br>
curl_close($ch);</p>
<p>echo "File downloaded successfully and saved to " . $destination;<br>
?><br>

Code Explanation

  1. Initialization and Configuration: We first initialize a cURL session with curl_init() and set the download URL and save path. curl_setopt() sets several important options, including the file URL, return content handling, and whether to allow redirects.

  2. Execute the Request: Using curl_exec(), we execute the request and retrieve the file content. If the download is successful, the file content is stored in the $file_content variable.

  3. Error Handling: If a cURL error occurs, we can retrieve the error information using curl_errno() and output the error details with curl_error().

  4. Save the File: We save the downloaded file content locally using file_put_contents().

  5. Close the Session: Finally, we close the cURL session with curl_close().

Conclusion

That’s the complete method for downloading files and saving them locally using curl_init(). Whether for simple file downloads or handling more complex HTTP requests, curl is an extremely useful tool. By adjusting cURL options, you can fulfill more complex requirements, such as simulating logins, sending POST requests, handling cookies, and more.

I hope this example helps you, and wish you continued success in PHP programming!

Related