<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/curl.examples.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'curl.examples-basic.php',
    1 => 'Exemples de base avec curl',
    2 => 'Exemples de base avec curl',
  ),
  'up' => 
  array (
    0 => 'curl.examples.php',
    1 => 'Exemples',
  ),
  'prev' => 
  array (
    0 => 'curl.examples.php',
    1 => 'Exemples',
  ),
  'next' => 
  array (
    0 => 'ref.curl.php',
    1 => 'Fonctions cURL',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/curl/examples.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="curl.examples-basic" class="section">
  <h2 class="title">Exemples de base avec curl</h2>
  <p class="simpara">
   Une fois PHP compilé avec le support cURL, il est possible de commencer
   à utiliser les fonctions cURL. La première des choses à faire est
   d&#039;initialiser une session cURL avec la fonction
   <span class="function"><a href="function.curl-init.php" class="function">curl_init()</a></span>, puis, il est possible de définir toutes les
   options pour le transfert avec la fonction <span class="function"><a href="function.curl-setopt.php" class="function">curl_setopt()</a></span>,
   et enfin, il est possible d&#039;exécuter la session avec
   <span class="function"><a href="function.curl-exec.php" class="function">curl_exec()</a></span>.
  </p>
  <p class="para">
   Voici un exemple simple qui utilise les fonctions cURL pour envoyer
   une requête POST :
   <div class="example" id="example-1">
    <p><strong>Exemple #1 Utilisation du module cURL de PHP pour envoyer une requête POST</strong></p>
    <div class="example-contents">
<div class="phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
$data </span><span style="color: #007700">= [</span><span style="color: #DD0000">'foo' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'bar'</span><span style="color: #007700">, </span><span style="color: #DD0000">'baz' </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">48</span><span style="color: #007700">];
</span><span style="color: #0000BB">$url </span><span style="color: #007700">= </span><span style="color: #DD0000">"http://www.example.com/handler.php"</span><span style="color: #007700">;

</span><span style="color: #0000BB">$ch </span><span style="color: #007700">= </span><span style="color: #0000BB">curl_init</span><span style="color: #007700">(</span><span style="color: #0000BB">$url</span><span style="color: #007700">);

</span><span style="color: #FF8000">// demande à CURL de retourner la réponse au lieu de l'envoyer sur la sortie standard
</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_RETURNTRANSFER</span><span style="color: #007700">, </span><span style="color: #0000BB">true</span><span style="color: #007700">);

</span><span style="color: #FF8000">// définit les données POST, la méthode correspondante et les en-têtes
</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_POSTFIELDS</span><span style="color: #007700">, </span><span style="color: #0000BB">http_build_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$data</span><span style="color: #007700">));

</span><span style="color: #FF8000">// envoie la requête et récupère la réponse
</span><span style="color: #0000BB">$response </span><span style="color: #007700">= </span><span style="color: #0000BB">curl_exec</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">);

if(</span><span style="color: #0000BB">curl_error</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">)) {
    </span><span style="color: #FF8000">// traite l'erreur, ou simplement
    </span><span style="color: #007700">throw new </span><span style="color: #0000BB">RuntimeException</span><span style="color: #007700">(</span><span style="color: #0000BB">curl_error</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">));
}</span></code></pre></div>
    </div>

   </div>
  </p>
  <p class="para">
   Un autre exemple qui utilise les fonctions cURL pour envoyer une requête
   POST avec du JSON brut :
   <div class="example" id="example-2">
    <p><strong>Exemple #2 Utilisation du module cURL de PHP pour envoyer une requête POST JSON</strong></p>
    <div class="example-contents">
<div class="phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
$post_data </span><span style="color: #007700">= [</span><span style="color: #DD0000">'foo' </span><span style="color: #007700">=&gt; </span><span style="color: #DD0000">'bar'</span><span style="color: #007700">, </span><span style="color: #DD0000">'baz' </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">48</span><span style="color: #007700">];
</span><span style="color: #0000BB">$url </span><span style="color: #007700">= </span><span style="color: #DD0000">"http://www.example.com/api/endpoint"</span><span style="color: #007700">;

</span><span style="color: #0000BB">$ch </span><span style="color: #007700">= </span><span style="color: #0000BB">curl_init</span><span style="color: #007700">(</span><span style="color: #0000BB">$url</span><span style="color: #007700">);

</span><span style="color: #FF8000">// demande à CURL de retourner la réponse au lieu de l'envoyer sur la sortie standard
</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_RETURNTRANSFER</span><span style="color: #007700">, </span><span style="color: #0000BB">true</span><span style="color: #007700">);

</span><span style="color: #FF8000">// définit les données POST et la méthode correspondante
</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_POSTFIELDS</span><span style="color: #007700">, </span><span style="color: #0000BB">json_encode</span><span style="color: #007700">(</span><span style="color: #0000BB">$post_data</span><span style="color: #007700">));

</span><span style="color: #FF8000">// définit l'en-tête requis
</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_HTTPHEADER</span><span style="color: #007700">, [</span><span style="color: #DD0000">'Content-Type: application/json'</span><span style="color: #007700">]);

</span><span style="color: #FF8000">// envoie la requête et récupère la réponse
</span><span style="color: #0000BB">$response </span><span style="color: #007700">= </span><span style="color: #0000BB">curl_exec</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">);

if(</span><span style="color: #0000BB">curl_error</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">)) {
    </span><span style="color: #FF8000">// traite l'erreur, ou simplement
    </span><span style="color: #007700">throw new </span><span style="color: #0000BB">RuntimeException</span><span style="color: #007700">(</span><span style="color: #0000BB">curl_error</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">));
}</span></code></pre></div>
    </div>

   </div>
  </p>
  <p class="para">
   Voici un autre exemple qui utilise les fonctions cURL pour récupérer
   la page d&#039;accueil du site example.com dans un fichier :
   <div class="example" id="example-3">
    <p><strong>Exemple #3 Utilisation du module cURL pour récupérer la page d&#039;accueil d&#039;example.com</strong></p>
    <div class="example-contents">
<div class="phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php

$ch </span><span style="color: #007700">= </span><span style="color: #0000BB">curl_init</span><span style="color: #007700">(</span><span style="color: #DD0000">"http://www.example.com/"</span><span style="color: #007700">);
</span><span style="color: #0000BB">$fp </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen</span><span style="color: #007700">(</span><span style="color: #DD0000">"example_homepage.txt"</span><span style="color: #007700">, </span><span style="color: #DD0000">"w"</span><span style="color: #007700">);

</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_FILE</span><span style="color: #007700">, </span><span style="color: #0000BB">$fp</span><span style="color: #007700">);
</span><span style="color: #0000BB">curl_setopt</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">, </span><span style="color: #0000BB">CURLOPT_HEADER</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">);

</span><span style="color: #0000BB">curl_exec</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">);
if(</span><span style="color: #0000BB">curl_error</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">)) {
    </span><span style="color: #0000BB">fwrite</span><span style="color: #007700">(</span><span style="color: #0000BB">$fp</span><span style="color: #007700">, </span><span style="color: #0000BB">curl_error</span><span style="color: #007700">(</span><span style="color: #0000BB">$ch</span><span style="color: #007700">));
}
</span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$fp</span><span style="color: #007700">);</span></code></pre></div>
    </div>

   </div>
  </p>
 </div><?php manual_footer($setup); ?>