gerzson Tue Feb 19 04:36:23 2002 EDT
Modified files:
/phpdoc/hu/functions url.xml exec.xml mail.xml
Log:
sync with EN revision
Index: phpdoc/hu/functions/url.xml
diff -u phpdoc/hu/functions/url.xml:1.7 phpdoc/hu/functions/url.xml:1.8
--- phpdoc/hu/functions/url.xml:1.7 Sat Feb 2 10:41:26 2002
+++ phpdoc/hu/functions/url.xml Tue Feb 19 04:36:22 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.15 Maintainer: goba Status: ready -->
+<!-- EN-Revision: 1.27 Maintainer: goba Status: ready -->
<reference id="ref.url">
<title>URL függvények</title>
@@ -40,12 +40,13 @@
</methodsynopsis>
<para>
A <function>base64_encode</function> visszaadja a
- <parameter>data</parameter> paraméterben megadott adatot base64 kódolással.
- A kódolást úgy tervezték, hogy a bináris adatok is túléljék az olyan
- közvetítő csatornákat, amik nem képesek 8 bites adattovábbításra (pl. mail
üzenetek).
+ <parameter>data</parameter> paraméterben megadott adat base64 kódolt
+ alakját. A kódolást úgy tervezték, hogy a bináris adatok is túléljék
+ az olyan közvetítő csatornákat, amelyek nem képesek 8 bites
+ adattovábbításra (pl. mail üzenetek).
</para>
<para>
- A base64-kódolt adat 33%-al nagyobb, mint az eredeti adat.
+ A base64-kódolt adat megközelítőleg 33%-kal nagyobb az eredeti méreténél.
</para>
<para>
Lásd még: <function>base64_decode</function>,
@@ -66,13 +67,54 @@
<methodparam><type>string</type><parameter>url</parameter></methodparam>
</methodsynopsis>
<para>
- Ez a függvény egy asszociatív tömböt ad vissza, ami tartalmazhatja
- az alábbi elemek közül azokat, amik az URL-ben megtalálhatóak:
- "scheme" [pl. http://], "host", "port",
- "user" [FTP URL, vagy HTTP azonosítás esetén],
- "pass" [FTP URL, vagy HTTP azonosítás esetén],
- "path", "query" [kérdőjel utáni rész], és
- "fragment" [A # utáni rész].
+ Ez a függvény olyan asszociatív tömböt ad vissza, amely tartalmazza az
+ alábbi elemek közül azokat, amelyek az <parameter>url</parameter>
+ részei:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <structfield>scheme</structfield> - pl.: http://
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>host</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>port</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>user</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>pass</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>path</structfield>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>query</structfield> - <literal>?</literal> utáni rész
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <structfield>fragment</structfield> - <literal>#</literal> utáni rész
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ Lásd még: <function>pathinfo</function>!
</para>
</refsect1>
</refentry>
@@ -89,16 +131,22 @@
<methodparam><type>string</type><parameter>str</parameter></methodparam>
</methodsynopsis>
<para>
- Visszaad egy karakterláncot, amiben százalékjelet
- (<literal>%</literal>) és két hexa értéket használó
- kódolás szerinti sorozatok az eredeti karakterekkel
- helyettesítődnek. Például a <screen>foo%20bar%40baz</screen>
- karaktersorozat dekódoltja <screen>foo bar@baz</screen>.
- </para>
+ A <parameter>str</parameter>-ben megadott sztringet visszakódolja úgy, hogy
+ minden százalékjelet (<literal>%</literal>) és utána álló két hexadecimális
+ számjegyet a megjelölt sorszámú karakterrel cserél fel. Például
+ a <screen>foo%20bar%40baz</screen>
+ karaktersorozatból <screen>foo bar@baz</screen> lesz.
+ </para>
+ <note>
+ <para>
+ <function>rawurldecode</function> nem cseréli le a plusz jelet ('+')
+ szóközzé, amint azt az <function>urldecode</function> teszi.
+ </para>
+ </note>
<simpara>
Lásd még: <function>rawurlencode</function>,
- <function>urldecode</function>,
- <function>urlencode</function>.
+ <function>urldecode</function> és
+ <function>urlencode</function>!
</simpara>
</refsect1>
</refentry>
@@ -115,13 +163,14 @@
<methodparam><type>string</type><parameter>str</parameter></methodparam>
</methodsynopsis>
<para>
- Visszaad egy karakterláncot, ahol minden nem-alfanumerikus karakter,
- kivéve a <screen>-_.</screen> karaktereket, egy szézalékjelre
- (<literal>%</literal>) és azt követő két hexa számjegyre cserélődik.
- Ez az RFC1738-ben leírt kódolás, ami feloldja a speciális karakterek
- okozta problémát az URL-ekben, illetve a közvetítő média által
- végrehajtott kódolás okozta hibákat kiküszöböli. Például ha egy
- jelszót kell elhelyezni egy FTP URL-ben:
+ Olyan stringgel tér vissza, amelyben az <parameter>str</parameter> nem
+ alfanumerikus karakterei - kivéve a <screen>-_.</screen> karaktereket -
+ egy szézalékjelre (<literal>%</literal>) és azt követő két hexadecimális
+ számjegyre lesz lecserélve. Ez az RFC1738-ben leírt kódolásnak megfelelő,
+ amely feloldja a speciális karakterek az URL-ekben történő használatát
+ nehezítő problémát, illetve a közvetítő média által végrehajtott kódolás
+ okozta hibákat kiküszöböli. Ha egy jelszót kell például elhelyezni egy FTP
+ URL-ben:
<example>
<title>Első <function>rawurlencode</function> példa</title>
<programlisting role="php">
@@ -131,7 +180,8 @@
]]>
</programlisting>
</example>
- De előfordulhat, hogy az URL PATH_INFO komponensében kell adatot átadni:
+ Előfordulhat azonban, hogy az URL PATH_INFO komponensében kell adatot
+ átadni:
<example>
<title>Második <function>rawurlencode</function> példa</title>
<programlisting role="php">
@@ -144,8 +194,8 @@
</para>
<simpara>
Lásd még: <function>rawurldecode</function>,
- <function>urlencode</function>,
- <function>urldecode</function>.
+ <function>urlencode</function> és
+ <function>urldecode</function>!
</simpara>
</refsect1>
</refentry>
@@ -181,7 +231,7 @@
</example>
</para>
<para>
- Lásd még: <function>urlencode</function>.
+ Lásd még: <function>urlencode</function>!
</para>
</refsect1>
</refentry>
@@ -244,8 +294,8 @@
<para>
Lásd még: <function>urldecode</function>,
<function>htmlentities</function>,
- <function>rawurldecode</function>,
- <function>rawurlencode</function>.
+ <function>rawurldecode</function> és
+ <function>rawurlencode</function>!
</para>
</refsect1>
</refentry>
@@ -267,5 +317,7 @@
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
-->
-
Index: phpdoc/hu/functions/exec.xml
diff -u phpdoc/hu/functions/exec.xml:1.8 phpdoc/hu/functions/exec.xml:1.9
--- phpdoc/hu/functions/exec.xml:1.8 Sat Feb 2 10:41:24 2002
+++ phpdoc/hu/functions/exec.xml Tue Feb 19 04:36:22 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.17 Maintainer: goba Status: ready -->
+<!-- EN-Revision: 1.27 Maintainer: goba Status: ready -->
<reference id="ref.exec">
<title>Programfuttató függvények</title>
@@ -27,26 +27,29 @@
<methodparam><type>string</type><parameter>arg</parameter></methodparam>
</methodsynopsis>
<para>
- Az <function>escapeshellarg</function> aposztrófokat tesz a paraméterben
- átadott karakterlánc köré és escape-eli a karakterláncban lévő aposztrófokat,
- így egy shell függvény önálló paramétereként használható karaktersorozatot ad
- vissza. Ez a függvény használatos a felhasználótól érkező egyedi shell függvény
- paraméterek biztonságossá alakítására. Shell függvények az
- <function>exec</function>, <function>system</function> és a
- <link linkend="language.operators.execution">végrehajtó operátor</link>.
- Egy tipikus használat:
+ Az <function>escapeshellarg</function> aposztrófok közé fogja az
+ <parameter>arg</parameter> paraméterben átadott szöveget és megkettőzi a
+ benne lévő aposztrófokat, így egy parancsértelmező függvények önálló
+ paramétereként használható karaktersorozatot ad vissza. Ez a függvény
+ használatos a felhasználótól érkező egyedi parancsértelmező függvények
+ paramétereinek biztonságossá alakítására. Ezek a fügvények : az
+ <function>exec</function>, a <function>system</function> és a <link
+ linkend="language.operators.execution">végrehajtó operátor</link>.
+ Jellemző használata:
</para>
<para>
<informalexample>
<programlisting role="php">
+<![CDATA[
system("ls ".escapeshellarg($dir));
+]]>
</programlisting>
</informalexample>
</para>
<para>
Lásd még: <function>exec</function>, <function>popen</function>,
- <function>system</function>, és a <link
- linkend="language.operators.execution">végrehajtó operátor</link>.
+ <function>system</function> és a <link
+ linkend="language.operators.execution">végrehajtó operátor</link>!
</para>
</refsect1>
</refentry>
@@ -65,11 +68,10 @@
<para>
Az <function>escapeshellcmd</function> escape-et alkalmaz minden
speciális karakterre, ami nem kívánt parancsok futtatását okozná.
- Ezt a függvény arra használhatod, hogy a felhasználóktól
- érkező információt biztonságossá tedd, mielőtt egy
- <function>exec</function> vagy <function>system</function>
+ Ez a függvény arra használható, hogy biztosítsd a felhasználótól érkező adat
+ tisztaságát egy <function>exec</function> vagy egy <function>system</function>
függényhívásnál, vagy egy <link linkend="language.operators.execution">végrehajtó
- operátorban</link> használnád. Egy tipikus használati forma:
+ operátorban</link> használnád. Általános használati forma:
</para>
<para>
<informalexample>
@@ -86,7 +88,7 @@
<para>
Lásd még: <function>escapeshellarg</function>, <function>exec</function>,
<function>popen</function>, <function>system</function>
- és a <link linkend="language.operators.execution">végrehajtó operátor</link>.
+ és a <link linkend="language.operators.execution">végrehajtó operátor</link>!
</para>
</refsect1>
</refentry>
@@ -105,47 +107,46 @@
<methodparam
choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
</methodsynopsis>
<para>
- Az <function>exec</function> lefuttatja a megadott
- <parameter>command</parameter> parancsot, habár nem ír ki semmit,
- csak egyszerűen visszaadja a legutolsó sort, amit a parancs
- generált. Ha úgy szeretnél futtatni egy parancsot, hogy az
- minden adatfeldolgozás nélkül kiírása kerüljön, használd
- a <function>passthru</function> függvényt.
- </para>
- <para>
- Ha az <parameter>array</parameter> paramétert megadtad,
- a kimenetet soronként a tömb végére fűzi a PHP.
- Ha egy már létező tömböt adsz meg, az
- <function>exec</function> a benne lévő adatok után fűzi a sorokat.
- Ha nem szeretnéd, hogy megmaradjon a tömb előző tartalma, használd az
- <function>unset</function> függvényt, mielőtt meghívod az
- <function>exec</function>-et.
- </para>
- <para>
- Ha a <parameter>return_var</parameter> paraméter definiált,
- az <parameter>array</parameter> paraméterrel együtt, akkor
- a parancs visszatérés-ideji állapota ebbe a változóba kerül.
- </para>
- <para>
- Ha egy felhasználó által beadott adatot szeretnél átadni
- ennek a függvénynek, használd az
- <function>escapeshellcmd</function> függvényt, hogy biztos
- lehess benne, hogy nem tudnak a felhasználók tetszőleges
- parancsot futtatni.
- </para>
- <para>
- Ha ezzel a függvénnyel el szeretnél indítani egy programot,
- amit utána a háttérben futni hagsz, meg kell róla győződnöd,
- hogy a program kimenete egy file-ba kerül átirányításra,
- vagy valamilyen más kimeneti csatornára. Ellenkező esetben
- a PHP várakozni fog addig, amíg a program futása be nem
- fejeződött.
- </para>
+ Az <function>exec</function> lefuttatja a
+ <parameter>command</parameter>-ban megadott parancsot, amely így nem ír ki
+ semmit, csak egyszerűen visszaadja a legutolsó sort, amit a parancs
+ generált. A <function>passthru</function> függvény használható arra, hogy
+ a parancs eredménye minden adatfeldolgozás nélkül kiírása kerüljön.
+ </para>
+ <para>
+ Az <parameter>array</parameter> paraméter megadásával a program kimenetét
+ a PHP soronként a megadott tömb végéhez fűzi. Ha az átadott tömb már
+ tartalmaz néhány elemet, akkor az <function>exec</function> a benne lévő
+ adatok után fűzi a sorokat. Ha nincs szükség a régi elemekre, akkor az
+ <function>unset</function> függvénnyel lehet törölni az egész tömböt,
+ az <function>exec</function> meghívása előtt.
+ </para>
+ <para>
+ Az <parameter>array</parameter> paraméterrel együtt a
+ <parameter>return_var</parameter> a futtatott parancs visszatérési
+ állapotát tárolja el.
+ </para>
+ <warning>
+ <para>
+ Ha felhasználótól származó adatot kell átadni ennek a függvénynek, akkor
+ előtte használd az <function>escapeshellcmd</function> függvényt, annak
+ biztosítására, hogy nem tudnak a felhasználók tetszőleges parancsot
+ futtatni.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Ezzel a függvénnyel elindított de háttérben futó program kimenetét
+ mindenképpen fájlba vagy valamilyen más kimeneti csatornába kell
+ átirányítani. Ellenkező esetben a PHP várakozni fog addig, amíg a
+ program futása be nem fejeződik.
+ </para>
+ </note>
<para>
Lásd még: <function>system</function>,
<function>passthru</function>, <function>popen</function>,
<function>escapeshellcmd</function> és a
- <link linkend="language.operators.execution">végrehajtó operátor</link>.
+ <link linkend="language.operators.execution">végrehajtó operátor</link>!
</para>
</refsect1>
</refentry>
@@ -166,33 +167,38 @@
</methodsynopsis>
<para>
A <function>passthru</function> függvény hasonló az
- <function>exec</function>-hez, ugyanis a
- <parameter>command</parameter> paraméterben megadott parancsot
- futtatja. Ha a <parameter>return_var</parameter> paraméter
- adott, akkor a parancs visszatérés-ideji állapota
- ebbe a változóba kerül. Ezt a függvényt használd az
- <function>exec</function> vagy <function>system</function>
- helyett, ha a parancs kimenete bináris adat, amit közvetlenül
- a böngészőnek kell visszaküldeni. Tipikusan például
- a pbmplus eszközök futtatására használható, amik képesek
- közvetlenül kép visszaadására. Ha a Content-type fejlécet
- <emphasis>image/gif</emphasis>-re állítod, és meghívod
- a pbmplus programot, ami visszaad egy képet, készíthetsz
- olyan PHP programot, ami közevtelnül képet ad vissza.
- </para>
- <para>
- Ha ezzel a függvénnyel el szeretnél indítani egy programot,
- amit utána a háttérben futni hagsz, meg kell róla győződnöd,
- hogy a program kimenete egy file-ba kerül átirányításra,
- vagy valamilyen más kimeneti csatornára. Ellenkező esetben
- a PHP várakozni fog addig, amíg a program futása be nem
- fejeződött.
- </para>
+ <function>exec</function>-hez, ugyanis a <parameter>command</parameter>
+ paraméterben megadott parancsot futtatja. A <parameter>return_var</parameter>
+ paraméterben a parancs visszatérési állapota kerül. Ez a függvény
+ használható az <function>exec</function> vagy a <function>system</function>
+ helyett, ha a parancs kimenete bináris adat, amit közvetlenül a böngészőnek
+ kell visszaküldeni. Tipikusan például a pbmplus eszközök futtatására
+ használható, amelyek képesek közvetlenül kép visszaadására. A
+ <literal>Content-type</literal> fejlécet <emphasis>image/gif</emphasis>-re
+ állítva és a pbmplus programot meghívva, az visszaad egy képet, és így olyan
+ PHP programot írhatók, amelyek közvetlenül képeket adnak vissza.
+ </para>
+ <warning>
+ <para>
+ Ha felhasználótól származó adatot kell átadni ennek a függvénynek, akkor
+ előtte használd az <function>escapeshellcmd</function> függvényt, annak
+ biztosítására, hogy nem tudnak a felhasználók tetszőleges parancsot
+ futtatni.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Ezzel a függvénnyel elindított de háttérben futó program kimenetét
+ mindenképpen fájlba vagy valamilyen más kimeneti csatornába kell
+ átirányítani. Ellenkező esetben a PHP várakozni fog addig, amíg a
+ program futása be nem fejeződik.
+ </para>
+ </note>
<para>
Lásd még: <function>exec</function>, <function>system</function>,
- <function>popen</function>, <function>escapeshellcmd</function>,
+ <function>popen</function>, <function>escapeshellcmd</function>
és a <link linkend="language.operators.execution">végrehajtó
- operátor</link>.
+ operátor</link>!
</para>
</refsect1>
</refentry>
@@ -206,36 +212,37 @@
</refnamediv>
<refsect1>
<title>Leírás</title>
- <methodsynopsis>
- <type>string</type><methodname>system</methodname>
- <methodparam><type>string</type><parameter>command</parameter></methodparam>
- <methodparam
choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
- </methodsynopsis>
+ <methodsynopsis>
+ <type>string</type><methodname>system</methodname>
+ <methodparam><type>string</type><parameter>command</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
+ </methodsynopsis>
<para>
A <function>system</function> függvény olyan, mint
- C-beli testvére, azaz a <parameter>command</parameter>
+ C-beli társa, azaz a <parameter>command</parameter>
paraméterben megadott parancsot futtaja, és kiírja a kimenetet.
- Ha második paraméterként megadsz egy változót, a visszatérés-ideji
- állapot abba a változóba kerül.
- </para>
- <para>
- Ha egy felhasználó által beadott adatot szeretnél átadni
- ennek a függvénynek, használd az
- <function>escapeshellcmd</function> függvényt, hogy biztos
- lehess benne, hogy nem tudnak a felhasználók tetszőleges
- parancsot futtatni.
- </para>
- <para>
- Ha ezzel a függvénnyel el szeretnél indítani egy programot,
- amit utána a háttérben futni hagsz, meg kell róla győződnöd,
- hogy a program kimenete egy file-ba kerül átirányításra,
- vagy valamilyen más kimeneti csatornára. Ellenkező esetben
- a PHP várakozni fog addig, amíg a program futása be nem
- fejeződött.
+ A <parameter>return_var</parameter> paraméterben a parancs visszatérési
+ állapota kerülhet, ha szerepel.
</para>
+ <warning>
+ <para>
+ Ha felhasználótól származó adatot kell átadni ennek a függvénynek, akkor
+ előtte használd az <function>escapeshellcmd</function> függvényt, annak
+ biztosítására, hogy nem tudnak a felhasználók tetszőleges parancsot
+ futtatni.
+ </para>
+ </warning>
+ <note>
+ <para>
+ Ezzel a függvénnyel elindított de háttérben futó program kimenetét
+ mindenképpen fájlba vagy valamilyen más kimeneti csatornába kell
+ átirányítani. Ellenkező esetben a PHP várakozni fog addig, amíg a
+ program futása be nem fejeződik.
+ </para>
+ </note>
<para>
A <function>system</function> függvény automatikusan üríteni
- próbálja a szerver kimeneti bufferét minden kiadott sor után,
+ próbálja a szerver kimeneti pufferét minden kiadott sor után,
ha a PHP szerver modulként fut.
</para>
<para>
@@ -243,18 +250,38 @@
vagy &false; értéket ha hiba történik.
</para>
<para>
- Ha le kell futtatnod egy parancsot, és ki kell adnod minden
- kimenetét feldolgozás nélkül, használd az
- <function>passthru</function> függvényt.
+ A <function>passthru</function> függvény használható arra, hogy a
+ parancs eredménye minden adatfeldolgozás nélkül kiírása kerüljön.
</para>
<para>
Lásd még: <function>exec</function>,
<function>passthru</function>, <function>popen</function>,
<function>escapeshellcmd</function> és a
- <link linkend="language.operators.execution">végrehajtó operátor</link>.
+ <link linkend="language.operators.execution">végrehajtó operátor</link>!
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.shell-exec'>
+ <refnamediv>
+ <refname>shell_exec</refname>
+ <refpurpose>
+ lefuttat parancsértelmezőben egy parancsot és a teljes kimenetet visszaadja
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Leírás</title>
+ <methodsynopsis>
+ <type>string</type><methodname>shell_exec</methodname>
+ <methodparam><type>string</type><parameter>cmd</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Ez a függvény azonos a <link
+ linkend="language.operators.execution">végrehajtó operátorral</link>.
</para>
</refsect1>
</refentry>
+
</reference>
<!-- Keep this comment at the end of the file
@@ -273,5 +300,7 @@
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
-->
-
Index: phpdoc/hu/functions/mail.xml
diff -u phpdoc/hu/functions/mail.xml:1.7 phpdoc/hu/functions/mail.xml:1.8
--- phpdoc/hu/functions/mail.xml:1.7 Sat Feb 2 10:41:25 2002
+++ phpdoc/hu/functions/mail.xml Tue Feb 19 04:36:23 2002
@@ -1,12 +1,66 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.9 Maintainer: goba Status: ready -->
+<!-- EN-Revision: 1.37 Maintainer: goba Status: ready -->
+<!-- CREDITS: gerzson -->
<reference id="ref.mail">
<title>Mail függvények</title>
<titleabbrev>Mail</titleabbrev>
<partintro>
- <simpara>
- A <function>mail</function> függvény ad lehetőséget email küldésére.</simpara>
+ <simpara>
+ A <function>mail</function> függvény ad lehetőséget email küldésére.
+ </simpara>
+ <variablelist>
+ <title>Levelezés beállítási lehetőségei</title>
+
+ <varlistentry id="ini.smtp">
+ <term>
+ <parameter>SMTP</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ A DNS neve vagy IP címe annak az SMTP szervernek, amit a PHP Windows alatt
+ a mail küldésre használ, amikor a <function>mail</function>
+ függvényt hívod meg.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.sendmail-from">
+ <term>
+ <parameter>sendmail_from</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Megadja, hogy milyen "From:" email címet használjon
+ a PHP mail küldésekor Windows alatt.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.sendmail-path">
+ <term>
+ <parameter>sendmail_path</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ Megadja, hogy hol található a <command>sendmail</command> program.
+ Ez általában <filename>/usr/sbin/sendmail</filename> vagy
+ <filename>/usr/lib/sendmail</filename>.
+ A <command>configure</command> megpróbálja megtalálni, és
+ beállítani, de ha ez nem sikerül, itt te is beállíthatod.
+ </para>
+ <para>
+ Azokon a rendszereken, ahol nem a sendmail használatos, ez a beállítás a
+ sendmail wrapper/helyettesítő beállítására szolgál, ha van ilyen.
+ Például a <ulink url="&url.qmail;">Qmail</ulink>
+ használók általában a
+ <filename>/var/qmail/bin/sendmail</filename> beállítást használják.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
</partintro>
@@ -25,83 +79,151 @@
<methodparam choice="opt"><type>string</type><parameter>additional_headers
</parameter></methodparam>
</methodsynopsis>
- <simpara>
+ <simpara>
A <function>mail</function> automatikusan a
<parameter>message</parameter> paraméterben megadott levelet
a <parameter>to</parameter> paraméterben megadott címzettnek.
A levél témamegjelölését a <parameter>subject</parameter>
határozza meg. Több címzettet is megadhatsz, ha vesszőt
teszel a címzettek listájában az email címek közé
- a <parameter>to</parameter> paraméterében.
+ a <parameter>to</parameter> paraméterében. Levélmellékletek és egyéb
+ különleges tartalmú levelek küldésére is használható ez a függvény.
+ Ezeket a MIME kódolással érhetők el, amelyről részletesebb leírást
+ egy <ulink url="&url.email.mime.zend;">Zend cikkben</ulink> vagy
+ a <ulink url="&url.email.mime.pear;">PEAR Mime Classes</ulink> c.
+ található.
+ </simpara>
+ <simpara>
+ A követkeő RFC-k is számos segítséget nyújthatnak:
+ <ulink url="&url.rfc1896;">RFC 1896</ulink>,
+ <ulink url="&url.rfc2045;">RFC 2045</ulink>,
+ <ulink url="&url.rfc2046;">RFC 2046</ulink>,
+ <ulink url="&url.rfc2047;">RFC 2047</ulink>,
+ <ulink url="&url.rfc2048;">RFC 2048</ulink> és
+ <ulink url="&url.rfc2049;">RFC 2049</ulink>.
+ </simpara>
+ <para>
+ A <function>mail</function> &true;-val tér vissza, ha levelet sikeresen
+ elküldte máskülönben &false;-szal.
+ </para>
+ <para>
+ <example>
+ <title>Email küldése</title>
+ <programlisting>
+<![CDATA[
+mail("[EMAIL PROTECTED]", "Témamegjelölés", "Első sor\nMásodik sor\nHarmadik sor");
+]]>
+ </programlisting>
+ </example></para>
+ <simpara>
+ A negyedik paraméter megadott szöveg az email fejléc végére
+ kerül. Ez nagyon gyakran újabb fejlécek elküldésére használható,
+ több ilyen esetén azokat az újsorkarakterrel kell elválasztani.
</simpara>
+ <note>
+ <para>
+ A fejlécek elválasztására a <literal>\r\n</literal> karaktersorozatot kell
+ használni még akkor is, ha néhány Unix levéltovábbító elem az egyszerű
+ újsorkarakterrel (<literal>\n</literal>) is beéri. A Cc:
+ fejléc kis- és nagy betűre érzékeny, így <literal>Cc:</literal> kell írni
+ Win32 rendszereken. A Bcc: fejlécet nem támogatják a Win32 rendszerek.
+ </para>
+ </note>
<para>
<example>
- <title>Email küldése</title>
+ <title>e-mail küldése kiegészítő fejlécekkel</title>
<programlisting>
<![CDATA[
-mail("[EMAIL PROTECTED]", "Témamegjelölés", "Első sor\nMásodik sor\nHarmadik sor");
+mail("[EMAIL PROTECTED]", "Téma", $uzenet,
+ "From: webmaster@$SERVER_NAME\r\n".
+ "Reply-To: webmaster@$SERVER_NAME\r\n".
+ "X-Mailer: PHP/" . phpversion());
]]>
</programlisting>
- </example></para>
- <simpara>
- Ha a negyedik paramétert is megadod, az az email fejléc végére
- kerül. Ez tipikusan plusz fejlécek elküldésére használható.
- Több plusz fejlécet az újsor karakterrel kell elválasztani.
- </simpara>
+ </example>
+ </para>
<para>
+ Az <parameter>additional_parameters</parameter> paraméter használható
+ arra, hogy a levélküldőként beállított program számára további
+ paramétereket lehessen átadni, lásd: <literal>sendmail_path</literal>).
+ Ezzel például a levél mellé a feladó 'borítékot' is küldhet a sendmail-t
+ használva. Szükség lehet a webszervert futtató felhasználót sendmail
+ beállításai közé felvenni, hogy a levelekbe ne kerüljenek
+ <literal>X-Warning</literal> fejlécek, ha ezzel a módszerrel küldesz
+ 'borítékot' a levél mellé.
<example>
- <title>Email küldése plusz fejlécekkel</title>
+ <title>Kiegészítő fejléces levél küldése és további parancssori paraméterek
+átadása</title>
<programlisting>
<![CDATA[
-mail("[EMAIL PROTECTED]", "Téma", $uzenet,
- "From: webmaster@$SERVER_NAME\nReply-To: webmaster@$SERVER_NAME\nX-Mailer: PHP/"
. phpversion());
+mail("[EMAIL PROTECTED]", "a tárgy", $uzenet,
+ "From: webmaster@$SERVER_NAME", "-fwebmaster@$SERVER_NAME");
]]>
</programlisting>
</example>
- Egyszerű string technikákat alkalmazhatsz komplex email
+ </para>
+ <note>
+ <para>
+ Az ötödik paraméter PHP 4.0.5-től elérhető.
+ </para>
+ </note>
+ <para>
+ Egyszerű sztring kezelő módszerekkel lehet összetettebb e-mail
üzenetek összeállításához:
<example>
<title>Komplexebb email küldése</title>
<programlisting>
<![CDATA[
-/* Címzettek */
-$cimzett .= "Mary <[EMAIL PROTECTED]>" . ", " ; // Figyeld a vesszőt
-$cimzett .= "Kelly <[EMAIL PROTECTED]> . ", ";
-$cimzett .= "[EMAIL PROTECTED]";
-
-/* Téma */
-$tema = "Augusztusi születésnapi emlékeztetők";
-
-/* Üzenet */
-$uzenet .= "Egy szép formázott ASCII táblázat következik\n";
-$uzenet .= "Nap \t\tHónap \t\tÉv\n";
-$uzenet .= "3. \t\tAug \t\t1970\n";
-$uzenet .= "17. \t\tAug \t\t1973\n";
-
-/* Szokványos aláírást is adhatsz a levélhez */
-$uzenet .= "--\r\n"; // Aláírást elválasztó karakterek
-$uzenet .= "A születésnapi figyelmeztető szkript szabadon másolható";
-
-/* Minden további fejléc összeállítása */
-
-$fejlecek .= "From: Szuletesnapi ertesito <[EMAIL PROTECTED]>\n";
-$fejlecek .= "X-Sender: <[EMAIL PROTECTED]>\n";
-$fejlecek .= "X-Mailer: PHP\n"; // Levelezőprogram
-$fejlecek .= "X-Priority: 1\n"; // Sürgős üzenet!
-$fejlecek .= "Return-Path: <[EMAIL PROTECTED]>\n"; // Hiba esetén ide jön levél
+/* címzettek */
+$kinek = "Mari <[EMAIL PROTECTED]>" . ", " ; // figyelj a vesszőre!
+$kinek .= "Kolos <[EMAIL PROTECTED]>";
+
+/* tárgy */
+$targy = "Augusztusi Születésnapi Emlékeztető";
+
+/* üzenet */
+$uzenet = '
+<html>
+<head>
+ <title>Augusztusi Születésnapi Emlékeztető</title>
+</head>
+<body>
+<p>Itt van az augusztusi születésnapok listája!</p>
+<table>
+ <tr>
+ <th>Személy</th><th>Év</th><th>Hónap</th><th>Nap</th>
+ </tr>
+ <tr>
+ <td>Jocó</td><td>1970</td><td>augusztus</td><td>3.</td>
+ <td>Saci</td><td>1973</td><td>augusztus</td><td>17.</td>
+ </tr>
+</table>
+</body>
+</html>
+';
+
+/* HTML levél küldése a Content-type fejléc megadásával */
+$fejlec = "MIME-Version: 1.0\r\n";
+$fejlec .= "Content-type: text/html; charset=iso-8859-2\r\n";
-/* Ha HTML levelet szeretnél küldeni, vedd ki a megjegyzést */
-// $fejlecek .= "Content-Type: text/html; charset=iso-8859-1\n"; // Mime típus
+/* további fejlécek */
+$fejlec .= "From: Szuletesnapi Emlekezteto <[EMAIL PROTECTED]>\r\n";
-$fejlecek .= "cc:[EMAIL PROTECTED]\n"; // CC címzett
-$fejlecek .= "bcc:[EMAIL PROTECTED], [EMAIL PROTECTED]\n"; // BCCs címzett
+$fejlec .= "Cc: [EMAIL PROTECTED]\r\n";
+$fejlec .= "Bcc: [EMAIL PROTECTED]\r\n";
-/* És most elküdjük TADA! [.wav] */
-mail($cimzett, $tema, $uzenet, $fejlecek);
+/* és most küldjük el! */
+mail($kinek, $targy, $uzenet, $fejlec);
]]>
</programlisting>
</example>
</para>
+ <note>
+ <para>
+ Biztosítani kell, hogy a ne legyen egyetlen újsorkarakter sem a
+ <parameter>to</parameter> vagy a <parameter>subject</parameter>
+ fejlécben, mert különben nem megfelelően lesz kiküldve a levél.
+ </para>
+ </note>
</refsect1>
</refentry>
@@ -126,7 +248,7 @@
<title>A hash kiszámítása és a felhasználó felírása a listára</title>
<programlisting>
<![CDATA[
-$felhasznalo = "[EMAIL PROTECTED]";
+$felhasznalo = "[EMAIL PROTECTED]";
$hash = ezmlm_hash ($felhasznalo);
$query = sprintf ("INSERT INTO minta VALUES (%s, '%s')", $hash, $felhasznalo);
$db->query($query); // itt éppen a PHPLIB db felületet használjuk
@@ -139,7 +261,7 @@
</reference>
- <!-- Keep this comment at the end of the file
+<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
@@ -155,5 +277,7 @@
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
-->
-
