tibee Mon Mar 25 14:34:37 2002 EDT
Added files:
/phpdoc/hu/functions commandline.xml
Log:
Index: phpdoc/hu/functions/commandline.xml
+++ phpdoc/hu/functions/commandline.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- $Revision: 1.1 $ -->
<!--
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 > 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
-->
