CINXE.COM

<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>PHP: curl_setopt - Manual </title> <link rel="icon" type="image/svg+xml" sizes="any" href="https://www.php.net/favicon.svg?v=2"> <link rel="icon" type="image/png" sizes="196x196" href="https://www.php.net/favicon-196x196.png?v=2"> <link rel="icon" type="image/png" sizes="32x32" href="https://www.php.net/favicon-32x32.png?v=2"> <link rel="icon" type="image/png" sizes="16x16" href="https://www.php.net/favicon-16x16.png?v=2"> <link rel="shortcut icon" href="https://www.php.net/favicon.ico?v=2"> <link rel="search" type="application/opensearchdescription+xml" href="http://php.net/phpnetimprovedsearch.src" title="Add PHP.net search"> <link rel="alternate" type="application/atom+xml" href="https://www.php.net/releases/feed.php" title="PHP Release feed"> <link rel="alternate" type="application/atom+xml" href="https://www.php.net/feed.atom" title="PHP: Hypertext Preprocessor"> <link rel="canonical" href="https://www.php.net/manual/en/function.curl-setopt.php"> <link rel="shorturl" href="https://www.php.net/curl-setopt"> <link rel="alternate" href="https://www.php.net/curl-setopt" hreflang="x-default"> <link rel="contents" href="https://www.php.net/manual/en/index.php"> <link rel="index" href="https://www.php.net/manual/en/ref.curl.php"> <link rel="prev" href="https://www.php.net/manual/en/function.curl-reset.php"> <link rel="next" href="https://www.php.net/manual/en/function.curl-setopt-array.php"> <link rel="alternate" href="https://www.php.net/manual/en/function.curl-setopt.php" hreflang="en"> <link rel="alternate" href="https://www.php.net/manual/de/function.curl-setopt.php" hreflang="de"> <link rel="alternate" href="https://www.php.net/manual/es/function.curl-setopt.php" hreflang="es"> <link rel="alternate" href="https://www.php.net/manual/fr/function.curl-setopt.php" hreflang="fr"> <link rel="alternate" href="https://www.php.net/manual/it/function.curl-setopt.php" hreflang="it"> <link rel="alternate" href="https://www.php.net/manual/ja/function.curl-setopt.php" hreflang="ja"> <link rel="alternate" href="https://www.php.net/manual/pt_BR/function.curl-setopt.php" hreflang="pt_BR"> <link rel="alternate" href="https://www.php.net/manual/ru/function.curl-setopt.php" hreflang="ru"> <link rel="alternate" href="https://www.php.net/manual/tr/function.curl-setopt.php" hreflang="tr"> <link rel="alternate" href="https://www.php.net/manual/uk/function.curl-setopt.php" hreflang="uk"> <link rel="alternate" href="https://www.php.net/manual/zh/function.curl-setopt.php" hreflang="zh"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1707321815&f=/fonts/Fira/fira.css" media="screen"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1707321815&f=/fonts/Font-Awesome/css/fontello.css" media="screen"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1738926002&f=/styles/theme-base.css" media="screen"> <link rel="stylesheet" type="text/css" href="/cached.php?t=1730558402&f=/styles/theme-medium.css" media="screen"> <base href="https://www.php.net/manual/en/function.curl-setopt.php"> <meta name="Description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <meta name="twitter:card" content="summary_large_image" /> <meta name="twitter:site" content="@official_php" /> <meta name="twitter:title" content="PHP: Hypertext Preprocessor" /> <meta name="twitter:description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <meta name="twitter:creator" content="@official_php" /> <meta name="twitter:image:src" content="https://www.php.net/images/meta-image.png" /> <meta itemprop="name" content="PHP: Hypertext Preprocessor" /> <meta itemprop="description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <meta itemprop="image" content="https://www.php.net/images/meta-image.png" /> <meta property="og:image" content="https://www.php.net/images/meta-image.png" /> <meta property="og:description" content="PHP is a popular general-purpose scripting language that powers everything from your blog to the most popular websites in the world." /> <link href="https://fosstodon.org/@php" rel="me" />  <script> var _paq = window._paq = window._paq || []; /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ _paq.push(["setDoNotTrack", true]); _paq.push(["disableCookies"]); _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="https://analytics.php.net/"; _paq.push(['setTrackerUrl', u+'matomo.php']); _paq.push(['setSiteId', '1']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s); })(); </script>  </head> <body class="docs "> <nav class="navbar navbar-fixed-top"> <div class="navbar__inner"> <a href="/" aria-label="PHP Home" class="navbar__brand"> <img src="/images/logos/php-logo-white.svg" aria-hidden="true" width="80" height="40" > </a> <div id="navbar__offcanvas" tabindex="-1" class="navbar__offcanvas" aria-label="Menu" > <button id="navbar__close-button" class="navbar__icon-item navbar_icon-item--visually-aligned navbar__close-button" > <svg xmlns="http://www.w3.org/2000/svg" width="24" viewBox="0 0 24 24" fill="currentColor"><path d="M19,6.41L17.59,5L12,10.59L6.41,5L5,6.41L10.59,12L5,17.59L6.41,19L12,13.41L17.59,19L19,17.59L13.41,12L19,6.41Z" /></svg> </button> <ul class="navbar__nav"> <li class="navbar__item"> <a href="/downloads.php" class="navbar__link " > Downloads </a> </li> <li class="navbar__item"> <a href="/docs.php" aria-current="page" class="navbar__link navbar__link--active " > Documentation </a> </li> <li class="navbar__item"> <a href="/get-involved.php" class="navbar__link " > Get Involved </a> </li> <li class="navbar__item"> <a href="/support.php" class="navbar__link " > Help </a> </li> <li class="navbar__item"> <a href="/releases/8.4/index.php" class="navbar__link navbar__release" > <img src="/images/php8/logo_php8_4.svg" alt="PHP 8.4"> </a> </li> </ul> </div> <div class="navbar__right">  <form action="/manual-lookup.php" class="navbar__search-form" > <label for="navbar__search-input" aria-label="Search docs"> <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </label> <input type="search" name="pattern" id="navbar__search-input" class="navbar__search-input" placeholder="Search docs" accesskey="s" > <input type="hidden" name="scope" value="quickref"> </form>  <button id="navbar__search-button" class="navbar__search-button" hidden > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> Search docs </button>  <a id="navbar__search-link" href="/lookup-form.php" aria-label="Search docs" class="navbar__icon-item navbar__search-link" > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </a> <a id="navbar__menu-link" href="/menu.php" aria-label="Menu" class="navbar__icon-item navbar_icon-item--visually-aligned navbar_menu-link" > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="currentColor" > <path d="M3,6H21V8H3V6M3,11H21V13H3V11M3,16H21V18H3V16Z" /> </svg> </a>  <button id="navbar__search-button-mobile" aria-label="Search docs" class="navbar__icon-item navbar__search-button-mobile" hidden > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </button> <button id="navbar__menu-button" aria-label="Menu" class="navbar__icon-item navbar_icon-item--visually-aligned" hidden > <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="currentColor" > <path d="M3,6H21V8H3V6M3,11H21V13H3V11M3,16H21V18H3V16Z" /> </svg> </button> </div> <div id="navbar__backdrop" class="navbar__backdrop" ></div> </div> <div id="flash-message"></div> </nav> <div class="headsup"><a href='/index.php#2025-02-13-2'>PHP 8.3.17 Released!</a></div> <nav id="trick"><div><dl> <dt><a href='/manual/en/getting-started.php'>Getting Started</a></dt> <dd><a href='/manual/en/introduction.php'>Introduction</a></dd> <dd><a href='/manual/en/tutorial.php'>A simple tutorial</a></dd> <dt><a href='/manual/en/langref.php'>Language Reference</a></dt> <dd><a href='/manual/en/language.basic-syntax.php'>Basic syntax</a></dd> <dd><a href='/manual/en/language.types.php'>Types</a></dd> <dd><a href='/manual/en/language.variables.php'>Variables</a></dd> <dd><a href='/manual/en/language.constants.php'>Constants</a></dd> <dd><a href='/manual/en/language.expressions.php'>Expressions</a></dd> <dd><a href='/manual/en/language.operators.php'>Operators</a></dd> <dd><a href='/manual/en/language.control-structures.php'>Control Structures</a></dd> <dd><a href='/manual/en/language.functions.php'>Functions</a></dd> <dd><a href='/manual/en/language.oop5.php'>Classes and Objects</a></dd> <dd><a href='/manual/en/language.namespaces.php'>Namespaces</a></dd> <dd><a href='/manual/en/language.enumerations.php'>Enumerations</a></dd> <dd><a href='/manual/en/language.errors.php'>Errors</a></dd> <dd><a href='/manual/en/language.exceptions.php'>Exceptions</a></dd> <dd><a href='/manual/en/language.fibers.php'>Fibers</a></dd> <dd><a href='/manual/en/language.generators.php'>Generators</a></dd> <dd><a href='/manual/en/language.attributes.php'>Attributes</a></dd> <dd><a href='/manual/en/language.references.php'>References Explained</a></dd> <dd><a href='/manual/en/reserved.variables.php'>Predefined Variables</a></dd> <dd><a href='/manual/en/reserved.exceptions.php'>Predefined Exceptions</a></dd> <dd><a href='/manual/en/reserved.interfaces.php'>Predefined Interfaces and Classes</a></dd> <dd><a href='/manual/en/reserved.attributes.php'>Predefined Attributes</a></dd> <dd><a href='/manual/en/context.php'>Context options and parameters</a></dd> <dd><a href='/manual/en/wrappers.php'>Supported Protocols and Wrappers</a></dd> </dl> <dl> <dt><a href='/manual/en/security.php'>Security</a></dt> <dd><a href='/manual/en/security.intro.php'>Introduction</a></dd> <dd><a href='/manual/en/security.general.php'>General considerations</a></dd> <dd><a href='/manual/en/security.cgi-bin.php'>Installed as CGI binary</a></dd> <dd><a href='/manual/en/security.apache.php'>Installed as an Apache module</a></dd> <dd><a href='/manual/en/security.sessions.php'>Session Security</a></dd> <dd><a href='/manual/en/security.filesystem.php'>Filesystem Security</a></dd> <dd><a href='/manual/en/security.database.php'>Database Security</a></dd> <dd><a href='/manual/en/security.errors.php'>Error Reporting</a></dd> <dd><a href='/manual/en/security.variables.php'>User Submitted Data</a></dd> <dd><a href='/manual/en/security.hiding.php'>Hiding PHP</a></dd> <dd><a href='/manual/en/security.current.php'>Keeping Current</a></dd> <dt><a href='/manual/en/features.php'>Features</a></dt> <dd><a href='/manual/en/features.http-auth.php'>HTTP authentication with PHP</a></dd> <dd><a href='/manual/en/features.cookies.php'>Cookies</a></dd> <dd><a href='/manual/en/features.sessions.php'>Sessions</a></dd> <dd><a href='/manual/en/features.file-upload.php'>Handling file uploads</a></dd> <dd><a href='/manual/en/features.remote-files.php'>Using remote files</a></dd> <dd><a href='/manual/en/features.connection-handling.php'>Connection handling</a></dd> <dd><a href='/manual/en/features.persistent-connections.php'>Persistent Database Connections</a></dd> <dd><a href='/manual/en/features.commandline.php'>Command line usage</a></dd> <dd><a href='/manual/en/features.gc.php'>Garbage Collection</a></dd> <dd><a href='/manual/en/features.dtrace.php'>DTrace Dynamic Tracing</a></dd> </dl> <dl> <dt><a href='/manual/en/funcref.php'>Function Reference</a></dt> <dd><a href='/manual/en/refs.basic.php.php'>Affecting PHP's Behaviour</a></dd> <dd><a href='/manual/en/refs.utilspec.audio.php'>Audio Formats Manipulation</a></dd> <dd><a href='/manual/en/refs.remote.auth.php'>Authentication Services</a></dd> <dd><a href='/manual/en/refs.utilspec.cmdline.php'>Command Line Specific Extensions</a></dd> <dd><a href='/manual/en/refs.compression.php'>Compression and Archive Extensions</a></dd> <dd><a href='/manual/en/refs.crypto.php'>Cryptography Extensions</a></dd> <dd><a href='/manual/en/refs.database.php'>Database Extensions</a></dd> <dd><a href='/manual/en/refs.calendar.php'>Date and Time Related Extensions</a></dd> <dd><a href='/manual/en/refs.fileprocess.file.php'>File System Related Extensions</a></dd> <dd><a href='/manual/en/refs.international.php'>Human Language and Character Encoding Support</a></dd> <dd><a href='/manual/en/refs.utilspec.image.php'>Image Processing and Generation</a></dd> <dd><a href='/manual/en/refs.remote.mail.php'>Mail Related Extensions</a></dd> <dd><a href='/manual/en/refs.math.php'>Mathematical Extensions</a></dd> <dd><a href='/manual/en/refs.utilspec.nontext.php'>Non-Text MIME Output</a></dd> <dd><a href='/manual/en/refs.fileprocess.process.php'>Process Control Extensions</a></dd> <dd><a href='/manual/en/refs.basic.other.php'>Other Basic Extensions</a></dd> <dd><a href='/manual/en/refs.remote.other.php'>Other Services</a></dd> <dd><a href='/manual/en/refs.search.php'>Search Engine Extensions</a></dd> <dd><a href='/manual/en/refs.utilspec.server.php'>Server Specific Extensions</a></dd> <dd><a href='/manual/en/refs.basic.session.php'>Session Extensions</a></dd> <dd><a href='/manual/en/refs.basic.text.php'>Text Processing</a></dd> <dd><a href='/manual/en/refs.basic.vartype.php'>Variable and Type Related Extensions</a></dd> <dd><a href='/manual/en/refs.webservice.php'>Web Services</a></dd> <dd><a href='/manual/en/refs.utilspec.windows.php'>Windows Only Extensions</a></dd> <dd><a href='/manual/en/refs.xml.php'>XML Manipulation</a></dd> <dd><a href='/manual/en/refs.ui.php'>GUI Extensions</a></dd> </dl> <dl> <dt>Keyboard Shortcuts</dt><dt>?</dt> <dd>This help</dd> <dt>j</dt> <dd>Next menu item</dd> <dt>k</dt> <dd>Previous menu item</dd> <dt>g p</dt> <dd>Previous man page</dd> <dt>g n</dt> <dd>Next man page</dd> <dt>G</dt> <dd>Scroll to bottom</dd> <dt>g g</dt> <dd>Scroll to top</dd> <dt>g h</dt> <dd>Goto homepage</dd> <dt>g s</dt> <dd>Goto search (current page)</dd> <dt>/</dt> <dd>Focus search box</dd> </dl></div></nav> <div id="goto"> <div class="search"> <div class="text"></div> <div class="results"><ul></ul></div> </div> </div> <div id="breadcrumbs" class="clearfix"> <div id="breadcrumbs-inner"> <div class="next"> <a href="function.curl-setopt-array.php"> curl_setopt_array » </a> </div> <div class="prev"> <a href="function.curl-reset.php"> « curl_reset </a> </div> <ul> <li><a href='index.php'>PHP Manual</a></li> <li><a href='funcref.php'>Function Reference</a></li> <li><a href='refs.remote.other.php'>Other Services</a></li> <li><a href='book.curl.php'>cURL</a></li> <li><a href='ref.curl.php'>cURL Functions</a></li> </ul> </div> </div> <div id="layout" class="clearfix"> <section id="layout-content"> <div class="page-tools"> <div class="change-language"> <form action="/manual/change.php" method="get" id="changelang" name="changelang"> <fieldset> <label for="changelang-langs">Change language:</label> <select onchange="document.changelang.submit()" name="page" id="changelang-langs"> <option value='en/function.curl-setopt.php' selected="selected">English</option> <option value='de/function.curl-setopt.php'>German</option> <option value='es/function.curl-setopt.php'>Spanish</option> <option value='fr/function.curl-setopt.php'>French</option> <option value='it/function.curl-setopt.php'>Italian</option> <option value='ja/function.curl-setopt.php'>Japanese</option> <option value='pt_BR/function.curl-setopt.php'>Brazilian Portuguese</option> <option value='ru/function.curl-setopt.php'>Russian</option> <option value='tr/function.curl-setopt.php'>Turkish</option> <option value='uk/function.curl-setopt.php'>Ukrainian</option> <option value='zh/function.curl-setopt.php'>Chinese (Simplified)</option> <option value='help-translate.php'>Other</option> </select> </fieldset> </form> </div> </div><div id="function.curl-setopt" class="refentry"> <div class="refnamediv"> <h1 class="refname">curl_setopt</h1> (PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)curl_setopt — Set an option for a cURL transfer </div> <div class="refsect1 description" id="refsect1-function.curl-setopt-description"> <h3 class="title">Description</h3> <div class="methodsynopsis dc-description"> curl_setopt(<a href="class.curlhandle.php" class="type CurlHandle">CurlHandle</a> <code class="parameter">$handle</code>, <a href="language.types.integer.php" class="type int">int</a> <code class="parameter">$option</code>, <a href="language.types.mixed.php" class="type mixed">mixed</a> <code class="parameter">$value</code>): <a href="language.types.boolean.php" class="type bool">bool</a></div> Sets an option on the given cURL session handle. </div> <div class="refsect1 parameters" id="refsect1-function.curl-setopt-parameters"> <h3 class="title">Parameters</h3> <dl> <dt><code class="parameter">handle</code> </dt><dd>A cURL handle returned by <a href="function.curl-init.php" class="function">curl_init()</a>.</dd> <dt><code class="parameter">option</code></dt> <dd> The <code><a href="curl.constants.php#constant.curlopt-abstract-unix-socket">CURLOPT_*</a></code> option to set. </dd> <dt><code class="parameter">value</code></dt> <dd> The value to be set on <code class="parameter">option</code>. See the description of the <code><a href="curl.constants.php#constant.curlopt-abstract-unix-socket">CURLOPT_*</a></code> constants for details on the type of values each constant expects. </dd> </dl> </div> <div class="refsect1 returnvalues" id="refsect1-function.curl-setopt-returnvalues"> <h3 class="title">Return Values</h3> Returns <code><a href="reserved.constants.php#constant.true">true</a></code> on success or <code><a href="reserved.constants.php#constant.false">false</a></code> on failure. </div> <div class="refsect1 changelog" id="refsect1-function.curl-setopt-changelog"> <h3 class="title">Changelog</h3> <table class="doctable informaltable"> <thead> <tr> <th>Version</th> <th>Description</th> </tr> </thead> <tbody class="tbody"> <tr> <td>8.4.0</td> <td> <code><a href="curl.constants.php#constant.curlopt-dns-use-global-cache">CURLOPT_DNS_USE_GLOBAL_CACHE</a></code> no longer has any effect, and enabling it on thread-safe PHP builds no longer triggers a warning. </td> </tr> <tr> <td>8.0.0</td> <td> <code class="parameter">handle</code> expects a <a href="class.curlhandle.php" class="classname">CurlHandle</a> instance now; previously, a <a href="language.types.resource.php" class="type resource">resource</a> was expected. </td> </tr> <tr> <td>7.3.15, 7.4.3</td> <td> Introduced <code><a href="curl.constants.php#constant.curlopt-http09-allowed">CURLOPT_HTTP09_ALLOWED</a></code>. </td> </tr> <tr> <td>7.3.0</td> <td> Introduced <code><a href="curl.constants.php#constant.curlopt-abstract-unix-socket">CURLOPT_ABSTRACT_UNIX_SOCKET</a></code>, <code><a href="curl.constants.php#constant.curlopt-keep-sending-on-error">CURLOPT_KEEP_SENDING_ON_ERROR</a></code>, <code><a href="curl.constants.php#constant.curlopt-pre-proxy">CURLOPT_PRE_PROXY</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-cainfo">CURLOPT_PROXY_CAINFO</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-capath">CURLOPT_PROXY_CAPATH</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-crlfile">CURLOPT_PROXY_CRLFILE</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-keypasswd">CURLOPT_PROXY_KEYPASSWD</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-pinnedpublickey">CURLOPT_PROXY_PINNEDPUBLICKEY</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-sslcert">CURLOPT_PROXY_SSLCERT</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-sslcerttype">CURLOPT_PROXY_SSLCERTTYPE</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-ssl-cipher-list">CURLOPT_PROXY_SSL_CIPHER_LIST</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-sslkey">CURLOPT_PROXY_SSLKEY</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-sslkeytype">CURLOPT_PROXY_SSLKEYTYPE</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-ssl-options">CURLOPT_PROXY_SSL_OPTIONS</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-ssl-verifyhost">CURLOPT_PROXY_SSL_VERIFYHOST</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-ssl-verifypeer">CURLOPT_PROXY_SSL_VERIFYPEER</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-sslversion">CURLOPT_PROXY_SSLVERSION</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-tlsauth-password">CURLOPT_PROXY_TLSAUTH_PASSWORD</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-tlsauth-type">CURLOPT_PROXY_TLSAUTH_TYPE</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-tlsauth-username">CURLOPT_PROXY_TLSAUTH_USERNAME</a></code>, <code><a href="curl.constants.php#constant.curlopt-socks5-auth">CURLOPT_SOCKS5_AUTH</a></code>, <code><a href="curl.constants.php#constant.curlopt-suppress-connect-headers">CURLOPT_SUPPRESS_CONNECT_HEADERS</a></code>, <code><a href="curl.constants.php#constant.curlopt-disallow-username-in-url">CURLOPT_DISALLOW_USERNAME_IN_URL</a></code>, <code><a href="curl.constants.php#constant.curlopt-dns-shuffle-addresses">CURLOPT_DNS_SHUFFLE_ADDRESSES</a></code>, <code><a href="curl.constants.php#constant.curlopt-happy-eyeballs-timeout-ms">CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS</a></code>, <code><a href="curl.constants.php#constant.curlopt-haproxyprotocol">CURLOPT_HAPROXYPROTOCOL</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-tls13-ciphers">CURLOPT_PROXY_TLS13_CIPHERS</a></code>, <code><a href="curl.constants.php#constant.curlopt-ssh-compression">CURLOPT_SSH_COMPRESSION</a></code>, <code><a href="curl.constants.php#constant.curlopt-timevalue-large">CURLOPT_TIMEVALUE_LARGE</a></code> and <code><a href="curl.constants.php#constant.curlopt-tls13-ciphers">CURLOPT_TLS13_CIPHERS</a></code>. </td> </tr> <tr> <td>7.0.7</td> <td> Introduced <code><a href="curl.constants.php#constant.curl-http-version-2">CURL_HTTP_VERSION_2</a></code>, <code><a href="curl.constants.php#constant.curl-http-version-2-prior-knowledge">CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</a></code>, <code><a href="curl.constants.php#constant.curl-http-version-2tls">CURL_HTTP_VERSION_2TLS</a></code>, <code><a href="curl.constants.php#constant.curl-redir-post-301">CURL_REDIR_POST_301</a></code>, <code><a href="curl.constants.php#constant.curl-redir-post-302">CURL_REDIR_POST_302</a></code>, <code><a href="curl.constants.php#constant.curl-redir-post-303">CURL_REDIR_POST_303</a></code>, <code><a href="curl.constants.php#constant.curl-redir-post-all">CURL_REDIR_POST_ALL</a></code>, <code><a href="curl.constants.php#constant.curl-version-kerberos5">CURL_VERSION_KERBEROS5</a></code>, <code><a href="curl.constants.php#constant.curl-version-psl">CURL_VERSION_PSL</a></code>, <code><a href="curl.constants.php#constant.curl-version-unix-sockets">CURL_VERSION_UNIX_SOCKETS</a></code>, <code><a href="curl.constants.php#constant.curlauth-negotiate">CURLAUTH_NEGOTIATE</a></code>, <code><a href="curl.constants.php#constant.curlauth-ntlm-wb">CURLAUTH_NTLM_WB</a></code>, <code><a href="curl.constants.php#constant.curlftp-create-dir">CURLFTP_CREATE_DIR</a></code>, <code><a href="curl.constants.php#constant.curlftp-create-dir-none">CURLFTP_CREATE_DIR_NONE</a></code>, <code><a href="curl.constants.php#constant.curlftp-create-dir-retry">CURLFTP_CREATE_DIR_RETRY</a></code>, <code><a href="curl.constants.php#constant.curlheader-separate">CURLHEADER_SEPARATE</a></code>, <code><a href="curl.constants.php#constant.curlheader-unified">CURLHEADER_UNIFIED</a></code>, <code><a href="curl.constants.php#constant.curlmopt-chunk-length-penalty-size">CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE</a></code>, <code><a href="curl.constants.php#constant.curlmopt-content-length-penalty-size">CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE</a></code>, <code><a href="curl.constants.php#constant.curlmopt-max-host-connections">CURLMOPT_MAX_HOST_CONNECTIONS</a></code>, <code><a href="curl.constants.php#constant.curlmopt-max-pipeline-length">CURLMOPT_MAX_PIPELINE_LENGTH</a></code>, <code><a href="curl.constants.php#constant.curlmopt-max-total-connections">CURLMOPT_MAX_TOTAL_CONNECTIONS</a></code>, <code><a href="curl.constants.php#constant.curlopt-connect-to">CURLOPT_CONNECT_TO</a></code>, <code><a href="curl.constants.php#constant.curlopt-default-protocol">CURLOPT_DEFAULT_PROTOCOL</a></code>, <code><a href="curl.constants.php#constant.curlopt-dns-interface">CURLOPT_DNS_INTERFACE</a></code>, <code><a href="curl.constants.php#constant.curlopt-dns-local-ip4">CURLOPT_DNS_LOCAL_IP4</a></code>, <code><a href="curl.constants.php#constant.curlopt-dns-local-ip6">CURLOPT_DNS_LOCAL_IP6</a></code>, <code><a href="curl.constants.php#constant.curlopt-expect-100-timeout-ms">CURLOPT_EXPECT_100_TIMEOUT_MS</a></code>, <code><a href="curl.constants.php#constant.curlopt-headeropt">CURLOPT_HEADEROPT</a></code>, <code><a href="curl.constants.php#constant.curlopt-login-options">CURLOPT_LOGIN_OPTIONS</a></code>, <code><a href="curl.constants.php#constant.curlopt-path-as-is">CURLOPT_PATH_AS_IS</a></code>, <code><a href="curl.constants.php#constant.curlopt-pinnedpublickey">CURLOPT_PINNEDPUBLICKEY</a></code>, <code><a href="curl.constants.php#constant.curlopt-pipewait">CURLOPT_PIPEWAIT</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxy-service-name">CURLOPT_PROXY_SERVICE_NAME</a></code>, <code><a href="curl.constants.php#constant.curlopt-proxyheader">CURLOPT_PROXYHEADER</a></code>, <code><a href="curl.constants.php#constant.curlopt-sasl-ir">CURLOPT_SASL_IR</a></code>, <code><a href="curl.constants.php#constant.curlopt-service-name">CURLOPT_SERVICE_NAME</a></code>, <code><a href="curl.constants.php#constant.curlopt-ssl-enable-alpn">CURLOPT_SSL_ENABLE_ALPN</a></code>, <code><a href="curl.constants.php#constant.curlopt-ssl-enable-npn">CURLOPT_SSL_ENABLE_NPN</a></code>, <code><a href="curl.constants.php#constant.curlopt-ssl-falsestart">CURLOPT_SSL_FALSESTART</a></code>, <code><a href="curl.constants.php#constant.curlopt-ssl-verifystatus">CURLOPT_SSL_VERIFYSTATUS</a></code>, <code><a href="curl.constants.php#constant.curlopt-stream-weight">CURLOPT_STREAM_WEIGHT</a></code>, <code><a href="curl.constants.php#constant.curlopt-tcp-fastopen">CURLOPT_TCP_FASTOPEN</a></code>, <code><a href="curl.constants.php#constant.curlopt-tftp-no-options">CURLOPT_TFTP_NO_OPTIONS</a></code>, <code><a href="curl.constants.php#constant.curlopt-unix-socket-path">CURLOPT_UNIX_SOCKET_PATH</a></code>, <code><a href="curl.constants.php#constant.curlopt-xoauth2-bearer">CURLOPT_XOAUTH2_BEARER</a></code>, <code><a href="curl.constants.php#constant.curlproto-smb">CURLPROTO_SMB</a></code>, <code><a href="curl.constants.php#constant.curlproto-smbs">CURLPROTO_SMBS</a></code>, <code><a href="curl.constants.php#constant.curlproxy-http-1-0">CURLPROXY_HTTP_1_0</a></code>, <code><a href="curl.constants.php#constant.curlssh-auth-agent">CURLSSH_AUTH_AGENT</a></code> and <code><a href="curl.constants.php#constant.curlsslopt-no-revoke">CURLSSLOPT_NO_REVOKE</a></code>. </td> </tr> </tbody> </table> </div> <div class="refsect1 examples" id="refsect1-function.curl-setopt-examples"> <h3 class="title">Examples</h3> <div class="example" id="example-4405"> Example #1 Initializing a new cURL session and fetching a web page <div class="example-contents"> <div class="phpcode"><code><?php // create a new cURL resource $ch = curl_init(); // set URL and other appropriate options curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); 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); ?></code></div> </div> </div> </div> <div class="refsect1 notes" id="refsect1-function.curl-setopt-notes"> <h3 class="title">Notes</h3> <blockquote class="note">Note: Passing an array to <code><a href="curl.constants.php#constant.curlopt-postfields">CURLOPT_POSTFIELDS</a></code> will encode the data as multipart/form-data, while passing a URL-encoded string will encode the data as application/x-www-form-urlencoded. </blockquote> </div> <div class="refsect1 seealso" id="refsect1-function.curl-setopt-seealso"> <h3 class="title">See Also</h3> <ul class="simplelist"> <li><a href="function.curl-setopt-array.php" class="function" rel="rdfs-seeAlso">curl_setopt_array()</a> - Set multiple options for a cURL transfer</li> <li><a href="class.curlfile.php" class="classname">CURLFile</a></li> <li><a href="class.curlstringfile.php" class="classname">CURLStringFile</a></li> </ul> </div> </div> <div class="contribute"> <h3 class="title">Found A Problem?</h3> <div> </div> <div class="edit-bug"> <a href="https://github.com/php/doc-base/blob/master/README.md" title="This will take you to our contribution guidelines on GitHub" target="_blank" rel="noopener noreferrer">Learn How To Improve This Page</a> • <a href="https://github.com/php/doc-en/blob/master/reference/curl/functions/curl-setopt.xml">Submit a Pull Request</a> • <a href="https://github.com/php/doc-en/issues/new?body=From%20manual%20page:%20https:%2F%2Fphp.net%2Ffunction.curl-setopt%0A%0A---">Report a Bug</a> </div> </div><section id="usernotes"> <div class="head"> <a href="/manual/add-note.php?sect=function.curl-setopt&repo=en&redirect=https://www.php.net/manual/en/function.curl-setopt.php">＋add a note</a> <h3 class="title">User Contributed Notes 64 notes</h3> </div><div id="allnotes"> <div class="note" id="110457"> <div class="votes"> <div id="Vu110457"> <a href="/manual/vote-note.php?id=110457&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd110457"> <a href="/manual/vote-note.php?id=110457&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V110457" title="78% like this..."> 223 </div> </div> <a href="#110457" class="name"> rmckay at webaware dot com dot au</a><a class="genanchor" href="#110457"> ¶</a><div class="date" title="2012-10-24 12:21">12 years ago</div> <div class="text" id="Hcom110457"> <div class="phpcode"><code>Please everyone, stop setting CURLOPT_SSL_VERIFYPEER to false or 0. If your PHP installation doesn't have an up-to-date CA root certificate bundle, download the one at the curl website and save it on your server: <a href="http://curl.haxx.se/docs/caextract.html" rel="nofollow" target="_blank">http://curl.haxx.se/docs/caextract.html</a> Then set a path to it in your php.ini file, e.g. on Windows: curl.cainfo=c:\php\cacert.pem Turning off CURLOPT_SSL_VERIFYPEER allows man in the middle (MITM) attacks, which you don't want!</code></div> </div> </div> <div class="note" id="118967"> <div class="votes"> <div id="Vu118967"> <a href="/manual/vote-note.php?id=118967&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd118967"> <a href="/manual/vote-note.php?id=118967&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V118967" title="76% like this..."> 49 </div> </div> <a href="#118967" class="name"> joey</a><a class="genanchor" href="#118967"> ¶</a><div class="date" title="2016-03-09 06:54">8 years ago</div> <div class="text" id="Hcom118967"> <div class="phpcode"><code>It is important that anyone working with cURL and PHP keep in mind that not all of the CURLOPT and CURLINFO constants are documented. I always recommend reading the cURL documentation directly as it sometimes contains better information. The cURL API in tends to be fubar as well so do not expect things to be where you would normally logically look for them. curl is especially difficult to work with when it comes to cookies. So I will talk about what I found with PHP 5.6 and curl 7.26. If you want to manage cookies in memory without using files including reading, writing and clearing custom cookies then continue reading. To start with, the way to enable in memory only cookies associated with a cURL handle you should use: curl_setopt($curl, CURLOPT_COOKIEFILE, ""); cURL likes to use magic strings in options as special commands. Rather than having an option to enable the cookie engine in memory it uses a magic string to do that. Although vaguely the documentation here mentions this however most people like me wouldn't even read that because a COOKIEFILE is the complete opposite of what we want. To get the cookies for a curl handle you can use: curl_getinfo($curl, CURLINFO_COOKIELIST); This will give an array containing a string for each cookie. It is tab delimited and unfortunately you will have to parse it yourself if you want to do anything beyond copying the cookies. To clear the in memory cookies for a cURL handle you can use: curl_setopt($curl, CURLOPT_COOKIELIST, "ALL"); This is a magic string. There are others in the cURL documentation. If a magic string isn't used, this field should take a cookie in the same string format as in getinfo for the cookielist constant. This can be used to delete individual cookies although it's not the most elegant API for doing so. For copying cookies I recommend using curl_share_init. You can also copy cookies from one handle to another like so: foreach(curl_getinfo($curl_a, CURLINFO_COOKIELIST) as $cookie_line) curl_setopt($curl, CURLOPT_COOKIELIST, $cookie_line); An inelegant way to delete a cookie would be to skip the one you don't want. I only recommend using COOKIELIST with magic strings because the cookie format is not secure or stable. You can inject tabs into at least path and name so it becomes impossible to parse reliably. If you must parse this then to keep it secure I recommend prohibiting more than 6 tabs in the content which probably isn't a big loss to most people. A the absolute minimum for validation I would suggest: /^([^\t]+\t){5}[^\t]+$/D Here is the format: #define SEP "\t" /* Tab separates the fields */ char *my_cookie = "example.com" /* Hostname */ SEP "FALSE" /* Include subdomains */ SEP "/" /* Path */ SEP "FALSE" /* Secure */ SEP "0" /* Expiry in epoch time format. 0 == Session */ SEP "foo" /* Name */ SEP "bar"; /* Value */</code></div> </div> </div> <div class="note" id="75525"> <div class="votes"> <div id="Vu75525"> <a href="/manual/vote-note.php?id=75525&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd75525"> <a href="/manual/vote-note.php?id=75525&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V75525" title="80% like this..."> 13 </div> </div> <a href="#75525" class="name"> ashw1 - at - no spam - post - dot - cz</a><a class="genanchor" href="#75525"> ¶</a><div class="date" title="2007-06-03 04:51">17 years ago</div> <div class="text" id="Hcom75525"> <div class="phpcode"><code>In case you wonder how come, that cookies don't work under Windows, I've googled for some answers, and here is the result: Under WIN you need to input absolute path of the cookie file. This piece of code solves it: <?php if ($cookies != '') { if (substr(PHP_OS, 0, 3) == 'WIN') {$cookies = str_replace('\\','/', getcwd().'/'.$cookies);} curl_setopt($ch, CURLOPT_COOKIEJAR, $cookies); curl_setopt($ch, CURLOPT_COOKIEFILE, $cookies); } ?></code></div> </div> </div> <div class="note" id="104597"> <div class="votes"> <div id="Vu104597"> <a href="/manual/vote-note.php?id=104597&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd104597"> <a href="/manual/vote-note.php?id=104597&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V104597" title="76% like this..."> 33 </div> </div> <a href="#104597" class="name"> Steve Kamerman</a><a class="genanchor" href="#104597"> ¶</a><div class="date" title="2011-06-24 11:47">13 years ago</div> <div class="text" id="Hcom104597"> <div class="phpcode"><code>If you want cURL to timeout in less than one second, you can use CURLOPT_TIMEOUT_MS, although there is a bug/"feature" on "Unix-like systems" that causes libcurl to timeout immediately if the value is < 1000 ms with the error "cURL Error (28): Timeout was reached". The explanation for this behavior is: "If libcurl is built to use the standard system name resolver, that portion of the transfer will still use full-second resolution for timeouts with a minimum timeout allowed of one second." What this means to PHP developers is "You can use this function without testing it first, because you can't tell if libcurl is using the standard system name resolver (but you can be pretty sure it is)" The problem is that on (Li|U)nix, when libcurl uses the standard name resolver, a SIGALRM is raised during name resolution which libcurl thinks is the timeout alarm. The solution is to disable signals using CURLOPT_NOSIGNAL. Here's an example script that requests itself causing a 10-second delay so you can test timeouts: <?php if (!isset($_GET['foo'])) { // Client $ch = curl_init('<a href="http://localhost/test/test_timeout.php?foo=bar" rel="nofollow" target="_blank">http://localhost/test/test_timeout.php?foo=bar</a>'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_NOSIGNAL, 1); curl_setopt($ch, CURLOPT_TIMEOUT_MS, 200); $data = curl_exec($ch); $curl_errno = curl_errno($ch); $curl_error = curl_error($ch); curl_close($ch); if ($curl_errno > 0) { echo "cURL Error ($curl_errno): $curl_error\n"; } else { echo "Data received: $data\n"; } } else { // Server sleep(10); echo "Done."; } ?></code></div> </div> </div> <div class="note" id="125490"> <div class="votes"> <div id="Vu125490"> <a href="/manual/vote-note.php?id=125490&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd125490"> <a href="/manual/vote-note.php?id=125490&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V125490" title="80% like this..."> 3 </div> </div> <a href="#125490" class="name"> qwertz182</a><a class="genanchor" href="#125490"> ¶</a><div class="date" title="2020-11-06 11:18">4 years ago</div> <div class="text" id="Hcom125490"> <div class="phpcode"><code>As the "example #2 Uploading file" says it is deprecated as of PHP 5.5.0 but doesn't tell you how it's done right, here is a really easy example using the CURLFile class: <?php $request = [ 'firstName' => 'John', 'lastName' => 'Doe', 'file' => new CURLFile('example.txt', 'text/plain') // or use curl_file_create() ]; $curlOptions = [ CURLOPT_URL => '<a href="http://example.com/upload.php" rel="nofollow" target="_blank">http://example.com/upload.php</a>', CURLOPT_POST => true, CURLOPT_HEADER => false, CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $request, ]; $ch = curl_init(); curl_setopt_array($ch, $curlOptions); $response = curl_exec($ch); ?> This is just like posting a html form with an input[type=file] field. The result on windows could look like this: <?php // $_POST Array ( [firstName] => John [lastName] => Doe ) // $_FILES Array ( [file] => Array ( [name] => example.txt [type] => text/plain [tmp_name] => C:\wamp64\tmp\php3016.tmp [error] => 0 [size] => 14 ) ) ?> Since the request is an array (and not a string), curl will automatically encode the data as "multipart/form-data". Please be aware that if you pass an invalid file path to CURLFile, setting the CURLOPT_POSTFIELDS option will fail. So if you are using curl_setopt_array for setting the options at once, according to the manual, "If an option could not be successfully set, FALSE is immediately returned, ignoring any future options in the options array.". So you should make sure that the file exists or set CURLOPT_POSTFIELDS with curl_setopt() and check if it returns false and act accordingly.</code></div> </div> </div> <div class="note" id="82418"> <div class="votes"> <div id="Vu82418"> <a href="/manual/vote-note.php?id=82418&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd82418"> <a href="/manual/vote-note.php?id=82418&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V82418" title="76% like this..."> 28 </div> </div> <a href="#82418" class="name"> sgamon at yahoo dot com</a><a class="genanchor" href="#82418"> ¶</a><div class="date" title="2008-04-09 05:55">16 years ago</div> <div class="text" id="Hcom82418"> <div class="phpcode"><code>If you are doing a POST, and the content length is 1,025 or greater, then curl exploits a feature of http 1.1: 100 (Continue) Status. See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html#sec8.2.3" rel="nofollow" target="_blank">http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html#sec8.2.3</a> * it adds a header, "Expect: 100-continue". * it then sends the request head, waits for a 100 response code, then sends the content Not all web servers support this though. Various errors are returned depending on the server. If this happens to you, suppress the "Expect" header with this command: <?php curl_setopt($ch, CURLOPT_HTTPHEADER, array('Expect:')); ?> See <a href="http://www.gnegg.ch/2007/02/the-return-of-except-100-continue/" rel="nofollow" target="_blank">http://www.gnegg.ch/2007/02/the-return-of-except-100-continue/</a></code></div> </div> </div> <div class="note" id="66832"> <div class="votes"> <div id="Vu66832"> <a href="/manual/vote-note.php?id=66832&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd66832"> <a href="/manual/vote-note.php?id=66832&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V66832" title="76% like this..."> 30 </div> </div> <a href="#66832" class="name"> Philippe dot Jausions at 11abacus dot com</a><a class="genanchor" href="#66832"> ¶</a><div class="date" title="2006-05-30 11:31">18 years ago</div> <div class="text" id="Hcom66832"> <div class="phpcode"><code>Clarification on the callback methods: - CURLOPT_HEADERFUNCTION is for handling header lines received *in the response*, - CURLOPT_WRITEFUNCTION is for handling data received *from the response*, - CURLOPT_READFUNCTION is for handling data passed along *in the request*. The callback "string" can be any callable function, that includes the array(&$obj, 'someMethodName') format. -Philippe</code></div> </div> </div> <div class="note" id="98491"> <div class="votes"> <div id="Vu98491"> <a href="/manual/vote-note.php?id=98491&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd98491"> <a href="/manual/vote-note.php?id=98491&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V98491" title="79% like this..."> 14 </div> </div> <a href="#98491" class="name"> JScott jscott401 at gmail dot com</a><a class="genanchor" href="#98491"> ¶</a><div class="date" title="2010-06-18 07:29">14 years ago</div> <div class="text" id="Hcom98491"> <div class="phpcode"><code>Some additional notes for curlopt_writefunction. I struggled with this at first because it really isn't documented very well. When you write a callback function and use it with curlopt_writefunction it will be called MULTIPLE times. Your function MUST return the ammount of data written to it each time. It is very picky about this. Here is a snippet from my code that may help you <?php curl_setopt($this->curl_handle, CURLOPT_WRITEFUNCTION, array($this, "receiveResponse")); // later on in the class I wrote my receive Response method private function receiveResponse($curlHandle,$xmldata) { $this->responseString = $xmldata; $this->responseXML .= $this->responseString; $this->length = strlen($xmldata); $this->size += $this->length; return $this->length; } ?> Now I did this for a class. If you aren't doing OOP then you will obviously need to modify this for your own use. CURL calls your script MULTIPLE times because the data will not always be sent all at once. Were talking internet here so its broken up into packets. You need to take your data and concatenate it all together until it is all written. I was about to pull my damn hair out because I would get broken chunks of XML back from the server and at random lengths. I finally figured out what was going on. Hope this helps</code></div> </div> </div> <div class="note" id="121874"> <div class="votes"> <div id="Vu121874"> <a href="/manual/vote-note.php?id=121874&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd121874"> <a href="/manual/vote-note.php?id=121874&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V121874" title="80% like this..."> 3 </div> </div> <a href="#121874" class="name"> cmatiasvillanueva at gmail dot com</a><a class="genanchor" href="#121874"> ¶</a><div class="date" title="2017-11-15 07:54">7 years ago</div> <div class="text" id="Hcom121874"> <div class="phpcode"><code>What is not mentioned in the documentation is that if you want to set a local-port or local-port-range to establish a connection is possible by adding CURLOPT_LOCALPORT and CURLOPT_LOCALPORTRANGE options. Ex: $conn=curl_init ('example.com'); curl_setopt($conn, CURLOPT_LOCALPORT, 35000); curl_setopt($conn, CURLOPT_LOCALPORTRANGE, 200); CURLOPT_LOCALPORT: This sets the local port number of the socket used for the connection. CURLOPT_LOCALPORTRANGE: The range argument is the number of attempts libcurl will make to find a working local port number. It starts with the given CURLOPT_LOCALPORT and adds one to the number for each retry. Setting this option to 1 or below will make libcurl do only one try for the exact port number. Interface can be also configured using CURLOPT_INTERFACE: Ex: curl_setopt($conn, CURLOPT_INTERFACE, "eth1");</code></div> </div> </div> <div class="note" id="108137"> <div class="votes"> <div id="Vu108137"> <a href="/manual/vote-note.php?id=108137&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd108137"> <a href="/manual/vote-note.php?id=108137&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V108137" title="80% like this..."> 6 </div> </div> <a href="#108137" class="name"> mw+php dot net at lw-systems dot de</a><a class="genanchor" href="#108137"> ¶</a><div class="date" title="2012-03-31 06:45">12 years ago</div> <div class="text" id="Hcom108137"> <div class="phpcode"><code>The description of the use of the CURLOPT_POSTFIELDS option should be emphasize, that using POST with HTTP/1.1 with cURL implies the use of a "Expect: 100-continue" header. Some web servers will not understand the handling of chunked transfer of post data. To disable this behavior one must disable the use of the "Expect:" header with curl_setopt($ch, CURLOPT_HTTPHEADER,array("Expect:"));</code></div> </div> </div> <div class="note" id="96056"> <div class="votes"> <div id="Vu96056"> <a href="/manual/vote-note.php?id=96056&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd96056"> <a href="/manual/vote-note.php?id=96056&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V96056" title="74% like this..."> 37 </div> </div> <a href="#96056" class="name"> Ed Cradock</a><a class="genanchor" href="#96056"> ¶</a><div class="date" title="2010-02-05 10:47">15 years ago</div> <div class="text" id="Hcom96056"> <div class="phpcode"><code>PUT requests are very simple, just make sure to specify a content-length header and set post fields as a string. Example: <?php function doPut($url, $fields) { $fields = (is_array($fields)) ? http_build_query($fields) : $fields; if($ch = curl_init($url)) { curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Length: ' . strlen($fields))); curl_setopt($ch, CURLOPT_POSTFIELDS, $fields); curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); return (int) $status; } else { return false; } } if(doPut('<a href="http://example.com/api/a/b/c" rel="nofollow" target="_blank">http://example.com/api/a/b/c</a>', array('foo' => 'bar')) == 200) // do something else // do something else. ?> You can grab the request data on the other side with: <?php if($_SERVER['REQUEST_METHOD'] == 'PUT') { parse_str(file_get_contents('php://input'), $requestData); // Array ( [foo] => bar ) print_r($requestData); // Do something with data... } ?> DELETE can be done in exactly the same way.</code></div> </div> </div> <div class="note" id="91978"> <div class="votes"> <div id="Vu91978"> <a href="/manual/vote-note.php?id=91978&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd91978"> <a href="/manual/vote-note.php?id=91978&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V91978" title="80% like this..."> 6 </div> </div> <a href="#91978" class="name"> Victor Jerlin</a><a class="genanchor" href="#91978"> ¶</a><div class="date" title="2009-07-03 04:12">15 years ago</div> <div class="text" id="Hcom91978"> <div class="phpcode"><code>Seems like some options not mentioned on this page, but listed on <a href="http://curl.haxx.se/libcurl/c/curl_easy_setopt.html" rel="nofollow" target="_blank">http://curl.haxx.se/libcurl/c/curl_easy_setopt.html</a> is actually supported. I was happy to see that I could actually use CURLOPT_FTP_CREATE_MISSING_DIRS even from PHP.</code></div> </div> </div> <div class="note" id="30906"> <div class="votes"> <div id="Vu30906"> <a href="/manual/vote-note.php?id=30906&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd30906"> <a href="/manual/vote-note.php?id=30906&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V30906" title="76% like this..."> 14 </div> </div> <a href="#30906" class="name"> dweingart at pobox dot com</a><a class="genanchor" href="#30906"> ¶</a><div class="date" title="2003-04-02 03:08">21 years ago</div> <div class="text" id="Hcom30906"> <div class="phpcode"><code>If you want to Curl to follow redirects and you would also like Curl to echo back any cookies that are set in the process, use this: <?php curl_setopt($ch, CURLOPT_COOKIEJAR, '-'); ?> '-' means stdout -dw</code></div> </div> </div> <div class="note" id="26797"> <div class="votes"> <div id="Vu26797"> <a href="/manual/vote-note.php?id=26797&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd26797"> <a href="/manual/vote-note.php?id=26797&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V26797" title="75% like this..."> 15 </div> </div> <a href="#26797" class="name"> yann dot corno at free dot fr</a><a class="genanchor" href="#26797"> ¶</a><div class="date" title="2002-11-13 04:19">22 years ago</div> <div class="text" id="Hcom26797"> <div class="phpcode"><code>About the CURLOPT_HTTPHEADER option, it took me some time to figure out how to format the so-called 'Array'. It fact, it is a list of strings. If Curl was already defining a header item, yours will replace it. Here is an example to change the Content Type in a POST: <?php curl_setopt ($ch, CURLOPT_HTTPHEADER, Array("Content-Type: text/xml")); ?> Yann</code></div> </div> </div> <div class="note" id="61395"> <div class="votes"> <div id="Vu61395"> <a href="/manual/vote-note.php?id=61395&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd61395"> <a href="/manual/vote-note.php?id=61395&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V61395" title="75% like this..."> 16 </div> </div> <a href="#61395" class="name"> luca dot manzo at bbsitalia dot com</a><a class="genanchor" href="#61395"> ¶</a><div class="date" title="2006-02-02 03:55">19 years ago</div> <div class="text" id="Hcom61395"> <div class="phpcode"><code>If you're getting trouble with cookie handling in curl: - curl manages tranparently cookies in a single curl session - the option <?php curl_setopt($ch, CURLOPT_COOKIEJAR, "/tmp/cookieFileName"); ?> makes curl to store the cookies in a file at the and of the curl session - the option <?php curl_setopt($ch, CURLOPT_COOKIEFILE, "/tmp/cookieFileName"); ?> makes curl to use the given file as source for the cookies to send to the server. so to handle correctly cookies between different curl session, the you have to do something like this: <?php $ch = curl_init(); curl_setopt ($ch, CURLOPT_URL, $url); curl_setopt ($ch, CURLOPT_COOKIEJAR, COOKIE_FILE_PATH); curl_setopt ($ch, CURLOPT_COOKIEFILE, COOKIE_FILE_PATH); curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1); $result = curl_exec ($ch); curl_close($ch); return $result; ?> in particular this is NECESSARY if you are using PEAR_SOAP libraries to build a webservice client over https and the remote server need to establish a session cookie. in fact each soap message is sent using a different curl session!! I hope this can help someone Luca</code></div> </div> </div> <div class="note" id="113682"> <div class="votes"> <div id="Vu113682"> <a href="/manual/vote-note.php?id=113682&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd113682"> <a href="/manual/vote-note.php?id=113682&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V113682" title="72% like this..."> 15 </div> </div> <a href="#113682" class="name"> badman</a><a class="genanchor" href="#113682"> ¶</a><div class="date" title="2013-11-15 10:36">11 years ago</div> <div class="text" id="Hcom113682"> <div class="phpcode"><code>Many hosters use PHP safe_mode or/and open_basedir, so you can't use CURLOPT_FOLLOWLOCATION. If you try, you see message like this: CURLOPT_FOLLOWLOCATION cannot be activated when safe_mode is enabled or an open_basedir is set in [you script name & path] on line XXX First, I try to use zsalab function (<a href="http://us2.php.net/manual/en/function.curl-setopt.php#102121" rel="nofollow" target="_blank">http://us2.php.net/manual/en/function.curl-setopt.php#102121</a>) from this page, but for some reason it did not work properly. So, I wrote my own. It can be use instead of curl_exec. If server HTTP response codes is 30x, function will forward the request as long as the response is not different from 30x (for example, 200 Ok). Also you can use POST. function curlExec(/* Array */$curlOptions='', /* Array */$curlHeaders='', /* Array */$postFields='') { $newUrl = ''; $maxRedirection = 10; do { if ($maxRedirection<1) die('Error: reached the limit of redirections'); $ch = curl_init(); if (!empty($curlOptions)) curl_setopt_array($ch, $curlOptions); if (!empty($curlHeaders)) curl_setopt($ch, CURLOPT_HTTPHEADER, $curlHeaders); if (!empty($postFields)) { curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields); } if (!empty($newUrl)) curl_setopt($ch, CURLOPT_URL, $newUrl); // redirect needed $curlResult = curl_exec($ch); $code = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($code == 301 || $code == 302 || $code == 303 || $code == 307) { preg_match('/Location:(.*?)\n/', $curlResult, $matches); $newUrl = trim(array_pop($matches)); curl_close($ch); $maxRedirection--; continue; } else // no more redirection { $code = 0; curl_close($ch); } } while($code); return $curlResult; }</code></div> </div> </div> <div class="note" id="93686"> <div class="votes"> <div id="Vu93686"> <a href="/manual/vote-note.php?id=93686&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd93686"> <a href="/manual/vote-note.php?id=93686&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V93686" title="72% like this..."> 17 </div> </div> <a href="#93686" class="name"> Chris at PureFormSolutions dot com</a><a class="genanchor" href="#93686"> ¶</a><div class="date" title="2009-09-22 03:54">15 years ago</div> <div class="text" id="Hcom93686"> <div class="phpcode"><code>I've found that setting CURLOPT_HTTPHEADER more than once will clear out any headers you've set previously with CURLOPT_HTTPHEADER. Consider the following: <?php # ... curl_setopt($cURL,CURLOPT_HTTPHEADER,array ( "Content-Type: text/xml; charset=utf-8", "Expect: 100-continue" )); # ... do some other stuff ... curl_setopt($cURL,CURLOPT_HTTPHEADER,array ( "Accept: application/json" )); # ... ?> Both the Content-Type and Expect I set will not be in the outgoing headers, but Accept will.</code></div> </div> </div> <div class="note" id="108333"> <div class="votes"> <div id="Vu108333"> <a href="/manual/vote-note.php?id=108333&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd108333"> <a href="/manual/vote-note.php?id=108333&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V108333" title="75% like this..."> 4 </div> </div> <a href="#108333" class="name"> Joey Hewitt</a><a class="genanchor" href="#108333"> ¶</a><div class="date" title="2012-04-17 10:52">12 years ago</div> <div class="text" id="Hcom108333"> <div class="phpcode"><code>Note that if you put a certificate chain in a PEM file, the certificates need to be ordered so that each certificate is followed by its issuer (i.e., root last.) Source: <a href="http://publib.boulder.ibm.com/tividd/td/ITIM/SC32-1493-00/en_US/HTML/im451_config09.htm" rel="nofollow" target="_blank">http://publib.boulder.ibm.com/tividd/td/ITIM/SC32-1493-00/en_US/HTML/im451_config09.htm</a></code></div> </div> </div> <div class="note" id="118586"> <div class="votes"> <div id="Vu118586"> <a href="/manual/vote-note.php?id=118586&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd118586"> <a href="/manual/vote-note.php?id=118586&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V118586" title="71% like this..."> 14 </div> </div> <a href="#118586" class="name"> joelhy</a><a class="genanchor" href="#118586"> ¶</a><div class="date" title="2016-01-04 10:19">9 years ago</div> <div class="text" id="Hcom118586"> <div class="phpcode"><code>Please notice that CURLINFO_HEADER_OUT and CURLOPT_VERBOSE option does not work together: "When CURLINFO_HEADER_OUT is set to TRUE than CURLOPT_VERBOSE does not work."(from <a href="https://bugs.php.net/bug.php?id=65348" rel="nofollow" target="_blank">https://bugs.php.net/bug.php?id=65348</a>). This took me an hour or two to figure it out.</code></div> </div> </div> <div class="note" id="99082"> <div class="votes"> <div id="Vu99082"> <a href="/manual/vote-note.php?id=99082&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd99082"> <a href="/manual/vote-note.php?id=99082&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V99082" title="70% like this..."> 23 </div> </div> <a href="#99082" class="name"> joeterranova at gmail dot com</a><a class="genanchor" href="#99082"> ¶</a><div class="date" title="2010-07-26 12:57">14 years ago</div> <div class="text" id="Hcom99082"> <div class="phpcode"><code>It appears that setting CURLOPT_FILE before setting CURLOPT_RETURNTRANSFER doesn't work, presumably because CURLOPT_FILE depends on CURLOPT_RETURNTRANSFER being set. So do this: <?php curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_FILE, $fp); ?> not this: <?php curl_setopt($ch, CURLOPT_FILE, $fp); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); ?></code></div> </div> </div> <div class="note" id="116866"> <div class="votes"> <div id="Vu116866"> <a href="/manual/vote-note.php?id=116866&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd116866"> <a href="/manual/vote-note.php?id=116866&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V116866" title="72% like this..."> 8 </div> </div> <a href="#116866" class="name"> jancister at gmail dot com</a><a class="genanchor" href="#116866"> ¶</a><div class="date" title="2015-03-12 04:09">9 years ago</div> <div class="text" id="Hcom116866"> <div class="phpcode"><code>Please note that if you want to handle progress using CURLOPT_PROGRESSFUNCTION option, you need to take into consideration what version of PHP are you using. Since version 5.5.0, compatibility-breaking change was introduced in number/order of the arguments passed to the callback function, and cURL resource is now passed as first argument. Prior to version 5.5.0: <?php // ... curl_setopt($resource, CURLOPT_PROGRESSFUNCTION, 'progressCallback'); curl_setopt($resource, CURLOPT_NOPROGRESS, false); // ... function progressCallback($download_size = 0, $downloaded = 0, $upload_size = 0, $uploaded = 0) { // Handle progress } ?> From version 5.5.0: <?php // ... curl_setopt($resource, CURLOPT_PROGRESSFUNCTION, 'progressCallback'); curl_setopt($resource, CURLOPT_NOPROGRESS, false); // ... function progressCallback($resource, $download_size = 0, $downloaded = 0, $upload_size = 0, $uploaded = 0) { // Handle progress } ?> However, if your code needs to be compatible with PHP version both before and after 5.5.0, consider adding a version check: <?php // ... curl_setopt($resource, CURLOPT_PROGRESSFUNCTION, 'progressCallback'); curl_setopt($resource, CURLOPT_NOPROGRESS, false); // ... function progressCallback($resource, $download_size = 0, $downloaded = 0, $upload_size = 0, $uploaded = 0) { /** * $resource parameter was added in version 5.5.0 breaking backwards compatibility; * if we are using PHP version lower than 5.5.0, we need to shift the arguments * @see <a href="http://php.net/manual/en/function.curl-setopt.php#refsect1-function.curl-setopt-changelog" rel="nofollow" target="_blank">http://php.net/manual/en/function.curl-setopt.php#refsect1-function.curl-setopt-changelog</a> */ if (version_compare(PHP_VERSION, '5.5.0') < 0) { $uploaded = $upload_size; $upload_size = $downloaded; $downloaded = $download_size; $download_size = $resource; } // Handle progress } ?></code></div> </div> </div> <div class="note" id="80271"> <div class="votes"> <div id="Vu80271"> <a href="/manual/vote-note.php?id=80271&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd80271"> <a href="/manual/vote-note.php?id=80271&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V80271" title="68% like this..."> 32 </div> </div> <a href="#80271" class="name"> jade dot skaggs at gmail dot com</a><a class="genanchor" href="#80271"> ¶</a><div class="date" title="2008-01-07 09:48">17 years ago</div> <div class="text" id="Hcom80271"> <div class="phpcode"><code>After much struggling, I managed to get a SOAP request requiring HTTP authentication to work. Here's some source that will hopefully be useful to others. <?php $credentials = "username:password"; // Read the XML to send to the Web Service $request_file = "./SampleRequest.xml"; $fh = fopen($request_file, 'r'); $xml_data = fread($fh, filesize($request_file)); fclose($fh); $url = "<a href="http://www.example.com/services/calculation" rel="nofollow" target="_blank">http://www.example.com/services/calculation</a>"; $page = "/services/calculation"; $headers = array( "POST ".$page." HTTP/1.0", "Content-type: text/xml;charset=\"utf-8\"", "Accept: text/xml", "Cache-Control: no-cache", "Pragma: no-cache", "SOAPAction: \"run\"", "Content-length: ".strlen($xml_data), "Authorization: Basic " . base64_encode($credentials) ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL,$url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_TIMEOUT, 60); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_USERAGENT, $defined_vars['HTTP_USER_AGENT']); // Apply the XML to our curl call curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $xml_data); $data = curl_exec($ch); if (curl_errno($ch)) { print "Error: " . curl_error($ch); } else { // Show me the result var_dump($data); curl_close($ch); } ?></code></div> </div> </div> <div class="note" id="123340"> <div class="votes"> <div id="Vu123340"> <a href="/manual/vote-note.php?id=123340&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd123340"> <a href="/manual/vote-note.php?id=123340&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V123340" title="71% like this..."> 3 </div> </div> <a href="#123340" class="name"> eric dot van dot eldik at peercode dot nl</a><a class="genanchor" href="#123340"> ¶</a><div class="date" title="2018-11-13 01:21">6 years ago</div> <div class="text" id="Hcom123340"> <div class="phpcode"><code>When you get this error using a PUT request: "SSL read: error:00000000:lib(0):func(0):reason(0), errno 104") It could be caused by: <?php curl_setopt($ch, CURLOPT_PUT, TRUE); ?> Instead try: <?php curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT"); ?></code></div> </div> </div> <div class="note" id="59993"> <div class="votes"> <div id="Vu59993"> <a href="/manual/vote-note.php?id=59993&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd59993"> <a href="/manual/vote-note.php?id=59993&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V59993" title="72% like this..."> 5 </div> </div> <a href="#59993" class="name"> skyogre __at__ yandex __dot__ ru</a><a class="genanchor" href="#59993"> ¶</a><div class="date" title="2005-12-22 02:13">19 years ago</div> <div class="text" id="Hcom59993"> <div class="phpcode"><code>There is really a problem of transmitting $_POST data with curl in php 4+ at least. I improved the encoding function by Alejandro Moreno to work properly with mulltidimensional arrays. <?php function data_encode($data, $keyprefix = "", $keypostfix = "") { assert( is_array($data) ); $vars=null; foreach($data as $key=>$value) { if(is_array($value)) $vars .= data_encode($value, $keyprefix.$key.$keypostfix.urlencode("["), urlencode("]")); else $vars .= $keyprefix.$key.$keypostfix."=".urlencode($value)."&"; } return $vars; } curl_setopt($ch, CURLOPT_POSTFIELDS, substr(data_encode($_POST), 0, -1) ); ?></code></div> </div> </div> <div class="note" id="87341"> <div class="votes"> <div id="Vu87341"> <a href="/manual/vote-note.php?id=87341&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd87341"> <a href="/manual/vote-note.php?id=87341&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V87341" title="71% like this..."> 9 </div> </div> <a href="#87341" class="name"> fnjordy at gmail dot com</a><a class="genanchor" href="#87341"> ¶</a><div class="date" title="2008-11-30 11:28">16 years ago</div> <div class="text" id="Hcom87341"> <div class="phpcode"><code>Note that CURLOPT_RETURNTRANSFER when used with CURLOPT_WRITEFUNCTION has effectively three settings: default, true, and false. default - callbacks will be called as expected. true - content will be returned but callback function will not be called. false - content will be output and callback function will not be called. Note that CURLOPT_HEADERFUNCTION callbacks are always called.</code></div> </div> </div> <div class="note" id="110162"> <div class="votes"> <div id="Vu110162"> <a href="/manual/vote-note.php?id=110162&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd110162"> <a href="/manual/vote-note.php?id=110162&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V110162" title="71% like this..."> 3 </div> </div> <a href="#110162" class="name"> juozaspo at gmail dot com</a><a class="genanchor" href="#110162"> ¶</a><div class="date" title="2012-09-25 08:47">12 years ago</div> <div class="text" id="Hcom110162"> <div class="phpcode"><code>I've created an example that gets the file on url passed to script and outputs it to the browser. <?php //get the file (e.g. image) and output it to the browser $ch = curl_init(); //open curl handle curl_setopt($ch, CURLOPT_URL, $_GET['url']); //set an url curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); //do not output directly, use variable curl_setopt($ch, CURLOPT_BINARYTRANSFER, 1); //do a binary transfer curl_setopt($ch, CURLOPT_FAILONERROR, 1); //stop if an error occurred $file=curl_exec($ch); //store the content in variable if(!curl_errno($ch)) { //send out headers and output header ("Content-type: ".curl_getinfo($ch, CURLINFO_CONTENT_TYPE).""); header ("Content-Length: ".curl_getinfo($ch, CURLINFO_CONTENT_LENGTH_DOWNLOAD).""); echo $file; } else echo 'Curl error: ' . curl_error($ch); curl_close($ch); //close curl handle ?> p.s. Make sure that there're no new lines before and after code or script may not work.</code></div> </div> </div> <div class="note" id="96903"> <div class="votes"> <div id="Vu96903"> <a href="/manual/vote-note.php?id=96903&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd96903"> <a href="/manual/vote-note.php?id=96903&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V96903" title="70% like this..."> 8 </div> </div> <a href="#96903" class="name"> anderseta at gmail dot com</a><a class="genanchor" href="#96903"> ¶</a><div class="date" title="2010-03-22 02:48">14 years ago</div> <div class="text" id="Hcom96903"> <div class="phpcode"><code>If you wish to find the size of the file you are streaming and use it as your header this is how: <?php function write_function($curl_resource, $string) { if(curl_getinfo($curl_resource, CURLINFO_SIZE_DOWNLOAD) <= 2000) { header('Expires: 0'); header('Cache-Control: must-revalidate, post-check=0, pre-check=0'); header('Pragma: public'); header('Content-Description: File Transfer'); header("Content-Transfer-Encoding: binary"); header("Content-Type: ".curl_getinfo($curl_resource, CURLINFO_CONTENT_TYPE).""); header("Content-Length: ".curl_getinfo($curl_resource, CURLINFO_CONTENT_LENGTH_DOWNLOAD).""); } print $string; return mb_strlen($string, '8bit'); } ?> 1440 is the the default number of bytes curl will call the write function (BUFFERSIZE does not affect this, i actually think you can not change this value), so it means the headers are going to be set only one time. write_function must return the exact number of bytes of the string, so you can return a value with mb_strlen.</code></div> </div> </div> <div class="note" id="60142"> <div class="votes"> <div id="Vu60142"> <a href="/manual/vote-note.php?id=60142&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd60142"> <a href="/manual/vote-note.php?id=60142&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V60142" title="70% like this..."> 7 </div> </div> <a href="#60142" class="name"> Dustin Hawkins</a><a class="genanchor" href="#60142"> ¶</a><div class="date" title="2005-12-27 02:24">19 years ago</div> <div class="text" id="Hcom60142"> <div class="phpcode"><code>To further expand upon use of CURLOPT_CAPATH and CURLOPT_CAINFO... In my case I wanted to prevent curl from talking to any HTTPS server except my own using a self signed certificate. To do this, you'll need openssl installed and access to the HTTPS Server Certificate (server.crt by default on apache) You can then use a command simiar to this to translate your apache certificate into one that curl likes. $ openssl x509 -in server.crt -out outcert.pem -text Then set CURLOPT_CAINFO equal to the the full path to outcert.pem and turn on CURLOPT_SSL_VERIFYPEER. If you want to use the CURLOPT_CAPATH option, you should create a directory for all the valid certificates you have created, then use the c_rehash script that is included with openssl to "prepare" the directory. If you dont use the c_rehash utility, curl will ignore any file in the directory you set.</code></div> </div> </div> <div class="note" id="87112"> <div class="votes"> <div id="Vu87112"> <a href="/manual/vote-note.php?id=87112&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd87112"> <a href="/manual/vote-note.php?id=87112&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V87112" title="68% like this..."> 14 </div> </div> <a href="#87112" class="name"> saidk at phirebranding dot com</a><a class="genanchor" href="#87112"> ¶</a><div class="date" title="2008-11-19 01:31">16 years ago</div> <div class="text" id="Hcom87112"> <div class="phpcode"><code>Passing in PHP's $_SESSION into your cURL call: <?php session_start(); $strCookie = 'PHPSESSID=' . $_COOKIE['PHPSESSID'] . '; path=/'; session_write_close(); $curl_handle = curl_init('enter_external_url_here'); curl_setopt( $curl_handle, CURLOPT_COOKIE, $strCookie ); curl_exec($curl_handle); curl_close($curl_handle); ?> This worked great for me. I was calling pages from the same server and needed to keep the $_SESSION variables. This passes them over. If you want to test, just print_r($_SESSION); Enjoy!</code></div> </div> </div> <div class="note" id="114475"> <div class="votes"> <div id="Vu114475"> <a href="/manual/vote-note.php?id=114475&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd114475"> <a href="/manual/vote-note.php?id=114475&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V114475" title="69% like this..."> 5 </div> </div> <a href="#114475" class="name"> Martin K.</a><a class="genanchor" href="#114475"> ¶</a><div class="date" title="2014-02-24 05:36">10 years ago</div> <div class="text" id="Hcom114475"> <div class="phpcode"><code>If you only want to enable cookie handling and you don't need to save the cookies for a separate session, just set CURLOPT_COOKIEFILE to an empty string. I was given the advice to use php://memory but that did not seem to have the same effect. Although this is stated in the documentation I thought it was worth reiterating since it cause me so much trouble.</code></div> </div> </div> <div class="note" id="78046"> <div class="votes"> <div id="Vu78046"> <a href="/manual/vote-note.php?id=78046&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd78046"> <a href="/manual/vote-note.php?id=78046&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V78046" title="68% like this..."> 12 </div> </div> <a href="#78046" class="name"> Ojas Ojasvi</a><a class="genanchor" href="#78046"> ¶</a><div class="date" title="2007-09-25 10:52">17 years ago</div> <div class="text" id="Hcom78046"> <div class="phpcode"><code><?php /* * Author: Ojas Ojasvi * Released: September 25, 2007 * Description: An example of the disguise_curl() function in order to grab contents from a website while remaining fully camouflaged by using a fake user agent and fake headers. */ $url = '<a href="http://www.php.net" rel="nofollow" target="_blank">http://www.php.net</a>'; // disguises the curl using fake headers and a fake user agent. function disguise_curl($url) { $curl = curl_init(); // Setup headers - I used the same headers from Firefox version 2.0.0.6 // below was split up because php.net said the line was too long. :/ $header[0] = "Accept: text/xml,application/xml,application/xhtml+xml,"; $header[0] .= "text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5"; $header[] = "Cache-Control: max-age=0"; $header[] = "Connection: keep-alive"; $header[] = "Keep-Alive: 300"; $header[] = "Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7"; $header[] = "Accept-Language: en-us,en;q=0.5"; $header[] = "Pragma: "; // browsers keep this blank. curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_USERAGENT, 'Googlebot/2.1 (+<a href="http://www.google.com/bot.html" rel="nofollow" target="_blank">http://www.google.com/bot.html</a>)'); curl_setopt($curl, CURLOPT_HTTPHEADER, $header); curl_setopt($curl, CURLOPT_REFERER, '<a href="http://www.google.com" rel="nofollow" target="_blank">http://www.google.com</a>'); curl_setopt($curl, CURLOPT_ENCODING, 'gzip,deflate'); curl_setopt($curl, CURLOPT_AUTOREFERER, true); curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); curl_setopt($curl, CURLOPT_TIMEOUT, 10); $html = curl_exec($curl); // execute the curl command curl_close($curl); // close the connection return $html; // and finally, return $html } // uses the function and displays the text off the website $text = disguise_curl($url); echo $text; ?> Ojas Ojasvi</code></div> </div> </div> <div class="note" id="116223"> <div class="votes"> <div id="Vu116223"> <a href="/manual/vote-note.php?id=116223&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd116223"> <a href="/manual/vote-note.php?id=116223&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V116223" title="68% like this..."> 7 </div> </div> <a href="#116223" class="name"> Aaron Wells</a><a class="genanchor" href="#116223"> ¶</a><div class="date" title="2014-11-24 11:34">10 years ago</div> <div class="text" id="Hcom116223"> <div class="phpcode"><code>If you use cURL to fetch user-supplied URLs (for instance, in a web-based RSS aggregator), be aware of the risk of server-side request forgery (SSRF). This is an attack where the user takes advantage of the fact that cURL requests are sent from the web server itself, to reach network locations they wouldn't be able to reach from outside the network. For instance, they could enter a "<a href="http://localhost" rel="nofollow" target="_blank">http://localhost</a>" URL, and access things on the web server via "localhost". Or, "<a href="ftp://localhost" rel="nofollow" target="_blank">ftp://localhost</a>". cURL supports a lot of protocols! If you are using CURLOPT_FOLLOWLOCATION, the malicious URL could be in a redirect from the original request. cURL also will follow redirect headers to other protocols! (303 See Other; Location: <a href="ftp://localhost" rel="nofollow" target="_blank">ftp://localhost</a>). So if you're using cURL with user-supplied URLs, at the very least use CURLOPT_PROTOCOLS (which also sets CURLOPT_REDIR_PROTOCOLS), and either disable CURLOPT_FOLLOWLOCATION or use the "SafeCurl" library to safely follow redirects.</code></div> </div> </div> <div class="note" id="64447"> <div class="votes"> <div id="Vu64447"> <a href="/manual/vote-note.php?id=64447&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd64447"> <a href="/manual/vote-note.php?id=64447&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V64447" title="68% like this..."> 11 </div> </div> <a href="#64447" class="name"> mr at coder dot tv</a><a class="genanchor" href="#64447"> ¶</a><div class="date" title="2006-04-14 07:22">18 years ago</div> <div class="text" id="Hcom64447"> <div class="phpcode"><code>Sometimes you can't use CURLOPT_COOKIEJAR and CURLOPT_COOKIEFILE becoz of the server php-settings(They say u may grab any files from server using these options). Here is the solution 1)Don't use CURLOPT_FOLLOWLOCATION 2)Use curl_setopt($ch, CURLOPT_HEADER, 1) 3)Grab from the header cookies like this: preg_match_all('|Set-Cookie: (.*);|U', $content, $results); $cookies = implode(';', $results[1]); 4)Set them using curl_setopt($ch, CURLOPT_COOKIE, $cookies); Good Luck, Yevgen</code></div> </div> </div> <div class="note" id="103232"> <div class="votes"> <div id="Vu103232"> <a href="/manual/vote-note.php?id=103232&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd103232"> <a href="/manual/vote-note.php?id=103232&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V103232" title="66% like this..."> 10 </div> </div> <a href="#103232" class="name"> PHP at RHaworth dot net</a><a class="genanchor" href="#103232"> ¶</a><div class="date" title="2011-04-02 02:31">13 years ago</div> <div class="text" id="Hcom103232"> <div class="phpcode"><code>When CURLOPT_FOLLOWLOCATION and CURLOPT_HEADER are both true and redirect/s have happened then the header returned by curl_exec() will contain all the headers in the redirect chain in the order they were encountered.</code></div> </div> </div> <div class="note" id="102519"> <div class="votes"> <div id="Vu102519"> <a href="/manual/vote-note.php?id=102519&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd102519"> <a href="/manual/vote-note.php?id=102519&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V102519" title="66% like this..."> 8 </div> </div> <a href="#102519" class="name"> S\</a><a class="genanchor" href="#102519"> ¶</a><div class="date" title="2011-02-18 11:04">13 years ago</div> <div class="text" id="Hcom102519"> <div class="phpcode"><code>When using CURLOPT_POSTFIELDS with an array as parameter, you have to pay high attention to user input. Unvalidated user input will lead to serious security issues. <?php /** * test.php: */ $ch = curl_init('<a href="http://example.com" rel="nofollow" target="_blank">http://example.com</a>'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, array( 'foo' => $_GET['bar'] )); curl_exec($ch); ?> Requesting "test.php?bar=@/home/user/test.png" will send "test.png" to example.com. Make sure you remove the leading "@" from user input.</code></div> </div> </div> <div class="note" id="97383"> <div class="votes"> <div id="Vu97383"> <a href="/manual/vote-note.php?id=97383&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd97383"> <a href="/manual/vote-note.php?id=97383&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V97383" title="66% like this..."> 3 </div> </div> <a href="#97383" class="name"> clint at fewbar dot com</a><a class="genanchor" href="#97383"> ¶</a><div class="date" title="2010-04-16 02:56">14 years ago</div> <div class="text" id="Hcom97383"> <div class="phpcode"><code>If you have turned on conditional gets on a curl handle, and then for a subsequent request, you don't have a good setting for CURLOPT_TIMEVALUE , you can disable If-Modified-Since checking with: <?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $foo); curl_setopt($ch, CURLOPT_TIMEVALUE, filemtime($foo_path)); curl_setopt($ch, CURLOPT_TIMECONDITION, CURLOPT_TIMECOND_IFMODIFIEDSINCE); curl_exec($ch); // Reuse same curl handle curl_setopt($ch, CURLOPT_URL, $bar); curl_setopt($ch, CURLOPT_TIMEVALUE, null); // don't know mtime curl_setopt($ch, CURLOPT_TIMECONDITION, 0); // set it to 0, turns it off curl_exec($ch); ?></code></div> </div> </div> <div class="note" id="107146"> <div class="votes"> <div id="Vu107146"> <a href="/manual/vote-note.php?id=107146&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd107146"> <a href="/manual/vote-note.php?id=107146&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V107146" title="64% like this..."> 10 </div> </div> <a href="#107146" class="name"> Adam Monsen</a><a class="genanchor" href="#107146"> ¶</a><div class="date" title="2012-01-10 04:36">13 years ago</div> <div class="text" id="Hcom107146"> <div class="phpcode"><code>CURLOPT_POST must be left unset if you want the Content-Type header set to "multipart/form-data" (e.g., when CURLOPT_POSTFIELDS is an array). If you set CURLOPT_POSTFIELDS to an array and have CURLOPT_POST set to TRUE, Content-Length will be -1 and most sane servers will reject the request. If you set CURLOPT_POSTFIELDS to an array and have CURLOPT_POST set to FALSE, cURL will send a GET request.</code></div> </div> </div> <div class="note" id="121973"> <div class="votes"> <div id="Vu121973"> <a href="/manual/vote-note.php?id=121973&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd121973"> <a href="/manual/vote-note.php?id=121973&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V121973" title="64% like this..."> 5 </div> </div> <a href="#121973" class="name"> ohcc at 163 dot com</a><a class="genanchor" href="#121973"> ¶</a><div class="date" title="2017-12-04 02:59">7 years ago</div> <div class="text" id="Hcom121973"> <div class="phpcode"><code>This is howto upload an existing file to an FTP server with cURL in PHP. You should remember that CURLOPT_URL should contain the file's basename to save on the FTP server. For example, if you upload hello.txt to <a href="ftp://www.wuxiancheng.cn/text/," rel="nofollow" target="_blank">ftp://www.wuxiancheng.cn/text/,</a> CURLOPT_URL should be <a href="ftp://www.wuxiancheng.cn/text/hello.txt" rel="nofollow" target="_blank">ftp://www.wuxiancheng.cn/text/hello.txt</a> rather than <a href="ftp://www.wuxiancheng.cn/text/," rel="nofollow" target="_blank">ftp://www.wuxiancheng.cn/text/,</a> otherwise you will get an error message like "Uploading to a URL without a file name! " when you call curl_error(); <?php $ch = curl_init(); $filepath = 'D:\Web\www\wuxiancheng.cn\hello.txt'; $basename = pathInfo($filepath, PATHINFO_BASENAME); $filesize = fileSize($filepath); curl_setopt_array( $ch, array( CURLOPT_URL => '<a href="ftp://www.wuxiancheng.cn/text/" rel="nofollow" target="_blank">ftp://www.wuxiancheng.cn/text/</a>' . $basename, CURLOPT_USERPWD => 'USERNAME:PASSWORD', CURLOPT_PROTOCOLS => CURLPROTO_FTP, CURLOPT_UPLOAD => true, CURLOPT_INFILE => $filepath, CURLOPT_INFILESIZE => $filesize, CURLOPT_RETURNTRANSFER => true, CURLOPT_HEADER => false, ) ); curl_exec($ch); $message = curl_errno($ch) === CURLE_OK ? 'success' : 'failure'; echo $message; ?></code></div> </div> </div> <div class="note" id="95027"> <div class="votes"> <div id="Vu95027"> <a href="/manual/vote-note.php?id=95027&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd95027"> <a href="/manual/vote-note.php?id=95027&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V95027" title="65% like this..."> 7 </div> </div> <a href="#95027" class="name"> Pawel Antczak</a><a class="genanchor" href="#95027"> ¶</a><div class="date" title="2009-12-09 12:07">15 years ago</div> <div class="text" id="Hcom95027"> <div class="phpcode"><code>Hello. During problems with "CURLOPT_FOLLOWLOCATION cannot be activated when in safe_mode or an open_basedir is set" I was looking for solution. I've found few methods on this page, but none of them was good enough, so I made one. <?php function curl_redirect_exec($ch, &$redirects, $curlopt_header = false) { curl_setopt($ch, CURLOPT_HEADER, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $data = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($http_code == 301 || $http_code == 302) { list($header) = explode("\r\n\r\n", $data, 2); $matches = array(); preg_match('/(Location:|URI:)(.*?)\n/', $header, $matches); $url = trim(array_pop($matches)); $url_parsed = parse_url($url); if (isset($url_parsed)) { curl_setopt($ch, CURLOPT_URL, $url); $redirects++; return curl_redirect_exec($ch, $redirects); } } if ($curlopt_header) return $data; else { list(,$body) = explode("\r\n\r\n", $data, 2); return $body; } } ?> Main issue in existing functions was lack of information, how many redirects was done. This one will count it. First parameter as usual. Second should be already initialized integer, it will be incremented by number of done redirects. You can set CURLOPT_HEADER if You need it.</code></div> </div> </div> <div class="note" id="110442"> <div class="votes"> <div id="Vu110442"> <a href="/manual/vote-note.php?id=110442&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd110442"> <a href="/manual/vote-note.php?id=110442&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V110442" title="63% like this..."> 10 </div> </div> <a href="#110442" class="name"> regan dot corey at gmail dot com</a><a class="genanchor" href="#110442"> ¶</a><div class="date" title="2012-10-22 10:22">12 years ago</div> <div class="text" id="Hcom110442"> <div class="phpcode"><code>I spent a couple of days trying to POST a multi-dimensional array of form fields, including a file upload, to a remote server to update a product. Here are the breakthroughs that FINALLY allowed the script to run as desired. Firstly, the HTML form used input names like these: <input type="text" name="product[name]" /> <input type="text" name="product[cost]" /> <input type="file" name="product[thumbnail]" /> in conjunction with two other form inputs not part of the product array <input type="text" name="method" value="put" /> <input type="text" name="mode" /> I used several cURL options, but the only two (other than URL) that mattered were: curl_setopt($handle, CURLOPT_POST, true); curl_setopt($handle, CURLOPT_POSTFIELDS, $postfields); Pretty standard so far. Note: headers didn't need to be set, cURL automatically sets headers (like content-type: multipart/form-data; content-length...) when you pass an array into CURLOPT_POSTFIELDS. Note: even though this is supposed to be a PUT command through an HTTP POST form, no special PUT options needed to be passed natively through cURL. Options such as curl_setopt($handle, CURLOPT_HTTPHEADER, array('X-HTTP-Method-Override: PUT', 'Content-Length: ' . strlen($fields))); or curl_setopt($handle, CURLOPT_PUT, true); or curl_setopt($handle, CURLOPT_CUSTOMREQUEST, "PUT); were not needed to make the code work. The fields I wanted to pass through cURL were arranged into an array something like this: $postfields = array("method" => $_POST["method"], "mode" => $_POST["mode"], "product" => array("name" => $_POST["product"], "cost" => $_POST["product"]["cost"], "thumbnail" => "@{$_FILES["thumbnail"]["tmp_name"]};type={$_FILES["thumbnail"]["type"]}") ); -Notice how the @ precedes the temporary filename, this creates a link so PHP will upload/transfer an actual file instead of just the file name, which would happen if the @ isn't included. -Notice how I forcefully set the mime-type of the file to upload. I was having issues where images filetypes were defaulting to octet-stream instead of image/png or image/jpeg or whatever the type of the selected image. I then tried passing $postfields straight into curl_setopt($this->handle, CURLOPT_POSTFIELDS, $postfields); but it didn't work. I tried using http_build_query($postfields); but that didn't work properly either. In both cases either the file wouldn't be treated as an actual file and the form data wasn't being sent properly. The problem was HTTP's methods of transmitting arrays. While PHP and other languages can figure out how to handle arrays passed via forms, HTTP isn't quite as sofisticated. I had to rewrite the $postfields array like so: $postfields = array("method" => $_POST["method"], "mode" => $_POST["mode"], "product[name]" => $_POST["product"], "product[cost]" => $_POST["product"]["cost"], "product[thumbnail]" => "@{$_FILES["thumbnail"]["tmp_name"]}"); curl_setopt($handle, CURLOPT_POSTFIELDS, $postfields); This, without the use of http_build_query, solved all of my problems. Now the receiving host outputs both $_POST and $_FILES vars correctly.</code></div> </div> </div> <div class="note" id="102121"> <div class="votes"> <div id="Vu102121"> <a href="/manual/vote-note.php?id=102121&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd102121"> <a href="/manual/vote-note.php?id=102121&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V102121" title="64% like this..."> 8 </div> </div> <a href="#102121" class="name"> zsalab</a><a class="genanchor" href="#102121"> ¶</a><div class="date" title="2011-01-27 05:12">14 years ago</div> <div class="text" id="Hcom102121"> <div class="phpcode"><code>Handling redirections with curl if safe_mode or open_basedir is enabled. The function working transparent, no problem with header and returntransfer options. You can handle the max redirection with the optional second argument (the function is set the variable to zero if max redirection exceeded). Second parameter values: - maxredirect is null or not set: redirect maximum five time, after raise PHP warning - maxredirect is greather then zero: no raiser error, but parameter variable set to zero - maxredirect is less or equal zero: no follow redirections <?php function curl_exec_follow(/*resource*/ $ch, /*int*/ &$maxredirect = null) { $mr = $maxredirect === null ? 5 : intval($maxredirect); if (ini_get('open_basedir') == '' && ini_get('safe_mode' == 'Off')) { curl_setopt($ch, CURLOPT_FOLLOWLOCATION, $mr > 0); curl_setopt($ch, CURLOPT_MAXREDIRS, $mr); } else { curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false); if ($mr > 0) { $newurl = curl_getinfo($ch, CURLINFO_EFFECTIVE_URL); $rch = curl_copy_handle($ch); curl_setopt($rch, CURLOPT_HEADER, true); curl_setopt($rch, CURLOPT_NOBODY, true); curl_setopt($rch, CURLOPT_FORBID_REUSE, false); curl_setopt($rch, CURLOPT_RETURNTRANSFER, true); do { curl_setopt($rch, CURLOPT_URL, $newurl); $header = curl_exec($rch); if (curl_errno($rch)) { $code = 0; } else { $code = curl_getinfo($rch, CURLINFO_HTTP_CODE); if ($code == 301 || $code == 302) { preg_match('/Location:(.*?)\n/', $header, $matches); $newurl = trim(array_pop($matches)); } else { $code = 0; } } } while ($code && --$mr); curl_close($rch); if (!$mr) { if ($maxredirect === null) { trigger_error('Too many redirects. When following redirects, libcurl hit the maximum amount.', E_USER_WARNING); } else { $maxredirect = 0; } return false; } curl_setopt($ch, CURLOPT_URL, $newurl); } } return curl_exec($ch); } ?></code></div> </div> </div> <div class="note" id="81581"> <div class="votes"> <div id="Vu81581"> <a href="/manual/vote-note.php?id=81581&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd81581"> <a href="/manual/vote-note.php?id=81581&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V81581" title="64% like this..."> 8 </div> </div> <a href="#81581" class="name"> c00lways at gmail dot com</a><a class="genanchor" href="#81581"> ¶</a><div class="date" title="2008-03-04 01:16">16 years ago</div> <div class="text" id="Hcom81581"> <div class="phpcode"><code>if you would like to send xml request to a server (lets say, making a soap proxy), you have to set <?php curl_setopt($ch, CURLOPT_HTTPHEADER, Array("Content-Type: text/xml")); ?> makesure you watch for cache issue: the below code will prevent cache... <?php curl_setopt($ch, CURLOPT_FORBID_REUSE, 1); curl_setopt($ch, CURLOPT_FRESH_CONNECT, 1); ?> hope it helps ;)</code></div> </div> </div> <div class="note" id="84916"> <div class="votes"> <div id="Vu84916"> <a href="/manual/vote-note.php?id=84916&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd84916"> <a href="/manual/vote-note.php?id=84916&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V84916" title="64% like this..."> 5 </div> </div> <a href="#84916" class="name"> fred at themancan dot com</a><a class="genanchor" href="#84916"> ¶</a><div class="date" title="2008-08-05 04:28">16 years ago</div> <div class="text" id="Hcom84916"> <div class="phpcode"><code>To find what encoding a given HTTP POST request uses is easy -- passing an array to CURLOPT_POSTFIELDS results in multipart/form-data: <?php curl_setopt(CURLOPT_POSTFIELDS, array('field1' => 'value')); ?> Passing a URL-encoded string will result in application/x-www-form-urlencoded: <?php curl_setopt(CURLOPT_POSTFIELDS, array('field1=value&field2=value2')); ?> I ran across this when integrating with both a warehouse system and an email system; neither would accept multipart/form-data, but both happily accepted application/x-www-form-urlencoded.</code></div> </div> </div> <div class="note" id="101139"> <div class="votes"> <div id="Vu101139"> <a href="/manual/vote-note.php?id=101139&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd101139"> <a href="/manual/vote-note.php?id=101139&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V101139" title="64% like this..."> 4 </div> </div> <a href="#101139" class="name"> scy-phpmanual at scytale dot name</a><a class="genanchor" href="#101139"> ¶</a><div class="date" title="2010-11-29 04:01">14 years ago</div> <div class="text" id="Hcom101139"> <div class="phpcode"><code>In order to reset CURLOPT_HTTPHEADER, set it to array(). The cURL C API says you should set it to NULL, but that doesn’t work in the PHP wrapper.</code></div> </div> </div> <div class="note" id="93108"> <div class="votes"> <div id="Vu93108"> <a href="/manual/vote-note.php?id=93108&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd93108"> <a href="/manual/vote-note.php?id=93108&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V93108" title="63% like this..."> 6 </div> </div> <a href="#93108" class="name"> rob</a><a class="genanchor" href="#93108"> ¶</a><div class="date" title="2009-08-23 09:07">15 years ago</div> <div class="text" id="Hcom93108"> <div class="phpcode"><code>Whats not mentioned in the documentation is that you have to set CURLOPT_COOKIEJAR to a file for the CURL handle to actually use cookies, if it is not set then cookies will not be parsed.</code></div> </div> </div> <div class="note" id="42201"> <div class="votes"> <div id="Vu42201"> <a href="/manual/vote-note.php?id=42201&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd42201"> <a href="/manual/vote-note.php?id=42201&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V42201" title="62% like this..."> 4 </div> </div> <a href="#42201" class="name"> ron at ttvavanti dot nl</a><a class="genanchor" href="#42201"> ¶</a><div class="date" title="2004-05-07 08:00">20 years ago</div> <div class="text" id="Hcom42201"> <div class="phpcode"><code>If you specify a CAINFO, note that the file must be in PEM format! (If not, it won't work). Using Openssl you can use: openssl x509 -in <cert> -inform d -outform PEM -out cert.pem To create a pem formatted certificate from a binary certificate (the one you get if you download the ca somewhere).</code></div> </div> </div> <div class="note" id="83937"> <div class="votes"> <div id="Vu83937"> <a href="/manual/vote-note.php?id=83937&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd83937"> <a href="/manual/vote-note.php?id=83937&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V83937" title="61% like this..."> 3 </div> </div> <a href="#83937" class="name"> Salil Kothadia</a><a class="genanchor" href="#83937"> ¶</a><div class="date" title="2008-06-19 09:02">16 years ago</div> <div class="text" id="Hcom83937"> <div class="phpcode"><code>In PHP5, for the "CURLOPT_POSTFIELDS" option, we can use: <?php $ch = curl_init($URI); $Post = http_build_query($PostData); curl_setopt($ch, CURLOPT_POSTFIELDS, $Post); $Output = curl_exec($ch); curl_close($ch); ?></code></div> </div> </div> <div class="note" id="71313"> <div class="votes"> <div id="Vu71313"> <a href="/manual/vote-note.php?id=71313&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd71313"> <a href="/manual/vote-note.php?id=71313&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V71313" title="61% like this..."> 4 </div> </div> <a href="#71313" class="name"> eion at bigfoot dot com</a><a class="genanchor" href="#71313"> ¶</a><div class="date" title="2006-11-21 08:40">18 years ago</div> <div class="text" id="Hcom71313"> <div class="phpcode"><code>If you are trying to use CURLOPT_FOLLOWLOCATION and you get this warning: Warning: curl_setopt() [function.curl-setopt]: CURLOPT_FOLLOWLOCATION cannot be activated when in safe_mode or an open_basedir is set... then you will want to read <a href="http://www.php.net/ChangeLog-4.php" rel="nofollow" target="_blank">http://www.php.net/ChangeLog-4.php</a> which says "Disabled CURLOPT_FOLLOWLOCATION in curl when open_basedir or safe_mode are enabled." as of PHP 4.4.4/5.1.5. This is due to the fact that curl is not part of PHP and doesn't know the values of open_basedir or safe_mode, so you could comprimise your webserver operating in safe_mode by redirecting (using header('Location: ...')) to "file://" urls, which curl would have gladly retrieved. Until the curl extension is changed in PHP or curl (if it ever will) to deal with "Location:" headers, here is a far from perfect remake of the curl_exec function that I am using. Since there's no curl_getopt function equivalent, you'll have to tweak the function to make it work for your specific use. As it is here, it returns the body of the response and not the header. It also doesn't deal with redirection urls with username and passwords in them. <?php function curl_redir_exec($ch) { static $curl_loops = 0; static $curl_max_loops = 20; if ($curl_loops++ >= $curl_max_loops) { $curl_loops = 0; return FALSE; } curl_setopt($ch, CURLOPT_HEADER, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $data = curl_exec($ch); list($header, $data) = explode("\n\n", $data, 2); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($http_code == 301 || $http_code == 302) { $matches = array(); preg_match('/Location:(.*?)\n/', $header, $matches); $url = @parse_url(trim(array_pop($matches))); if (!$url) { //couldn't process the url to redirect to $curl_loops = 0; return $data; } $last_url = parse_url(curl_getinfo($ch, CURLINFO_EFFECTIVE_URL)); if (!$url['scheme']) $url['scheme'] = $last_url['scheme']; if (!$url['host']) $url['host'] = $last_url['host']; if (!$url['path']) $url['path'] = $last_url['path']; $new_url = $url['scheme'] . '://' . $url['host'] . $url['path'] . ($url['query']?'?'.$url['query']:''); curl_setopt($ch, CURLOPT_URL, $new_url); debug('Redirecting to', $new_url); return curl_redir_exec($ch); } else { $curl_loops=0; return $data; } } ?></code></div> </div> </div> <div class="note" id="120765"> <div class="votes"> <div id="Vu120765"> <a href="/manual/vote-note.php?id=120765&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd120765"> <a href="/manual/vote-note.php?id=120765&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V120765" title="58% like this..."> 3 </div> </div> <a href="#120765" class="name"> markandrewslade at gmail dot com</a><a class="genanchor" href="#120765"> ¶</a><div class="date" title="2017-03-07 03:22">7 years ago</div> <div class="text" id="Hcom120765"> <div class="phpcode"><code>Contrary to the documentation, CURLOPT_STDERR should be set to a handle to the file you want to write to, not the file's location.</code></div> </div> </div> <div class="note" id="108162"> <div class="votes"> <div id="Vu108162"> <a href="/manual/vote-note.php?id=108162&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd108162"> <a href="/manual/vote-note.php?id=108162&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V108162" title="58% like this..."> 3 </div> </div> <a href="#108162" class="name"> anonymous</a><a class="genanchor" href="#108162"> ¶</a><div class="date" title="2012-04-03 03:55">12 years ago</div> <div class="text" id="Hcom108162"> <div class="phpcode"><code>This may be not obvious, but if you specify the CURLOPT_POSTFIELDS and don't specify the CURLOPT_POST - it will still send POST, not GET (as you might think - since GET is default). So the line: curl_setopt($ch, CURLOPT_POSTFIELDS, $data); is synonym to: curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); Even if you set the options like this (in this order): curl_setopt($ch, CURLOPT_POST, 0); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); it will send POST, since CURLOPT_POSTFIELDS is latter. So if you want GET - make sure you don't have CURLOPT_POSTFIELDS specified somewhere.</code></div> </div> </div> <div class="note" id="53445"> <div class="votes"> <div id="Vu53445"> <a href="/manual/vote-note.php?id=53445&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd53445"> <a href="/manual/vote-note.php?id=53445&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V53445" title="60% like this..."> 2 </div> </div> <a href="#53445" class="name"> michaeledwards.com</a><a class="genanchor" href="#53445"> ¶</a><div class="date" title="2005-06-01 02:57">19 years ago</div> <div class="text" id="Hcom53445"> <div class="phpcode"><code>Problems can occur if you mix CURLOPT_URL with a 'Host:' header in CURLOPT_HEADERS on redirects because cURL will combine the host you explicitly stated in the 'Host:' header with the host from the Location: header of the redirect response. In short, don't do this: <?php $host = "www.example.com"; $url = "<a href="http://" rel="nofollow" target="_blank">http://</a>$host/"; $headers = array("Host: $host"); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); Do this instead: $host = "www.example.com"; $url = "<a href="http://" rel="nofollow" target="_blank">http://</a>$host/"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); ?></code></div> </div> </div> <div class="note" id="109634"> <div class="votes"> <div id="Vu109634"> <a href="/manual/vote-note.php?id=109634&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd109634"> <a href="/manual/vote-note.php?id=109634&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V109634" title="56% like this..."> 3 </div> </div> <a href="#109634" class="name"> qeremy [atta] gmail [dotta] com</a><a class="genanchor" href="#109634"> ¶</a><div class="date" title="2012-08-03 08:57">12 years ago</div> <div class="text" id="Hcom109634"> <div class="phpcode"><code>If you are trying to update something on your server and you need to handle this update operation by PUT; <?php curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT"); curl_setopt($ch, CURLOPT_PUT, 1); ?> are "useless" without; <?php curl_setopt($ch, CURLOPT_HTTPHEADER, array('X-HTTP-Method-Override: PUT')); ?> Example; Updating a book data in database identified by "id 1"; --cURL Part-- <?php $data = http_build_query($_POST); // or $data = http_build_query(array( 'name' => 'PHP in Action', 'price' => 10.9 )); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "<a href="http://api.localhost/rest/books/1" rel="nofollow" target="_blank">http://api.localhost/rest/books/1</a>"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT"); // no need anymore // or // curl_setopt($ch, CURLOPT_PUT, 1); // no need anymore curl_setopt($ch, CURLOPT_HTTPHEADER, array('X-HTTP-Method-Override: PUT')); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); $ce = curl_exec($ch); curl_close($ch); print_r($ce); ?> --API class-- <?php public function putAction() { echo "putAction() -> id: ". $this->_getParam('id') ."\n"; print_r($_POST); // do stuff with post data ... ?> --Output-- putAction() -> id: 15 Array ( [name] => PHP in Action [price] => 10.9 ) ---Keywords-- rest, restfull api, restfull put, curl put, curl customrequest put</code></div> </div> </div> <div class="note" id="102090"> <div class="votes"> <div id="Vu102090"> <a href="/manual/vote-note.php?id=102090&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd102090"> <a href="/manual/vote-note.php?id=102090&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V102090" title="57% like this..."> 1 </div> </div> <a href="#102090" class="name"> gskluzacek at gmail dot com</a><a class="genanchor" href="#102090"> ¶</a><div class="date" title="2011-01-26 01:42">14 years ago</div> <div class="text" id="Hcom102090"> <div class="phpcode"><code>FYI... unless you specifically set the user agent, no user agent will be sent in your request as there is no default value like some of the other options. As others have said, not sending a user agent may cause you to not get the results that you expected, e.g., 0 byte length content, different content, etc.</code></div> </div> </div> <div class="note" id="91510"> <div class="votes"> <div id="Vu91510"> <a href="/manual/vote-note.php?id=91510&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd91510"> <a href="/manual/vote-note.php?id=91510&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V91510" title="57% like this..."> 1 </div> </div> <a href="#91510" class="name"> Andrew</a><a class="genanchor" href="#91510"> ¶</a><div class="date" title="2009-06-14 04:56">15 years ago</div> <div class="text" id="Hcom91510"> <div class="phpcode"><code>I noticed that if you want to get current cookie file after curl_exec() - you need to close current curl handle (like it said in manual), but if you want cookies to be dumped to file after any curl_exec (without curl_close) you can: <?php #call it normally $ch = curl_init(); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_COOKIEFILE, "cookiefile"); curl_setopt($ch, CURLOPT_COOKIEJAR, "cookiefile"); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); curl_setopt($ch, CURLOPT_URL, '<a href="http://www.example.com/" rel="nofollow" target="_blank">http://www.example.com/</a>'); $result1 = curl_exec($ch); #and then make a temp copy $ch_temp=curl_copy_handle(ch); curl_close($ch); $ch=$ch_temp; ?> Only this way, if you close $ch_temp - cookies wont be dumped.</code></div> </div> </div> <div class="note" id="112326"> <div class="votes"> <div id="Vu112326"> <a href="/manual/vote-note.php?id=112326&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd112326"> <a href="/manual/vote-note.php?id=112326&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V112326" title="56% like this..."> 2 </div> </div> <a href="#112326" class="name"> shiplu at programmer dot net</a><a class="genanchor" href="#112326"> ¶</a><div class="date" title="2013-06-01 06:23">11 years ago</div> <div class="text" id="Hcom112326"> <div class="phpcode"><code>CURLOPT_POST should be set before CURLOPT_POSTFIELDS. Otherwise you might encounter 411 Length required error. Following code generates "411 Length Required" on nginx/1.1.15 <?php curl_setopt ($ch, CURLOPT_POSTFIELDS, $postfields); curl_setopt ($ch, CURLOPT_POST, 1); ?> But this one works. <?php curl_setopt ($ch, CURLOPT_POST, 1); curl_setopt ($ch, CURLOPT_POSTFIELDS, $postfields); ?></code></div> </div> </div> <div class="note" id="84374"> <div class="votes"> <div id="Vu84374"> <a href="/manual/vote-note.php?id=84374&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd84374"> <a href="/manual/vote-note.php?id=84374&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V84374" title="55% like this..."> 3 </div> </div> <a href="#84374" class="name"> ac at an dot y-co dot de</a><a class="genanchor" href="#84374"> ¶</a><div class="date" title="2008-07-10 10:08">16 years ago</div> <div class="text" id="Hcom84374"> <div class="phpcode"><code>If you want to connect to a server which requires that you identify yourself with a certificate, use following code. Your certificate and servers certificate are signed by an authority whose certificate is in ca.ctr. <?php curl_setopt($ch, CURLOPT_VERBOSE, '1'); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, '2'); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, '1'); curl_setopt($ch, CURLOPT_CAINFO, getcwd().'/cert/ca.crt'); curl_setopt($ch, CURLOPT_SSLCERT, getcwd().'/cert/mycert.pem'); curl_setopt($ch, CURLOPT_SSLCERTPASSWD, 'password'); ?> If your original certificate is in .pfx format, you have to convert it to .pem using following commands # openssl pkcs12 -in mycert.pfx -out mycert.key # openssl rsa -in mycert.key -out mycert.pem # openssl x509 -in mycert.key >> mycert.pem</code></div> </div> </div> <div class="note" id="112113"> <div class="votes"> <div id="Vu112113"> <a href="/manual/vote-note.php?id=112113&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd112113"> <a href="/manual/vote-note.php?id=112113&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V112113" title="53% like this..."> 2 </div> </div> <a href="#112113" class="name"> Madcat</a><a class="genanchor" href="#112113"> ¶</a><div class="date" title="2013-05-06 03:14">11 years ago</div> <div class="text" id="Hcom112113"> <div class="phpcode"><code>If you have a mixture of strings starting with @ (at character) and files in CURLOPT_POSTFIELDS you have a problem (such as posting a tweet with attached media) because curl tries to interpret anything starting with @ as a file. <?php $postfields = array( 'upload_file' => '@file_to_upload.png', 'upload_text' => '@text_to_upload' ); $curl = curl_init(); curl_setopt($curl, CURLOPT_URL, '<a href="http://example.com/upload-test" rel="nofollow" target="_blank">http://example.com/upload-test</a>'); curl_setopt($curl, CURLOPT_POSTFIELDS, $postfields); curl_exec($curl); curl_close($curl); ?> To get around this, prepend the text string with the NULL character like so: <?php $postfields = array( 'upload_file' => '@file_to_upload.png', 'upload_text' => sprintf("\0%s", '@text_to_upload') ); ?> Original source: <a href="http://bit.ly/AntMle" rel="nofollow" target="_blank">http://bit.ly/AntMle</a></code></div> </div> </div> <div class="note" id="92522"> <div class="votes"> <div id="Vu92522"> <a href="/manual/vote-note.php?id=92522&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd92522"> <a href="/manual/vote-note.php?id=92522&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V92522" title="53% like this..."> 1 </div> </div> <a href="#92522" class="name"> Sylvain R</a><a class="genanchor" href="#92522"> ¶</a><div class="date" title="2009-07-28 03:05">15 years ago</div> <div class="text" id="Hcom92522"> <div class="phpcode"><code>When you are using CURLOPT_FILE to download directly into a file you must close the file handler after the curl_close() otherwise the file will be incomplete and you will not be able to use it until the end of the execution of the php process. <?php $fh = fopen('/tmp/foo', 'w'); $ch = curl_init('<a href="http://example.com/foo" rel="nofollow" target="_blank">http://example.com/foo</a>'); curl_setopt($ch, CURLOPT_FILE, $fh); curl_exec($ch); curl_close($ch); # at this point your file is not complete and corrupted fclose($fh); # now you can use your file; read_file('/tmp/foo'); ?></code></div> </div> </div> <div class="note" id="97206"> <div class="votes"> <div id="Vu97206"> <a href="/manual/vote-note.php?id=97206&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd97206"> <a href="/manual/vote-note.php?id=97206&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V97206" title="52% like this..."> 2 </div> </div> <a href="#97206" class="name"> julien veneziano</a><a class="genanchor" href="#97206"> ¶</a><div class="date" title="2010-04-08 03:56">14 years ago</div> <div class="text" id="Hcom97206"> <div class="phpcode"><code>If you need to send deta in a DELETE request, use: <?php $request_body = 'some data'; $ch = curl_init('<a href="http://www.example.com" rel="nofollow" target="_blank">http://www.example.com</a>'); curl_setopt($ch, CURLOPT_POSTFIELDS, $request_body); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE"); $response = curl_exec($ch); var_dump($response); ?></code></div> </div> </div> <div class="note" id="109319"> <div class="votes"> <div id="Vu109319"> <a href="/manual/vote-note.php?id=109319&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd109319"> <a href="/manual/vote-note.php?id=109319&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V109319" title="52% like this..."> 1 </div> </div> <a href="#109319" class="name"> adrian at foeder dot de</a><a class="genanchor" href="#109319"> ¶</a><div class="date" title="2012-07-06 07:37">12 years ago</div> <div class="text" id="Hcom109319"> <div class="phpcode"><code>if you want to do a GET request with additional body data it will become tricky not to implicitly change the request to a POST, like many notes below correctly state. So to do the analogy of command line's curl -XGET '<a href="http://example.org?foo=bar" rel="nofollow" target="_blank">http://example.org?foo=bar</a>' -d '<baz>some additional data</baz>' in PHP you'll do, besides your other necessary stuff, <?php curl_setopt($curlHandle, CURLOPT_CUSTOMREQUEST, 'GET'); curl_setopt($curlHandle, CURLOPT_POSTFIELDS, '<baz>some additional data</baz>'); ?> during my experiments, every other "similar" way, like e.g. CURLOPT_HTTPGET, didn't send the additional data or fell into POST.</code></div> </div> </div> <div class="note" id="128365"> <div class="votes"> <div id="Vu128365"> <a href="/manual/vote-note.php?id=128365&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd128365"> <a href="/manual/vote-note.php?id=128365&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V128365" title="100% like this..."> 2 </div> </div> <a href="#128365" class="name"> Niki Romagnoli</a><a class="genanchor" href="#128365"> ¶</a><div class="date" title="2023-04-04 11:44">1 year ago</div> <div class="text" id="Hcom128365"> <div class="phpcode"><code>Set order when using CURLOPT_POST and CURLOPT_POSTFIELDS *matters*. Setting CURL_POST to true will ERASE any previous CURLOPT_POSTFIELDS using an array. Result is request be a POST with empty body. CURLOPT_POSTFIELDS will set CURLOPT_POST to true for you, no need for repeat. If you really need to set both, then either: - set CURLOPT_POST *before* CURLOPT_POSTFIELDS - or don't use array and convert CURLOPT_POSTFIELDS to URL-encoded string, it will not be affected this way (ie. <?php curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($yourArray)); ?> )</code></div> </div> </div> <div class="note" id="128774"> <div class="votes"> <div id="Vu128774"> <a href="/manual/vote-note.php?id=128774&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd128774"> <a href="/manual/vote-note.php?id=128774&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V128774" title="100% like this..."> 1 </div> </div> <a href="#128774" class="name"> alexchexes at gmail dot com</a><a class="genanchor" href="#128774"> ¶</a><div class="date" title="2023-08-02 02:06">1 year ago</div> <div class="text" id="Hcom128774"> <div class="phpcode"><code>If you want cURL to successfully write cookies to a file specified with CURLOPT_COOKIEJAR, ensure that cURL has the necessary permissions to modify the file if it already exists. I spent nearly a day trying to understand why cURL wasn't saving cookies to an existing file, even though I could easily modify the exact same file using file_put_contents(). Moreover, cURL itself could create the same file and save cookies, but only if it didn't previously exist. Ultimately, the issue was related to file ownership. I was working within WSL2, inside a symlinked Windows directory. The [automount]"metadata" in wsl.conf was not set, causing every file created from PHP to have the default owner, which differed from the user running PHP. Once I configured wsl.conf and then changed the ownership of the entire directory to match the user running PHP, cookies were successfully written to any file without any issues.</code></div> </div> </div> <div class="note" id="122274"> <div class="votes"> <div id="Vu122274"> <a href="/manual/vote-note.php?id=122274&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd122274"> <a href="/manual/vote-note.php?id=122274&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V122274" title="50% like this..."> 0 </div> </div> <a href="#122274" class="name"> joel at mojamail dot com</a><a class="genanchor" href="#122274"> ¶</a><div class="date" title="2018-01-16 11:57">7 years ago</div> <div class="text" id="Hcom122274"> <div class="phpcode"><code>In the long documentation, it's easy to miss the fact that CURLOPT_POSTFIELDS will set the Content-Type to "multipart/form-data" (instead of the usual "application/x-www-form-urlencoded") IFF you supply an array (instead of a query string)! Some servers will return weird errors (like "SSL read: error:00000000:lib(0):func(0):reason(0), errno 104") for the wrong Content-Type, and you may waste many hours of time trying to figure out why!</code></div> </div> </div> <div class="note" id="69115"> <div class="votes"> <div id="Vu69115"> <a href="/manual/vote-note.php?id=69115&page=function.curl-setopt&vote=up" title="Vote up!" class="usernotes-voteu">up</a> </div> <div id="Vd69115"> <a href="/manual/vote-note.php?id=69115&page=function.curl-setopt&vote=down" title="Vote down!" class="usernotes-voted">down</a> </div> <div class="tally" id="V69115" title="50% like this..."> 0 </div> </div> <a href="#69115" class="name"> php at miggy dot org</a><a class="genanchor" href="#69115"> ¶</a><div class="date" title="2006-08-23 10:35">18 years ago</div> <div class="text" id="Hcom69115"> <div class="phpcode"><code>Note that if you want to use a proxy and use it as a _cache_, you'll have to do: <?php curl_setopt($ch, CURLOPT_HTTPHEADER, array("Pragma: ")); ?> else by default Curl puts a "Pragma: no-cache" header in and thus force cache misses for all requests.</code></div> </div> </div></div> <div class="foot"><a href="/manual/add-note.php?sect=function.curl-setopt&repo=en&redirect=https://www.php.net/manual/en/function.curl-setopt.php">＋add a note</a></div> </section> </section> <aside class='layout-menu'> <ul class='parent-menu-list'> <li> <a href="ref.curl.php">cURL Functions</a> <ul class='child-menu-list'> <li class=""> <a href="function.curl-close.php" title="curl_close">curl_close</a> </li> <li class=""> <a href="function.curl-copy-handle.php" title="curl_copy_handle">curl_copy_handle</a> </li> <li class=""> <a href="function.curl-errno.php" title="curl_errno">curl_errno</a> </li> <li class=""> <a href="function.curl-error.php" title="curl_error">curl_error</a> </li> <li class=""> <a href="function.curl-escape.php" title="curl_escape">curl_escape</a> </li> <li class=""> <a href="function.curl-exec.php" title="curl_exec">curl_exec</a> </li> <li class=""> <a href="function.curl-getinfo.php" title="curl_getinfo">curl_getinfo</a> </li> <li class=""> <a href="function.curl-init.php" title="curl_init">curl_init</a> </li> <li class=""> <a href="function.curl-multi-add-handle.php" title="curl_multi_add_handle">curl_multi_add_handle</a> </li> <li class=""> <a href="function.curl-multi-close.php" title="curl_multi_close">curl_multi_close</a> </li> <li class=""> <a href="function.curl-multi-errno.php" title="curl_multi_errno">curl_multi_errno</a> </li> <li class=""> <a href="function.curl-multi-exec.php" title="curl_multi_exec">curl_multi_exec</a> </li> <li class=""> <a href="function.curl-multi-getcontent.php" title="curl_multi_getcontent">curl_multi_getcontent</a> </li> <li class=""> <a href="function.curl-multi-info-read.php" title="curl_multi_info_read">curl_multi_info_read</a> </li> <li class=""> <a href="function.curl-multi-init.php" title="curl_multi_init">curl_multi_init</a> </li> <li class=""> <a href="function.curl-multi-remove-handle.php" title="curl_multi_remove_handle">curl_multi_remove_handle</a> </li> <li class=""> <a href="function.curl-multi-select.php" title="curl_multi_select">curl_multi_select</a> </li> <li class=""> <a href="function.curl-multi-setopt.php" title="curl_multi_setopt">curl_multi_setopt</a> </li> <li class=""> <a href="function.curl-multi-strerror.php" title="curl_multi_strerror">curl_multi_strerror</a> </li> <li class=""> <a href="function.curl-pause.php" title="curl_pause">curl_pause</a> </li> <li class=""> <a href="function.curl-reset.php" title="curl_reset">curl_reset</a> </li> <li class="current"> <a href="function.curl-setopt.php" title="curl_setopt">curl_setopt</a> </li> <li class=""> <a href="function.curl-setopt-array.php" title="curl_setopt_array">curl_setopt_array</a> </li> <li class=""> <a href="function.curl-share-close.php" title="curl_share_close">curl_share_close</a> </li> <li class=""> <a href="function.curl-share-errno.php" title="curl_share_errno">curl_share_errno</a> </li> <li class=""> <a href="function.curl-share-init.php" title="curl_share_init">curl_share_init</a> </li> <li class=""> <a href="function.curl-share-setopt.php" title="curl_share_setopt">curl_share_setopt</a> </li> <li class=""> <a href="function.curl-share-strerror.php" title="curl_share_strerror">curl_share_strerror</a> </li> <li class=""> <a href="function.curl-strerror.php" title="curl_strerror">curl_strerror</a> </li> <li class=""> <a href="function.curl-unescape.php" title="curl_unescape">curl_unescape</a> </li> <li class=""> <a href="function.curl_upkeep.php" title="curl_upkeep">curl_upkeep</a> </li> <li class=""> <a href="function.curl-version.php" title="curl_version">curl_version</a> </li> </ul> </li> </ul> </aside> </div> <footer> <div class="container footer-content"> <div class="row-fluid"> <ul class="footmenu"> <li><a href="/manual/en/copyright.php">Copyright © 2001-2025 The PHP Documentation Group</a></li> <li><a href="/my.php">My PHP.net</a></li> <li><a href="/contact.php">Contact</a></li> <li><a href="/sites.php">Other PHP.net sites</a></li> <li><a href="/privacy.php">Privacy policy</a></li> </ul> </div> </div> </footer> <script src="/cached.php?t=1731172202&f=/js/ext/jquery-3.6.0.min.js"></script> <script src="/cached.php?t=1723177202&f=/js/ext/FuzzySearch.min.js"></script> <script src="/cached.php?t=1707321815&f=/js/ext/mousetrap.min.js"></script> <script src="/cached.php?t=1707321815&f=/js/ext/jquery.scrollTo.min.js"></script> <script src="/cached.php?t=1738028401&f=/js/search.js"></script> <script src="/cached.php?t=1738742401&f=/js/common.js"></script> <script type="module" src="/cached.php?t=1738318202&f=/js/interactive-examples.js"></script> <a id="toTop" href="javascript:;"><img width="40" height="40" alt="To Top" src="/images/to-top@2x.png"></a> <div id="search-modal__backdrop" class="search-modal__backdrop"> <div role="dialog" aria-label="Search modal" id="search-modal" class="search-modal" > <div class="search-modal__header"> <div class="search-modal__form"> <div class="search-modal__input-icon">  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" > <circle cx="11" cy="11" r="8"></circle> <line x1="21" y1="21" x2="16.65" y2="16.65"></line> </svg> </div> <input type="search" id="search-modal__input" class="search-modal__input" placeholder="Search docs" aria-label="Search docs" /> </div> <button aria-label="Close" class="search-modal__close">  <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" width="24" viewBox="0 0 24 24" > <path d="M19,6.41L17.59,5L12,10.59L6.41,5L5,6.41L10.59,12L5,17.59L6.41,19L12,13.41L17.59,19L19,17.59L13.41,12L19,6.41Z"/> </svg> </button> </div> <div role="listbox" aria-label="Search results" id="search-modal__results" class="search-modal__results" ></div> <div class="search-modal__helper-text"> <div> <kbd>↑</kbd> and <kbd>↓</kbd> to navigate • <kbd>Enter</kbd> to select • <kbd>Esc</kbd> to close </div> <div> Press <kbd>Enter</kbd> without selection to search using Google </div> </div> </div> </div> </body> </html>