File: ref.curl.html

package info (click to toggle)
php3 3%3A3.0.18-0potato1.1
links: PTS
area: main
in suites: potato
size: 17,736 kB
ctags: 11,198
sloc: ansic: 108,120; sh: 2,512; php: 2,024; yacc: 1,887; makefile: 1,038; perl: 537; pascal: 238; awk: 90; cpp: 28; sql: 11
file content (287 lines) | stat: -rw-r--r-- 5,028 bytes
parent folder | download | duplicates (3)
<HTML
><HEAD
><TITLE
>CURL, Client URL Library Functions</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
REL="HOME"
TITLE="PHP Manual"
HREF="manual.html"><LINK
REL="UP"
TITLE="Function Reference"
HREF="funcref.html"><LINK
REL="PREVIOUS"
TITLE="cpdf_add_annotation"
HREF="function.cpdf-add-annotation.html"><LINK
REL="NEXT"
TITLE="curl_init"
HREF="function.curl-init.html"><META
NAME="HTTP_EQUIV"
CONTENT="text/html; charset=ISO-8859-1"></HEAD
><BODY
CLASS="reference"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.cpdf-add-annotation.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.curl-init.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="reference"
><A
NAME="ref.curl"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
>X. CURL, Client URL Library Functions</H1
><DIV
CLASS="PARTINTRO"
><A
NAME="curl.partintro"
></A
><P
>&#13;    PHP supports libcurl, a library, created by Daniel Stenberg, that
    allows you to connect and communicate to many different types of
    servers with many different types of protocols.  libcurl currently
    supports the http, https, ftp, gopher, telnet, dict, file, and
    ldap protocols.  libcurl also supports HTTPS certificates, HTTP
    POST, HTTP PUT, FTP uploading (this can also be done with PHP's
    ftp extension), HTTP form based upload, proxies, cookies and
    user+password authentication.
   </P
><P
>&#13;    In order to use the CURL functions you need to install the <A
HREF="http://curl.haxx.se/"
TARGET="_top"
>CURL</A
> package. PHP requires that you use
    CURL 7.0.2-beta or higher. PHP will not work with any version of
    CURL below version 7.0.2-beta.
   </P
><P
>&#13;    To use PHP's CURL support you must also compile PHP <TT
CLASS="option"
>--with-curl[=DIR]</TT
> where DIR is the
    location of the directory containing the lib and include
    directories.  In the "include" directory there should be a folder
    named "curl" which should contain the easy.h and curl.h files.
    There should be a file named "libcurl.a" located in the "lib"
    directory.
   </P
><P
>&#13;    These functions have been added in PHP 4.0.2. 
   </P
><P
>&#13;    Once you've compiled PHP with CURL support, you can begin using
    the curl functions.  The basic idea behind the CURL functions is
    that you initialize a CURL session using the
    <A
HREF="function.curl-init.html"
><B
CLASS="function"
>curl_init()</B
></A
>, then you can set all your
    options for the transfer via the <A
HREF="function.curl-exec.html"
><B
CLASS="function"
>curl_exec()</B
></A
>
    and then you finish off your session using the
    <A
HREF="function.curl-close.html"
><B
CLASS="function"
>curl_close()</B
></A
>.  Here is an example that uses
    the CURL functions to fetch the PHP homepage into a file:
    <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN8430"
></A
><P
><B
>Example 1. Using PHP's CURL module to fetch the PHP homepage</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="programlisting"
>&#13;&#60;?php

$ch = curl_init ("http://www.php.net/");
$fp = fopen ("php_homepage.txt", "w");

curl_setopt ($ch, CURLOPT_INFILE, $fp);
curl_setopt ($ch, CURLOPT_HEADER, 0);

curl_exec ($ch);
curl_close ($ch);
fclose ($fp);
?&#62;
     </PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
   </P
></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="function.curl-init.html"
>curl_init</A
> &#8212; Initialize a CURL session</DT
><DT
><A
HREF="function.curl-setopt.html"
>curl_setopt</A
> &#8212; Set an option for a CURL transfer</DT
><DT
><A
HREF="function.curl-exec.html"
>curl_exec</A
> &#8212; Perform a CURL session</DT
><DT
><A
HREF="function.curl-close.html"
>curl_close</A
> &#8212; Close a CURL session</DT
><DT
><A
HREF="function.curl-version.html"
>curl_version</A
> &#8212; Return the current CURL version</DT
></DL
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.cpdf-add-annotation.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="manual.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.curl-init.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>cpdf_add_annotation</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="funcref.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>curl_init</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>