matroz Fri Mar 8 18:13:57 2002 EDT Modified files: /phpdoc/he/functions curl.xml Log: more changes
Index: phpdoc/he/functions/curl.xml diff -u phpdoc/he/functions/curl.xml:1.2 phpdoc/he/functions/curl.xml:1.3 --- phpdoc/he/functions/curl.xml:1.2 Fri Mar 8 15:38:42 2002 +++ phpdoc/he/functions/curl.xml Fri Mar 8 18:13:57 2002 @@ -1,49 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: matty Status: working --> +<!-- EN-Revision: 1.3 Maintainer: matty Status: working --> <reference id="ref.curl"> <title>CURL, Client URL Library Functions</title> <titleabbrev>CURL</titleabbrev> <partintro id="curl.partintro"> <para> - 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 + PHP תומכת ב libcurl, ספריה שנכתבה על ידי Daniel Stenberg, המאפשרת + להתחבר ולתקשר עם סוגים שונים של שרתים ופרוטוקולים. + libcurl תומכת כרגע בפרוטוקולים http, https, ftp, gopher, telnet, dict, + file, ן ldap. + libcurl , כמו כן תומכת ב HTTPS certificates, HTTP + POST, HTTP PUT, FTP uploading (שיכול להתבצע גם בעזרת PHP's ftp extension), HTTP form based upload, proxies, cookies, and user+password authentication. </para> <para> - In order to use the CURL functions you need to install the <ulink - url="&url.curl;">CURL</ulink> 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. + על מנת להשתמש ב CURL functions עליך להתקין את חבילת ה<ulink + url="&url.curl;">CURL</ulink>. PHP מחייבת אותך להשתמש ב CURL 7.0.2-beta + ומעלה. PHP לא תעבוד עם אף גירסה של CURL מתחת לגירסא 7.0.2-beta. </para> <para> - To use PHP's CURL support you must also compile PHP <option - role="configure">--with-curl[=DIR]</option> 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. + כדי להשתמש ב PHP's CURL support עליך לקמפל את PHP <option + role="configure">--with-curl[=DIR]</option> כאשר DIR הוא המיקום + של הספריה המכילה את ספריית ה lib וספריית ה include. + בספריית "include" צריך להיות ספרייה בשם "curl" + שצריכה להכיל את הקבצים easy.h ו curl.h. + קובץ בשם "libcurl.a" צריך להמצא תחת ספריית "lib". </para> <para> - These functions have been added in PHP 4.0.2. + פונקציות אילו התווספו בגירסה PHP 4.0.2. </para> <para> - 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 - <function>curl_init</function>, then you can set all your - options for the transfer via the <function>curl_exec</function> - and then you finish off your session using the - <function>curl_close</function>. Here is an example that uses - the CURL functions to fetch the PHP homepage into a file: + לאחר ש PHP קומפל עם CURL support, ניתן להתחיל + להשתמש בפונקציות curl. הרעיון הבסיסי העומד מאחורי פונקציות CURL + הוא שמאותחל CURL session בעזרת <function>curl_init</function>, ואז ניתן + לקבוע את כל האופציות להעברת המידע דרך <function>curl_exec</function> + ,לאחר מכן נסגר ה session תוך כדי שימוש ב <function>curl_close</function>. + לפנינו דוגמה העושה שימוש בפונקציות CURL על מנת להביא את עמוד + הבית של PHP לתוך קובץ: <example> - <title>Using PHP's CURL module to fetch the PHP homepage</title> + <title>שימוש ב PHP's CURL module על מנת להביא את עמוד הבית של PHP</title> <programlisting role="php"> <![CDATA[ <?php @@ -67,10 +64,10 @@ <refentry id="function.curl-init"> <refnamediv> <refname>curl_init</refname> - <refpurpose>Initialize a CURL session</refpurpose> + <refpurpose>אתחול של CURL session</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>int</type><methodname>curl_init</methodname> <methodparam choice="opt"><type>string</type><parameter> @@ -78,17 +75,17 @@ </parameter></methodparam> </methodsynopsis> <para> - The <function>curl_init</function> will initialize a new session - and return a CURL handle for use with the - <function>curl_setopt</function>, <function>curl_exec</function>, - and <function>curl_close</function> functions. If the optional - <parameter>url</parameter> parameter is supplied then the - CURLOPT_URL option will be set to the value of the parameter. - You can manually set this using the - <function>curl_setopt</function> function. + הפונקציה <function>curl_init</function> מאתחלת session + חדש ומחזירה מצביע CURL לשימוש עם <function>curl_setopt</function>, + <function>curl_exec</function>,ו <function>curl_close</function> + functions. + אם המשתנה האופציונלי <parameter>url</parameter> יסופק לפונקציה אזי + האופציה CURLOPT_URL תקבל את ערך המשתנה באופן אוטומטי. + ניתן לקבוע בצורה ידנית את ערכו של המשתנה על ידי שימוש בפונקצית + <function>curl_setopt</function>. <example> <title> - Initializing a new CURL session and fetching a webpage + אתחול של CURL session והבאת דף הבית </title> <programlisting role="php"> <![CDATA[ @@ -107,7 +104,7 @@ </example> </para> <para> - See also: <function>curl_close</function>, + ראה גם: <function>curl_close</function>, <function>curl_setopt</function> </para> </refsect1> @@ -116,10 +113,10 @@ <refentry id="function.curl-setopt"> <refnamediv> <refname>curl_setopt</refname> - <refpurpose>Set an option for a CURL transfer</refpurpose> + <refpurpose>קבע אפשרויות להעברת מידע עם CURL</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>bool</type><methodname>curl_setopt</methodname> <methodparam><type>int</type><parameter>ch</parameter></methodparam> @@ -127,86 +124,79 @@ <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> <para> - The <function>curl_setopt</function> function will set options - for a CURL session identified by the <parameter>ch</parameter> - parameter. The <parameter>option</parameter> parameter is the - option you want to set, and the <parameter>value</parameter> is - the value of the option given by the - <parameter>option</parameter>. + הפונקציה <function>curl_setopt</function> מאפשרת לקבוע את האפשרויות + של CURL session המזוהה על ידי הפרמטר <parameter>ch</parameter>. + <parameter>option</parameter> היא האופציה אותה ניתן לקבוע, + וה <parameter>value</parameter> הוא הערך של האופציה שניתנה על + ידי <parameter>option</parameter>. </para> <para> - The <parameter>value</parameter> should be a long for the - following options (specified in the <parameter>option</parameter> - parameter): + ה <parameter>value</parameter> צריך להיות מסוג long עבור + הפשרויות הבאות (מצוינות במשתנה <parameter>option</parameter>): <itemizedlist> <listitem> <simpara> - <parameter>CURLOPT_INFILESIZE</parameter>: When you are - uploading a file to a remote site, this option should be used - to tell PHP what the expected size of the infile will be. + <parameter>CURLOPT_INFILESIZE</parameter>: כאשר מעלים קובץ + לאתר מרוחק, יש להשתמש באופציה זו על מנת להגיד ל PHP + מהו הגודל המצופה מן הקובץ המועלה להיות. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_VERBOSE</parameter>: Set this option to a - non-zero value if you want CURL to report everything that is - happening. + <parameter>CURLOPT_VERBOSE</parameter>: קבע את הערך לערך השונה + מאפס אם יש לאפשר ל CURL לדווח על כל אשר קורה. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_HEADER</parameter>: Set this option to a - non-zero value if you want the header to be included in the - output. + <parameter>CURLOPT_HEADER</parameter>: קבע את הערך לערך השונה + מאפס אם יש לאפשר ל header להכלל במידע הנשלח. </simpara> </listitem> <listitem> <para> - <parameter>CURLOPT_NOPROGRESS</parameter>: Set this option to - a non-zero value if you don't want PHP to display a progress - meter for CURL transfers + <parameter>CURLOPT_NOPROGRESS</parameter>: קבע את הערך לערך השונה + מאפס אם אין אתם רוצים ש PHP תציג progress meter עבור CURL transfers <note> <simpara> - PHP automatically sets this option to a non-zero parameter, - this should only be changed for debugging purposes. + PHP קובעת באופן אוטומטי את הערך לערך השונה מאפס, + יש לשנות ערך זה למטרות debugging בלבד. </simpara> </note> </para> </listitem> <listitem> <simpara> - <parameter>CURLOPT_NOBODY</parameter>: Set this option to a - non-zero value if you don't want the body included with the - output. + <parameter>CURLOPT_NOBODY</parameter>: קבע את הערך לערך השונה + מאפס אם יש לאפשר ל body להכלל במידע הנשלח. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_FAILONERROR</parameter>: Set this option to - a non-zero value if you want PHP to fail silently if the HTTP - code returned is greater than 300. The default behavior is - to return the page normally, ignoring the code. + <parameter>CURLOPT_FAILONERROR</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך ש PHP תכשל באופן שקט,ללא הודעות שגיאה, אם + הקוד המוחזר על ידי ה HTTP גדול מ300. + ברירת המחדל היא להחזיר את הדף באופן רגיל תוך כדי התעלמות מן הקוד. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_UPLOAD</parameter>: Set this option to a - non-zero value if you want PHP to prepare for an upload. + <parameter>CURLOPT_UPLOAD</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך ש PHP תתכונן להעלאת קבצים. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_POST</parameter>: Set this option to a - non-zero value if you want PHP to do a regular HTTP POST. - This POST is a normal application/x-www-form-urlencoded kind, - most commonly used by HTML forms. + <parameter>CURLOPT_POST</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך ש PHP תבצע HTTP POST רגיל. + POST רגיל זה הוא מסוג application/x-www-form-urlencoded, + הנפוץ בשימוש על ידי HTML forms. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_FTPLISTONLY</parameter>: Set this option to - a non-zero value and PHP will just list the names of an FTP - directory. + <parameter>CURLOPT_FTPLISTONLY</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך ש PHP תציג רק את שמות ספריית ה FTP. </simpara> </listitem> <listitem>