cvs: phpdoc /hu/functions commandline.xml

tibee Mon Mar 25 14:44:41 2002 EDT Modified files: /phpdoc/hu/functions commandline.xml Log: first edition

Index: phpdoc/hu/functions/commandline.xml diff -u /dev/null phpdoc/hu/functions/commandline.xml:1.3 --- /dev/null Mon Mar 25 14:44:41 2002 +++ phpdoc/hu/functions/commandline.xml Mon Mar 25 14:44:41 2002 @@ -0,0 +1,286 @@ + +<?xml version="1.0" encoding="iso-8859-2"?> +<!-- $Revision: 1.3 $ --> +<!-- + TODO: + + The command line options not in the + list, but in the -h output below: + + -e, -z + + It would be best to document these, and + collect more info about -c and -d! +--> +<appendix id="commandline"> + <title>PHP használata a parancssorban</title> + <para> + A parancssori opciók jól jöhetnek a PHP programok fejlesztése során, + ha hibákat akarsz kiszûrni vagy tesztelni a PHP beállításaidat, de + szintén nagyon hasznosak a nem web célú PHP programok + futtatásához. + </para> + <para> + Másrészt, átirányíthatod egy PHP program kimenetét egy + külsõ fájlba a &gt; karakter segítségével, + így pl. a <literal>php -q test.php > test.html</literal> paranccsal + átirányíthatod a <filename>test.php</filename> program kimenetét + HTTP fejlécek nélkül a <filename>test.html</filename> nevû + fájlba, ugyanabba a könyvtárba. + </para> + <para> + A parancssori opciókat csak akkor használhatod, ha futtatható + PHP verzióval rendelkezel. Ha a PHP beépített szerver modulként fut, + És nincs semmilyen CGI verziójú PHP a gépeden, akkor le kell mondanod + a parancssori használatról. + A Windows felhasználóknak mind a futtatható és a szerver modul + PHP installálásra kerül a bináris csomagból, a futtatható állomány + neve: <filename>php.exe</filename>. + </para> + <para> + A következõ listát a parancssori opciókról a PHP 4.0.6. generálta. + Hasonló listát és némi egysoros magyarázatot listázhatsz + ki a <literal>-h</literal> opcióval. + <literal>php -h</literal> kimenete a következõképpen nézhet ki: + <screen> +<![CDATA[ +Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]} + -q Quiet-mode. Suppress HTTP Header output. + -s Display colour syntax highlighted source. + -f <file> Parse <file>. Implies `-q' + -v Version number + -C Do not chdir to the script's directory + -c <path> Look for php.ini file in this directory + -d foo[=bar] Define INI entry foo with value 'bar' + -e Generate extended information for debugger/profiler + -z <file> Load Zend extension <file>. + -l Syntax check only (lint) + -m Show compiled in modules + -i PHP information + -h This help +]]> + </screen> + </para> + <para> + Alább néhány fontosabb parancssori opciót muntatunk be, + részletes magyarázattal. + </para> + <para> + <table> + <title>Parancs sori opciók</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Option</entry> + <entry>Leírás</entry> + </row> + </thead> + <tbody> + <row> + <entry>-q</entry> + <entry> + Letiltja a HTTP fejlécek kíírását. Alapban a PHP kinyomtatja + a HTTP fejléceket a hívó program számára (pl. webszerver) + Hogy az át tudja adni a böngészõnek. Amikor viszont parancssori + programokat írsz, ezek a fejlécek haszontalanok. + </entry> + </row> + <row> + <entry>-s</entry> + <entry> + Színesben kiemelt forrását írja ki a PHP programnak, + amit megadtál. Ugyanaz történik, mint amikor a + <function>highlight_file</function> függvényt használod + a forrás kííratásához egy PHP programban. + </entry> + </row> + <row> + <entry>-f</entry> + <entry> + Értelmezi a megadott fájlt és szintaktikai, valamint + fatális hibákat keres benne. Ez az opció magában foglalja a -q paramétert is. + Hibakeresésre használatos. + </entry> + </row> + <row> + <entry>-v</entry> + <entry> + Kiírja az általad használt PHP verzió számát. + Pl.: 4.0.6. + </entry> + </row> + <row> + <entry>-C</entry> + <entry> + Alapesetben a PHP a munkakönyvtárról áttér + az éppen futó szkriptek könyvtárára. Ez teszi lehetõvé + például, hogy megnyiss fájlokat ugyanabból a könyvtárból + úgy, hogy csak a nevükre hivatkozol. + Ha ki szeretnéd kapcsolni ezt a könytár cserélgetést, + Használd ezt az opciót. + </entry> + </row> + <row> + <entry>-c</entry> + <entry> + E opció használatával meghatározhatod egy alternatív + <filename>php.ini</filename> fájl útvonalát, így a PHP + az általad meghatázozott útonalon keresi + a konfigurációs fájlt az alapértelmezett helyett. + </entry> + </row> + <row> + <entry>-d</entry> + <entry> + Ezzel az opcióval egyéni + <filename>php.ini</filename> beállításokat adhatsz meg + a szkripted futása alatt. + </entry> + </row> + <row> + <entry>-l</entry> + <entry> + Szintaktikai hibák után nyomoz a megadott fájlban. + Ez az opció magában foglalja a -q opciót is. Hibakeresésre használatos. + Nem fog fatális hibákat találni (mint pl. definiálatlan függvények), + ha szeretnéd, hogy a fatális hibákat is kijelezze, + használd az -f opciót. + </entry> + </row> + <row> + <entry>-m</entry> + <entry> + Ez az opció kilistázza a betöltött PHP és Zend modulokat, + a PHP és a Zend verzió számokat + és egy rövid Zend kopijárt megjegyzést. + </entry> + </row> + <row> + <entry>-i</entry> + <entry> + Ez a parancs sori opció meghívja a + <function>phpinfo</function> függvényt és kiírja az eredményeket. + Ha a PHP-vel problémák vannak, + javasolt a <literal>php -i</literal> parancs kiadása + és a hibaüzenetek elolvasása az információs táblásat elõtt + (vagy éppen az információs táblában). + </entry> + </row> + <row> + <entry>-h</entry> + <entry> + Ezzel az opcióval információt szerezhetsz + a parancs sori opciókról és rövid, egysoros leírásokat + olvashatsz róluk. + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + A PHP szkriptek a web szervertõl abszolút függetlenül is futtathatók. + Ha Unix típusú operációs rendszert használsz, + írj egy bejegyzést a szkript elsõ sorába és tedd futtathatóvá. + Így a rendszer tudni fogja, hogy mely program futtatja a szkriptet. + Windows platformon hozzárendelheted a + <literal>php.exe -q</literal> parancsot + a <literal>.php</literal> kiterjesztésû fájlokhoz, + ekkor azok dupla kattintással is indulhatnak, esetleg írhatsz egy BATCH + programot a .php fájlok PHP interpreteren keresztüli futtatásához. + Az elsõ sorban megadott UNIX információ nem zavarja a Windowst, + vagyis "kereszt-platformos" szkripteket hozhatsz létre a PHP-vel. + Egy egyszerû parancssori PHP programot mutatunk be alább. + </para> + <example> + <title>Parancssorból futtatott PHP szkript. (script.php)</title> + <programlisting role="php"> +<![CDATA[ +#!/usr/bin/php -q +<?php + +if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) { +?> + +Ez egy Parancs sori PHP szkript egyetlen opcióval + + Használat: + <?php echo $argv[0]; ?> <option> + + <option> ide bármit beírhasz, + kinyomtatom. A --help, -help, -h, + or -? opciókkal megkapod ezt az üzenetet. + +<?php +} else { + echo $argv[1]; +} +?> +]]> + </programlisting> + </example> + <para> + A fenti szkriptben az elsõ sorban definiáltuk, hogy a PHP-n + keresztül fusson és ne nyomtasson ki HTTP fejléceket. + headers. Van két változó, amit használhatsz parancs sori PHP + szkriptek írása során: <varname>$argc</varname> és a + <varname>$argv</varname>. Az elsõ az argumentumok számát adja, plusz egyet + (a plussz egy az éppen futó szkript neve). A második egy tömb, + tartalmazza sz argumentumokat, elsõ elemként a futó szkript nevét, amit + nulladik elemként tárol (<varname>$argv[0]</varname>). + </para> + <para> + A fenti szkriptben ellenõriztük, hogy egy- vagy több argumentum van-e. + Ha az argumentum <literal>--help</literal>, + <literal>-help</literal>, <literal>-h</literal> vagy <literal>-?</literal> volt, + kiírta a help üzenetet és a szkript nevét. + Más argumentumokkal kinyomtatta azokat. + </para> + <para> + Ha a fenti szkriptet UNIX rendszeren akarod futtatni, + tedd futtathatóvá, majd a következõ két módon tudod elindítani: + <literal>script.php echothis</literal> vagy + <literal>script.php -h</literal>. Windows renszeren egy BATCH programot írhatsz erre: + </para> + <example> + <title>BATCH fájl parancs sori PHP programok futtatásához (script.bat)</title> + <programlisting role="winbat"> +@c:\php\php.exe -q script.php %1 %2 %3 %4 + </programlisting> + </example> + <para> + Feltéve, ha a fenti szkript neve + <filename>script.php</filename>, és van + <filename>php.exe</filename> a + <filename>c:\php\php.exe</filename> útvonalon, + a BATCH fájl futtatni fogja a szkreiptedet, ha a következõk valamelyikét beírod: + <literal>script.bat echothis</literal> or + <literal>script.bat -h</literal>. + </para> + <para> + Lásd még a <link linkend="ref.readline">Readline</link> + bõvítmény dokumentációját további függvényekért, + melyekkel növelheted parancs sori PHP szkriptjeid hatékonyságát. + </para> +</appendix> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +indent-tabs-mode:nil +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +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 +-->