[DOC-CVS] [doc-en] master: curl: Remove `curl_close()` from all examples (#4941)

[email protected] (Tim Düsterhus via GitHub)
Newsgroups php.doc.cvs
Message-ID <[email protected]> 
Author: Tim Düsterhus (TimWolla)
Committer: GitHub (web-flow)
Pusher: Crell
Date: 2025-10-20T09:44:36-05:00

Commit: https://github.com/php/doc-en/commit/fc9a0a8b29a7a099998bdd71fe5350a10b18fe62
Raw diff: https://github.com/php/doc-en/commit/fc9a0a8b29a7a099998bdd71fe5350a10b18fe62.diff

curl: Remove `curl_close()` from all examples (#4941)

* curl: Remove `curl_close()` from all examples

* curl: Remove `curl_share_close()` from all examples

Changed paths:
  M  reference/curl/curlfile/construct.xml
  M  reference/curl/examples.xml
  M  reference/curl/functions/curl-copy-handle.xml
  M  reference/curl/functions/curl-errno.xml
  M  reference/curl/functions/curl-error.xml
  M  reference/curl/functions/curl-escape.xml
  M  reference/curl/functions/curl-exec.xml
  M  reference/curl/functions/curl-getinfo.xml
  M  reference/curl/functions/curl-multi-close.xml
  M  reference/curl/functions/curl-reset.xml
  M  reference/curl/functions/curl-setopt-array.xml
  M  reference/curl/functions/curl-setopt.xml
  M  reference/curl/functions/curl-share-close.xml
  M  reference/curl/functions/curl-share-init.xml
  M  reference/curl/functions/curl-share-setopt.xml
  M  reference/curl/functions/curl-strerror.xml
  M  reference/curl/functions/curl-unescape.xml
  M  reference/curl/functions/curl-upkeep.xml


Diff:

diff --git a/reference/curl/curlfile/construct.xml b/reference/curl/curlfile/construct.xml
index d2b0eac8789f..89e80a2cf159 100644
--- a/reference/curl/curlfile/construct.xml
+++ b/reference/curl/curlfile/construct.xml
@@ -180,8 +180,6 @@ curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
 echo curl_exec($request);
 
 var_dump(curl_getinfo($request));
-
-curl_close($request);
 ]]>
    </programlisting>
    <para>&style.procedural;</para>
@@ -202,8 +200,6 @@ curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
 echo curl_exec($request);
 
 var_dump(curl_getinfo($request));
-
-curl_close($request);
 ]]>
    </programlisting>
    &example.outputs;
diff --git a/reference/curl/examples.xml b/reference/curl/examples.xml
index 71d6f7847110..e657ee9eb71d 100644
--- a/reference/curl/examples.xml
+++ b/reference/curl/examples.xml
@@ -12,8 +12,7 @@
    <function>curl_init</function>, then you can set all your
    options for the transfer via the <function>curl_setopt</function>,
    then you can execute the session with the 
-   <function>curl_exec</function> and then you finish off 
-   your session using the <function>curl_close</function>. 
+   <function>curl_exec</function>.
    Here is an example that uses the cURL functions to fetch the 
    example.com homepage into a file:
    <example>
@@ -32,7 +31,6 @@ curl_exec($ch);
 if(curl_error($ch)) {
     fwrite($fp, curl_error($ch));
 }
-curl_close($ch);
 fclose($fp);
 ?>
 ]]>
@@ -63,4 +61,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/reference/curl/functions/curl-copy-handle.xml b/reference/curl/functions/curl-copy-handle.xml
index b16ebdd793eb..9d479e11627c 100644
--- a/reference/curl/functions/curl-copy-handle.xml
+++ b/reference/curl/functions/curl-copy-handle.xml
@@ -77,10 +77,6 @@ $ch2 = curl_copy_handle($ch);
 
 // grab URL (http://www.example.com/) and pass it to the browser
 curl_exec($ch2);
-
-// close cURL resources, and free up system resources
-curl_close($ch2);
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-errno.xml b/reference/curl/functions/curl-errno.xml
index 7e2608dd39bc..b34a1881752d 100644
--- a/reference/curl/functions/curl-errno.xml
+++ b/reference/curl/functions/curl-errno.xml
@@ -71,9 +71,6 @@ if(curl_errno($ch))
 {
     echo 'Curl error: ' . curl_error($ch);
 }
-
-// Close handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-error.xml b/reference/curl/functions/curl-error.xml
index 68b527de95fe..30b4e6fa68e7 100644
--- a/reference/curl/functions/curl-error.xml
+++ b/reference/curl/functions/curl-error.xml
@@ -71,9 +71,6 @@ else
 {
     echo 'Operation completed without any errors';
 }
-
-// Close handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-escape.xml b/reference/curl/functions/curl-escape.xml
index b4077c02f87f..3ee6d7ef2459 100644
--- a/reference/curl/functions/curl-escape.xml
+++ b/reference/curl/functions/curl-escape.xml
@@ -81,7 +81,6 @@ $url = "http://example.com/add_location.php?location={$location}";
 curl_setopt($ch, CURLOPT_URL, $url);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 curl_exec($ch);
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-exec.xml b/reference/curl/functions/curl-exec.xml
index d8bc9532e3d8..c8d01d945f08 100644
--- a/reference/curl/functions/curl-exec.xml
+++ b/reference/curl/functions/curl-exec.xml
@@ -83,9 +83,6 @@ curl_setopt($ch, CURLOPT_HEADER, 0);
 
 // grab URL and pass it to the browser
 curl_exec($ch);
-
-// close cURL resource, and free up system resources
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-getinfo.xml b/reference/curl/functions/curl-getinfo.xml
index 0d4e8269fe46..8ef530385967 100644
--- a/reference/curl/functions/curl-getinfo.xml
+++ b/reference/curl/functions/curl-getinfo.xml
@@ -277,9 +277,6 @@ if (!curl_errno($ch)) {
   $info = curl_getinfo($ch);
   echo 'Took ', $info['total_time'], ' seconds to send a request to ', $info['url'], "\n";
 }
-
-// Close handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
@@ -306,9 +303,6 @@ if (!curl_errno($ch)) {
       echo 'Unexpected HTTP code: ', $http_code, "\n";
   }
 }
-
-// Close handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-multi-close.xml b/reference/curl/functions/curl-multi-close.xml
index 0351a20b91ac..6be6f9099b45 100644
--- a/reference/curl/functions/curl-multi-close.xml
+++ b/reference/curl/functions/curl-multi-close.xml
@@ -59,7 +59,6 @@
   <para>
    <simplelist>
     <member><function>curl_multi_init</function></member>
-    <member><function>curl_close</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/curl/functions/curl-reset.xml b/reference/curl/functions/curl-reset.xml
index 7fc0a89453eb..36849d7a0854 100644
--- a/reference/curl/functions/curl-reset.xml
+++ b/reference/curl/functions/curl-reset.xml
@@ -69,9 +69,6 @@ curl_reset($ch);
 // Send HTTP request
 curl_setopt($ch, CURLOPT_URL, 'http://example.com/');
 curl_exec($ch); // the previously set user-agent will be not sent, it has been reset by curl_reset
-
-// Close the handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-setopt-array.xml b/reference/curl/functions/curl-setopt-array.xml
index 22b4174c7a5d..a52b171179d7 100644
--- a/reference/curl/functions/curl-setopt-array.xml
+++ b/reference/curl/functions/curl-setopt-array.xml
@@ -86,9 +86,6 @@ curl_setopt_array($ch, $options);
 
 // grab URL and pass it to the browser
 curl_exec($ch);
-
-// close cURL resource, and free up system resources
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-setopt.xml b/reference/curl/functions/curl-setopt.xml
index bea2c818411b..0ea60e36df5d 100644
--- a/reference/curl/functions/curl-setopt.xml
+++ b/reference/curl/functions/curl-setopt.xml
@@ -154,9 +154,6 @@ curl_setopt($ch, CURLOPT_HEADER, false);
 
 // grab URL and pass it to the browser
 curl_exec($ch);
-
-// close cURL resource, and free up system resources
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-share-close.xml b/reference/curl/functions/curl-share-close.xml
index a9ede12fec25..372d744196fd 100644
--- a/reference/curl/functions/curl-share-close.xml
+++ b/reference/curl/functions/curl-share-close.xml
@@ -88,10 +88,6 @@ curl_exec($ch2);
 
 // Close the cURL share handle
 curl_share_close($sh);
-
-// Close the cURL handles
-curl_close($ch1);
-curl_close($ch2);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-share-init.xml b/reference/curl/functions/curl-share-init.xml
index c3e8884e330f..54ca7e829301 100644
--- a/reference/curl/functions/curl-share-init.xml
+++ b/reference/curl/functions/curl-share-init.xml
@@ -83,13 +83,6 @@ curl_setopt($ch2, CURLOPT_SHARE, $sh);
 // Execute the second cURL handle
 //  all cookies from $ch1 handle are shared with $ch2 handle
 curl_exec($ch2);
-
-// Close the cURL share handle
-curl_share_close($sh);
-
-// Close the cURL handles
-curl_close($ch1);
-curl_close($ch2);
 ?>
 ]]>
     </programlisting>
@@ -102,7 +95,6 @@ curl_close($ch2);
   <para>
    <simplelist>
     <member><function>curl_share_setopt</function></member>
-    <member><function>curl_share_close</function></member>
     <member><function>curl_share_init_persistent</function></member>
    </simplelist>
   </para>
diff --git a/reference/curl/functions/curl-share-setopt.xml b/reference/curl/functions/curl-share-setopt.xml
index 27a859d1714b..13bebddd5e33 100644
--- a/reference/curl/functions/curl-share-setopt.xml
+++ b/reference/curl/functions/curl-share-setopt.xml
@@ -97,13 +97,6 @@ curl_setopt($ch2, CURLOPT_SHARE, $sh);
 // Execute the second cURL handle
 //  all cookies from $ch1 handle are shared with $ch2 handle
 curl_exec($ch2);
-
-// Close the cURL share handle
-curl_share_close($sh);
-
-// Close the cURL handles
-curl_close($ch1);
-curl_close($ch2);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-strerror.xml b/reference/curl/functions/curl-strerror.xml
index e4a8d406c089..6cacec3ac0a3 100644
--- a/reference/curl/functions/curl-strerror.xml
+++ b/reference/curl/functions/curl-strerror.xml
@@ -58,9 +58,6 @@ if($errno = curl_errno($ch)) {
     $error_message = curl_strerror($errno);
     echo "cURL error ({$errno}):\n {$error_message}";
 }
-
-// Close the handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-unescape.xml b/reference/curl/functions/curl-unescape.xml
index f115711c002f..93214b6faa1f 100644
--- a/reference/curl/functions/curl-unescape.xml
+++ b/reference/curl/functions/curl-unescape.xml
@@ -79,9 +79,6 @@ $effective_url = curl_getinfo($ch, CURLINFO_EFFECTIVE_URL);
 // Decode the URL
 $effective_url_decoded = curl_unescape($ch, $effective_url);
 // "http://example.com/show_location.php?loc=München"
-
-// Close the handle
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
diff --git a/reference/curl/functions/curl-upkeep.xml b/reference/curl/functions/curl-upkeep.xml
index fea892030a23..1de13be862f3 100644
--- a/reference/curl/functions/curl-upkeep.xml
+++ b/reference/curl/functions/curl-upkeep.xml
@@ -62,7 +62,6 @@ if (curl_exec($ch)) {
     usleep(300);
     var_dump(curl_upkeep($ch));
 }
-curl_close($ch);
 ?>
 ]]>
     </programlisting>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.