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 > 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
+-->
