goba Tue Mar 26 10:56:19 2002 EDT
Added files:
/phpdoc/hu/appendices commandline.xml
Removed files:
/phpdoc/hu/functions commandline.xml
Log:
The right place for commandline.xml is in the appendix, we need the EN-Revision
instead of a file revision, and correcting some typos.
Index: phpdoc/hu/appendices/commandline.xml
+++ phpdoc/hu/appendices/commandline.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.3 Maintainer: acsontos Status: ready -->
<!--
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>Parancssori 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 parancssori 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 parancssori 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 Parancssori PHP szkript egyetlen opci�val
Haszn�lat:
<?php echo $argv[0]; ?> <option>
<option> ide b�rmit be�rhasz,
kinyomtatom. A --help, -help, -h,
vagy -? 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 parancssori 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 parancssori 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 szkriptedet, ha a k�vetkez�k valamelyik�t be�rod:
<literal>script.bat ezt_ird_ki</literal> vagy
<literal>script.bat -h</literal>.
</para>
<para>
L�sd m�g a <link linkend="ref.readline">Readline</link>
kiterjeszt�s dokument�ci�j�t tov�bbi f�ggv�nyek�rt,
melyekkel n�velheted parancssori 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
-->
