matroz Tue Mar 26 03:11:05 2002 EDT Modified files: /phpdoc/he/functions curl.xml Log: fully translated
Index: phpdoc/he/functions/curl.xml diff -u phpdoc/he/functions/curl.xml:1.3 phpdoc/he/functions/curl.xml:1.4 --- phpdoc/he/functions/curl.xml:1.3 Fri Mar 8 18:13:57 2002 +++ phpdoc/he/functions/curl.xml Tue Mar 26 03:11:04 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: matty Status: working --> +<!-- EN-Revision: 1.29 Maintainer: matroz Status: done --> <reference id="ref.curl"> <title>CURL, Client URL Library Functions</title> <titleabbrev>CURL</titleabbrev> @@ -201,297 +201,283 @@ </listitem> <listitem> <simpara> - <parameter>CURLOPT_FTPAPPEND</parameter>: Set this option to a - non-zero value and PHP will append to the remote file instead - of overwriting it. + <parameter>CURLOPT_FTPAPPEND</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך ש PHP תוסיף את תוכן הקובץ לקובץ הקיים + במקום להחליפו. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_NETRC</parameter>: Set this option to a - non-zero value and PHP will scan your ~./netrc file to find - your username and password for the remote site that you're - establishing a connection with. + <parameter>CURLOPT_NETRC</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך ש PHP תסרוק את קובץ ~./netrc כדי למצוא את + שם המשתמש והסיסמה עבור האתר המרוחק אליו מתבצע + ניסיון להתחברות. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Set this option - to a non-zero value to follow any "Location: " header that the - server sends as a part of the HTTP header (note this is - recursive, PHP will follow as many "Location: " headers that - it is sent.) + <parameter>CURLOPT_FOLLOWLOCATION</parameter>: קבע את הערך לערך השונה + מאפס אם ברצונך לעקוב אחר כל "Location: " header שהשרת + שולח כחלק מה HTTP header + (המעקב הינו רקורסיבי, ו PHP תעקוב אחר כל "Location: " headers שישלחו.). </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_PUT</parameter>: Set this option a non-zero - value to HTTP PUT a file. The file to PUT must be set with - the CURLOPT_INFILE and CURLOPT_INFILESIZE. + <parameter>CURLOPT_PUT</parameter>: קבע את הערך לערך השונה + מאפס כדי לבצע HTTP PUT לקובץ. הקובץ המועבר ל PUT חייב להקבע + תוך כדי שימוש ב CURLOPT_INFILE ו CURLOPT_INFILESIZE. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_MUTE</parameter>: Set this option to a - non-zero value and PHP will be completely silent with regards - to the CURL functions. + <parameter>CURLOPT_MUTE</parameter>: קבע את הערך לערך השונה + מאפס כדי ש PHP תהיה שקטה לגמרי לגבי פונקציות CURL. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_TIMEOUT</parameter>: Pass a long as a - parameter that contains the maximum time, in seconds, that - you'll allow the curl functions to take. + <parameter>CURLOPT_TIMEOUT</parameter>: העבר ערך מסוג long + כפרמטר שמכיל את הזמן המקסימלי, בשניות, שאותו + תרשה לפונקציות curl להתבצע. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Pass a long as - a parameter that contains the transfer speed in bytes per - second that the transfer should be below during - CURLOPT_LOW_SPEED_TIME seconds for PHP to consider it too slow - and abort. + <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: העבר ערך מסוג long + כפרמטר שמכיל את מהירות ההעברה בבתים לשניה + שמהירות ההעברה צריכה להיות מתחת CURLOPT_LOW_SPEED_TIME שניות + על מנת ש PHP תתיחס למהירות כנמוכה מדי ותבטל את ההעברה. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Pass a long as - a parameter that contains the time in seconds that the - transfer should be below the CURLOPT_LOW_SPEED_LIMIT for PHP - to consider it too slow and abort. + <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: העבר ערך מסוג long + כפרמטר שמכיל את הזמן בשניות שההעברה צריכה להיות + מתחת ל CURLOPT_LOW_SPEED_LIMIT כדי ש PHP + תתיחס לפעולה כאיטית מדי ותבטל את ההעברה. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_RESUME_FROM</parameter>: Pass a long as a - parameter that contains the offset, in bytes, that you want - the transfer to start from. + <parameter>CURLOPT_RESUME_FROM</parameter>: העבר ערך מסוג long + כפרמטר שמכיל את ה offset, בבתים, שההעברה תתחיל ממנה. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_SSLVERSION</parameter>: Pass a long as a - parameter that contains the SSL version (2 or 3) to use. By - default PHP will try and determine this by itself, although, - in some cases you must set this manually. + <parameter>CURLOPT_SSLVERSION</parameter>: העבר ערך מסוג long + כפרמטר שמכיל את גירסת ה SSL(2 or 3) לשימוש. + כברירת מחדל PHP תנסה למצוא נתון זה בעצמה, אך + במקרים מסוימים יש לקבוע ערך זו ידנית. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_SSL_VERIFYHOST</parameter>: Pass a long if - cURL should verify the Common name of the peer certificate in the - SSL handshake. A value of 1 denotes that we should check for the - existence of the common name, a value of 2 denotes that we should - make sure it matches the provided hostname. + <parameter>CURLOPT_SSL_VERIFYHOST</parameter>: העבר ערך מסוג long + אם cURL אמורה לוודא את ה peer certificate הנמצא בשימוש עם + SSL handshake. הערך 1 קובע שיש לבדוק את המצאותו של + common name, הערך 2 קובע שיש לוודא כי היא זהה לשם המחשב + המארח. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_TIMECONDITION</parameter>: Pass a long as a - parameter that defines how the CURLOPT_TIMEVALUE is treated. - You can set this parameter to TIMECOND_IFMODSINCE or - TIMECOND_ISUNMODSINCE. This is a HTTP-only feature. + <parameter>CURLOPT_TIMECONDITION</parameter>: העבר ערך מסוג long + כפרמטר הקובע כיצד יש להתיחס ל CURLOPT_TIMEVALUE. + ניתן לקבוע את הערך ל TIMECOND_IFMODSINCE או ל + TIMECOND_ISUNMODSINCE. זהו HTTP-only feature. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_TIMEVALUE</parameter>: Pass a long as a - parameter that is the time in seconds since January 1st, 1970. - The time will be used as specified by the CURLOPT_TIMEVALUE - option, or by default the TIMECOND_IFMODSINCE will be used. + <parameter>CURLOPT_TIMEVALUE</parameter>: העבר ערך מסוג long + כפרמטר שהוא הזמן בשניות מאז January 1st, 1970. + היחס לזמן זה יהיה כפי שהוגדר באפשרות CURLOPT_TIMEVALUE + , או על פי ברירת המחדל TIMECOND_IFMODSINCE. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_RETURNTRANSFER</parameter>: Pass a non-zero - value if you want cURL to directly return the transfer instead - of printing it out directly. + <parameter>CURLOPT_RETURNTRANSFER</parameter>: העבר ערך השונה מאפס + אם על cURL להחזיר את המידע ישירות במקום לבצע + הדפסה של המידע. </simpara> </listitem> </itemizedlist> </para> <para> - The <parameter>value</parameter> parameter should be a string for - the following values of the <parameter>option</parameter> - parameter: + המשתנה <parameter>value</parameter> צריך להיות מסוג string + בשביל הערכים הבאים של המשתנה <parameter>option</parameter> : <itemizedlist> <listitem> <simpara> - <parameter>CURLOPT_URL</parameter>: This is the URL that you - want PHP to fetch. You can also set this option when - initializing a session with the <function>curl_init</function> - function. + <parameter>CURLOPT_URL</parameter>: זהו ה URL שברצונך + ש PHP תביא. ניתן לקבוע את הערך גם בזמן אתחול + session עם פונקציית <function>curl_init</function> . </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_USERPWD</parameter>: Pass a string - formatted in the [username]:[password] manner, for PHP to use - for the connection. connection. + <parameter>CURLOPT_USERPWD</parameter>: העבר ערך מסוג string + בפורמט [username]:[password] , כדי ש PHP תשתמש + בו עבור ההתחברות. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_PROXYUSERPWD</parameter>: Pass a string - formatted in the [username]:[password] format for connection - to the HTTP proxy. + <parameter>CURLOPT_PROXYUSERPWD</parameter>: העבר ערך מסוג string + בפורמט [username]:[password] , להתחברות ל HTTP proxy. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_RANGE</parameter>: Pass the specified range - you want. It should be in the "X-Y" format, where X or Y may - be left out. The HTTP transfers also support several - intervals, separated with commas as in X-Y,N-M. + <parameter>CURLOPT_RANGE</parameter>: העבר את התחום המבוקש. + הפורמט צריך להיות "X-Y" , כאשר X או Y יכולים להיות + ריקים. העברת HTTP תומכת גם במספר פרקי זמן, + מופרדים בפסיק כגון : X-Y,N-M. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_POSTFIELDS</parameter>: Pass a string - containing the full data to post in an HTTP "POST" operation. + <parameter>CURLOPT_POSTFIELDS</parameter>: העבר ערך מסוג string + המכיל את מלוא המידע שיש לשלוח בפעולת HTTP "POST" . </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_REFERER</parameter>: Pass a string - containing the "referer" header to be used in an HTTP request. + <parameter>CURLOPT_REFERER</parameter>: העבר ערך מסוג string + המכיל את ה "referer" header לשימוש ב HTTP request. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_USERAGENT</parameter>: Pass a string - containing the "user-agent" header to be used in an HTTP - request. + <parameter>CURLOPT_USERAGENT</parameter>: העבר ערך מסוג string + המכיל את ה "user-agent" header לשימוש ב HTTP request. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_FTPPORT</parameter>: Pass a string - containing the which will be used to get the IP address to use - for the ftp "POST" instruction. The POST instruction tells - the remote server to connect to our specified IP address. The - string may be a plain IP address, a hostname, a network - interface name (under UNIX), or just a plain '-' to use the - systems default IP address. + <parameter>CURLOPT_FTPPORT</parameter>: העבר ערך מסוג string + המציין כיצד יש להשיג את כתובת ה IP שתשמש את ה ftp עבור "POST". + ההוראה POST מציינת לשרת המרוחק להתחבר לכתובת ה IP המצוינת. + הערך יכול להיות כתובת IP רגילה, שם מחשב מארח, a network + interface name (under UNIX), או '-' כדי לציין את כתובת ה IP + שהיא ברירת המחדל של המערכת. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_COOKIE</parameter>: Pass a string - containing the content of the cookie to be set in the HTTP - header. + <parameter>CURLOPT_COOKIE</parameter>: העבר ערך מסוג string + המכיל את תוכן ה cookie שתשלח ב HTTP header. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_SSLCERT</parameter>: Pass a string - containing the filename of PEM formatted certificate. + <parameter>CURLOPT_SSLCERT</parameter>: העבר ערך מסוג string + המכיל את שם קובץ ה PEM formatted certificate. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Pass a string - containing the password required to use the CURLOPT_SSLCERT - certificate. + <parameter>CURLOPT_SSLCERTPASSWD</parameter>: העבר ערך מסוג string + המכיל את הסיסמה הנדרשת כדי להשתמש ב CURLOPT_SSLCERT certificate. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_COOKIEFILE</parameter>: Pass a string - containing the name of the file containing the cookie data. - The cookie file can be in Netscape format, or just plain - HTTP-style headers dumped into a file. + <parameter>CURLOPT_COOKIEFILE</parameter>: העבר ערך מסוג string + המכיל את שם הקובץ המכיל את תוכן ה cookie. + קובץ ה cookie יכול להיות בפורמט Netscapeת או ב HTTP-style headers + רגילים שנשמרו בקובץ. </simpara> </listitem> <listitem> <para> - <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Pass a string to - be used instead of <literal>GET</literal> or - <literal>HEAD</literal> when doing an HTTP request. This is - useful for doing <literal>DELETE</literal> or other, more - obscure, HTTP requests. Valid values are things like - <literal>GET</literal>, <literal>POST</literal>, and so on; - i.e. do not enter a whole HTTP request line here. For instance, - entering 'GET /index.html HTTP/1.0\r\n\r\n' would be incorrect. + <parameter>CURLOPT_CUSTOMREQUEST</parameter>: העבר ערך מסוג string + לשימוש במקום <literal>GET</literal> או + <literal>HEAD</literal> כאשר מבצעים פעולת HTTP request. + אפשרות זו שימושית כאשר מבצעים <literal>DELETE</literal> או כל פעולה +אחרת + מסוג HTTP request . ערכים אפשריים הם ערכים כגון + <literal>GET</literal>, <literal>POST</literal>, וכך הלאה; + שים לב: אין להעביר שורת HTTP request מלאה כאן. + לדוגמא, העברת 'GET /index.html HTTP/1.0\r\n\r\n' תהיה לא נכונה. <note> <simpara> - Don't do this without making sure your server supports the - command first. + אין לבצע פעולה זו לפני שמוודאים כי השרת אכן תומך בפקודה. </simpara> </note> </para> </listitem> <listitem> <para> - <parameter>CURLOPT_PROXY</parameter>: Give the name of the HTTP - proxy to tunnel requests through. + <parameter>CURLOPT_PROXY</parameter>: ציין את שם ה HTTP + proxy שהבקשות יועברו דרכו. </para> </listitem> <listitem> <para> - <parameter>CURLOPT_INTERFACE</parameter>: Pass the name of the - outgoing network interface to use. This can be an interface name, - an IP address or a host name. + <parameter>CURLOPT_INTERFACE</parameter>: ציין את שם + ה network interface היוצא שיש להשתמש בו. + הערך יכול להיות שם interface ,כתובת IP או שם מחשב מארח. </para> </listitem> <listitem> <para> - <parameter>CURLOPT_KRB4LEVEL</parameter>: Pass the KRB4 (Kerberos - 4) security level. This anyone of the following strings (in - order from least powerful, to most powerful): 'clear', 'safe', - 'confidential', 'private'. If the string does not match one of - these, then 'private' is used. If you set this to NULL, - this disables KB4 security. KB4 security only works with FTP - transactions currently. + <parameter>CURLOPT_KRB4LEVEL</parameter>: העבר את רמת האבטחה + KRB4 (Kerberos 4). הערך יכול להיות כל אחד מהערכים הבאים + (מהחלשה מבין האפשרויות, לחזקה מביניהם): 'clear', 'safe', + 'confidential', 'private'. אם הערך אינו תואם את אחד מהערכים האילו + , אזי 'private' תהיה בשימוש. אם הערך נקבע ל NULL, + אבטחת KB4 תהיה מנוטרלת. אבטחת KB4 עובדת כרגע רק עם העברות FTP . </para> </listitem> <listitem> <para> - <parameter>CURLOPT_HTTPHEADER</parameter>: Pass an array of HTTP - header fields to set. + <parameter>CURLOPT_HTTPHEADER</parameter>: העבר מערך שלשדות + ה HTTP header שאותם ברצונך לקבוע. </para> </listitem> <listitem> <para> - <parameter>CURLOPT_QUOTE</parameter>: Pass an array of FTP commands - to perform on the server prior to the FTP request. + <parameter>CURLOPT_QUOTE</parameter>: העבר מערך של פקודות FTP + שיש לצע על השרת המרוחק לפני ביצוע בקשת ה FTP. </para> </listitem> <listitem> <para> - <parameter>CURLOPT_POSTQUOTE</parameter>: Pass an array of FTP - commands to execute on the server, after the FTP request has been - performed. + <parameter>CURLOPT_POSTQUOTE</parameter>: העבר מערך של פקודות FTP + שיש לצע על השרת המרוחק אחרי ביצוע בקשת ה FTP. </para> </listitem> </itemizedlist> </para> <para> - The following options expect a file descriptor that is obtained - by using the <function>fopen</function> function: + האפשרויות הבאות מצפות ל file descriptor שהושג תוך שימוש + בפונקציית <function>fopen</function> : <itemizedlist> <listitem> <simpara> - <parameter>CURLOPT_FILE</parameter>: The file where the output - of your transfer should be placed, the default is STDOUT. + <parameter>CURLOPT_FILE</parameter>: הקובץ אליו הפלט + של ההעברה ינותב, ברירת המחדל היא STDOUT. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_INFILE</parameter>: The file where the - input of your transfer comes from. + <parameter>CURLOPT_INFILE</parameter>: הקובץ ממנו הקלט + של ההעברה מגיע. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_WRITEHEADER</parameter>: The file to write - the header part of the output into. + <parameter>CURLOPT_WRITEHEADER</parameter>: הקובץ אליו יש לרשום + את חלק ה header של הפלט. </simpara> </listitem> <listitem> <simpara> - <parameter>CURLOPT_STDERR</parameter>: The file to write - errors to instead of stderr. + <parameter>CURLOPT_STDERR</parameter>: הקובץ אליו יש לרשום + את השגיאות במקום stderr. </simpara> </listitem> </itemizedlist> @@ -502,18 +488,17 @@ <refentry id="function.curl-exec"> <refnamediv> <refname>curl_exec</refname> - <refpurpose>Perform a CURL session</refpurpose> + <refpurpose>ביצוע CURL session</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>bool</type><methodname>curl_exec</methodname> <methodparam><type>int</type><parameter>ch</parameter></methodparam> </methodsynopsis> <para> - This function is should be called after you initialize a CURL - session and all the options for the session are set. Its purpose - is simply to execute the predefined CURL session (given by the + יש לקרוא לפונקציה זו לאחר שאותחל CURL session וכל האפשרויות שלה + נקבעו. מטרתה היא לבצע את ה CURL session שנקבע מראש (ומצוין על ידי <parameter>ch</parameter>). </para> &tip.ob-capture; @@ -523,17 +508,17 @@ <refentry id="function.curl-close"> <refnamediv> <refname>curl_close</refname> - <refpurpose>Close a CURL session</refpurpose> + <refpurpose>סגירת CURL session</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>void</type><methodname>curl_close</methodname> <methodparam><type>int</type><parameter>ch</parameter></methodparam> </methodsynopsis> <para> - This function closes a CURL session and frees all resources. - The CURL handle, <parameter>ch</parameter>, is also deleted. + הפונקציה סוגרת CURL session ומשחררת את כל המשאבים. + ה CURL handle, <parameter>ch</parameter>, נמחק אף הוא. </para> </refsect1> </refentry> @@ -541,17 +526,17 @@ <refentry id="function.curl-version"> <refnamediv> <refname>curl_version</refname> - <refpurpose>Return the current CURL version</refpurpose> + <refpurpose>מחזירה את גירסת ה CURL הנוכחית</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>string</type><methodname>curl_version</methodname> <void/> </methodsynopsis> <para> - The <function>curl_version</function> function returns a string - containing the current CURL version. + הפונקציה <function>curl_version</function> מחזירה ערך מסוג string + המכיל את גירסת CURL הנוכחית. </para> </refsect1> </refentry> @@ -559,10 +544,10 @@ <refentry id='function.curl-errno'> <refnamediv> <refname>curl_errno</refname> - <refpurpose>Return an integer containing the last error number</refpurpose> + <refpurpose>מחזירה מספר מסוג integer המכיל את מספר ה error האחרון</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>int</type><methodname>curl_errno</methodname> <methodparam><type>int</type><parameter>ch</parameter></methodparam> @@ -577,11 +562,11 @@ <refnamediv> <refname>curl_error</refname> <refpurpose> - Return a string contain the last error for the current session - </refpurpose> + מחזירה ערך מסוג string המכיל את ה error האחרון ב session הנוכחי + </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>string</type><methodname>curl_error</methodname> <methodparam><type>int</type><parameter>ch</parameter></methodparam> @@ -596,11 +581,11 @@ <refnamediv> <refname>curl_getinfo</refname> <refpurpose> - Get information regarding a specific transfer + הבא את המידע על העברה מסוימת </refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>תיאור</title> <methodsynopsis> <type>string</type><methodname>curl_getinfo</methodname> <methodparam><type>int</type><parameter>ch</parameter></methodparam>