cvs: peardoc /hu/chapters installation.xml
| From: | Norbert Mocsnik | Date: | Wed, 05 Oct 2005 20:45:29 +0000 |
| Subject: | cvs: peardoc /hu/chapters installation.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-6977@lists.php.net to get a copy of this message | ||
norbert_m Wed Oct 5 16:45:29 2005 EDT
Modified files:
/peardoc/hu/chapters installation.xml
Log:
sync to en
http://cvs.php.net/diff.php/peardoc/hu/chapters/installation.xml?r1=1.7&r2=1.8&ty=u Index: peardoc/hu/chapters/installation.xml diff -u peardoc/hu/chapters/installation.xml:1.7 peardoc/hu/chapters/installation.xml:1.8 --- peardoc/hu/chapters/installation.xml:1.7 Sat Jun 18 20:04:57 2005 +++ peardoc/hu/chapters/installation.xml Wed Oct 5 16:45:29 2005 @@ -1,9 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2" ?> -<!-- EN-Revision: 1.20 Maintainer: norbert_m Status: ready --> -<!-- - WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING - THIS DOCUMENT YET. - --> +<!-- EN-Revision: 1.31 Maintainer: norbert_m Status: ready --> <chapter id="installation"> <chapterinfo> <author> @@ -23,17 +19,16 @@ <link linkend="about.pear">általános szerkezetét</link>. </para> <para> - Az alap telepítés, ami a PHP disztribúciójában, a <link - linkend="about-pfc">PFC</link> részeként kerül terjesztésre, + Az alap telepítés, ami a PHP disztribúciójával együtt kerül terjesztésre, tartalmazza az összes dolgot, ami szükséges a PEAR telepítőeszközök futtatásához. Ha rendelkezünk egy telepített PHP verzióval, - akkor a PEAR alapjai már a számítógépen vannak, ha a PHP fordításakor + akkor a PEAR alapjai már a számítógépen vannak, amennyiben a PHP fordításakor a <filename>./configure</filename> szkript futtatásakor a <literal>--without-pear</literal> opciót külön nem adtuk meg. </para> <para> - Azokat a csomagokat, amelyek nem részei a <link linkend="about-pfc"> - PFC</link>-nek a PEAR csomag-menedzserrel (PEAR package manager) + Azokat a csomagokat, amelyek nem részei a PHP disztribúciónak, + a PEAR csomag-menedzserrel (PEAR package manager) telepíthetjük. A menedzser a Debian <quote><ulink url="&url.debian.apt;"> apt-get</ulink></quote>-jéhez hasonlítható. Még egyszer: ha a számítógépen a PHP egy újabb verziója telepítve van (>4.3.0), @@ -88,14 +83,18 @@ gyökerében lévő <filename>c:\php\go-pear.bat</filename> kötegelt állományt. A telepítő néhány kérdést tesz fel, ezt követően a PEAR package manager telepítve lesz a telepítéskor megadott útvonalon. - Végül hozzá kell adni az útvonalat a PATH környezeti változóhoz - (Start > Vezérlőpult > Rendszer > Környezeti beállítások). + Végül hozzá kell adni az útvonalat a <literal>PATH</literal> + környezeti változóhoz. + Ezt megtehetjük kézzel (Start > Vezérlőpult > Rendszer > + Környezeti beállítások), vagy futtathatjuk (dupla kattintással) az + újonnan generált <filename>PEAR_ENV.reg</filename> fájlt a PHP + forrásának könyvtárából. Ezt követően elérhető a PEAR package manager, indítása a parancssorból történik, <literal>pear</literal> paranccsal. </para> <para> - A rendszeren lévő PEAR telepítés frissítéséhez navigáljunk a go-pear.org - címre egy böngészővel, és mentsük el a kimenetet egy helyi fájlba, + A rendszeren lévő PEAR telepítés frissítéséhez navigáljunk a &url.pear.go; + címre egy böngészőben, és mentsük el a kimenetet helyi fájlként, <filename>go-pear.php</filename> néven. Ezután parancssorból futtathatjuk a szkriptet a frissítési folyamat elindításához. <screen> @@ -109,16 +108,25 @@ <title>PEAR hosting környezetekben</title> <para> - Olyan oldalak esetében, melyek webhosting szolgáltatók tárhelyén - helyezkednek el, ahol nem rendelkezünk közvetlen hozzáféréssel a - tárhelyhez (helyi belépéssel, telnettel, vagy SSH-val), nem használható - a PEAR package manager. Ha egy ilyen cég ügyfelei vagyunk, nagyon + Olyan szolgáltatók tárhelyén, ahol nem rendelkezünk közvetlen + hozzáféréssel (helyi belépéssel, telnettel, vagy SSH-val), a PEAR + telepítő csak a PEAR_RemoteInstaller segítségével, FTP protokollon + keresztül használható (az sftp hozzáférés még nem támogatott). + </para> + <warning> + <simpara> + Az FTP nem biztonságos protokoll, mert a jelszavak kódolatlanul + kerülnek továbbításra a hálózaton. + </simpara> + </warning> + <para> + Ha egy okos cég ügyfelei vagyunk, nagyon valószínű, hogy a leggyakrabban használt PEAR csomagok már telepítve vannak a szerveren. Amennyiben ez nem így van, vagy további csomagokra - van szükségünk, lépjünk kapcsolatba a szolgáltatóval, és kérjük meg + van szükségünk, lépjünk kapcsolatba a szolgáltatóval és kérjük meg a csomag telepítésére. Ha a telepítést megtagadják, új szolgáltató után nézhetünk, vagy <link linkend="installation.manually">telepíthetjük - a csomagot kézzel</link>. + a csomagokat kézzel</link>. </para> </sect2> </sect1> @@ -175,10 +183,10 @@ <sect2> <title>Fél-automatikus telepítés</title> <para> - Ha egy package release-t .gzip-elt, tar-olt állományban töltöttünk le - a <ulink url="http://pear.php.net/">pear.php.net</ulink> oldalról, - telepíthetjük helyileg is. Ehhez a következő parancssort kell - lefuttatnunk: + Ha egy csomag egy megjelenését gzip-elt, tar-olt állományban + töltöttük le a <ulink url="&url.pear;">&url.pear;</ulink> webhelyről, + telepíthetjük helyileg is. Ehhez a következő parancssot kell + kiadnunk: </para> <para> <screen> @@ -223,10 +231,38 @@ </entry> </row> <row> + <entry>channel-add</entry> + <entry>Csatorna hozzáadása (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-alias</entry> + <entry>Álnév megadása egy csatornához (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-delete</entry> + <entry>Csatorna eltávolítása a listából (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-discover</entry> + <entry>Csatorna inicializálása a szerverének nevéből (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-info</entry> + <entry>Információ lekérése egy csatornáról (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-update</entry> + <entry>Létező csatorna frissítése (PEAR 1.4+)</entry> + </row> + <row> <entry>clear-cache</entry> <entry>Az XML-RPC gyorsítótár törlése</entry> </row> <row> + <entry>config-create</entry> + <entry>Alapértelmezett konfigurációs fájl létrehozása (PEAR 1.4+)</entry> + </row> + <row> <entry>config-get</entry> <entry>Egy konfigurációs beállítás lekérdezése</entry> </row> @@ -239,6 +275,10 @@ <entry>Konfigurációs beállítás módosítása egy megadott értékre</entry> </row> <row> + <entry>convert</entry> + <entry>Convert a package.xml 1.0 format to package.xml 2.0 format (PEAR 1.4+)</entry> + </row> + <row> <entry>config-show</entry> <entry>Az összes konfigurációs érték listázása</entry> </row> @@ -278,6 +318,14 @@ <entry>Minden csomag listázása (telepített és/vagy elérhető)</entry> </row> <row> + <entry>list-channels</entry> + <entry>Elérhető csatornák listázása (PEAR 1.4+)</entry> + </row> + <row> + <entry>list-files</entry> + <entry>Egy telepített csomag fájljainak listázása (PEAR 1.4+)</entry> + </row> + <row> <entry>list-upgrades</entry> <entry>A rendszeren telepített csomagokhoz elérhető frissítések listázása</entry> </row> @@ -306,6 +354,10 @@ <entry>Csomag konzisztenciájának ellenőrzése</entry> </row> <row> + <entry>run-scripts</entry> + <entry>Egy csomag telepítés utáni szkriptjeinek futtatása (PEAR 1.4+)</entry> + </row> + <row> <entry>remote-info</entry> <entry>Információ a távoli csomagokról</entry> </row> @@ -334,6 +386,10 @@ <entry>Egy csomag eltávolítása</entry> </row> <row> + <entry>update-channels</entry> + <entry>Csatornalista frissítése (PEAR 1.4+)</entry> + </row> + <row> <entry>upgrade</entry> <entry> Egy csomag frissítése az aktuális verzióra (lásd még: @@ -444,8 +500,34 @@ <entry> </entry> </row> <row> + <entry>remote_config</entry> + <entry> + Távoli konfigurációs fájl, egy helyi telepítés tükrözésére egy + távoli szerveren FTP protokollon keresztül (PEAR 1.4+) + </entry> + <entry> </entry> + </row> + <row> + <entry>auto_discover</entry> + <entry> + Új csatornák automatikus felderítése parancssorból vagy + függőségek alapján. + </entry> + <entry>0</entry> + </row> + <row> + <entry>default_channel</entry> + <entry>Alapértelmezett csatorna (PEAR 1.4+)</entry> + <entry>pear.php.net (pecl.php.net a pecl parancs használatakor)</entry> + </row> + <row> + <entry>preferred_mirror</entry> + <entry>Preferred channel mirror (PEAR 1.4+)</entry> + <entry>pear.php.net (pecl.php.net a pecl parancs használatakor)</entry> + </row> + <row> <entry>master_server</entry> - <entry>PEAR szerver</entry> + <entry>PEAR szerver [PEAR 1.4+ felett elavult]</entry> <entry>pear.php.net</entry> </row> <row> @@ -503,6 +585,7 @@ használhatjuk: </para> <para> + PEAR 1.3.5 és korábbi verziók <screen> <userinput> $ pear -s -c ~/.pearrc -d doc_dir=~/pear/docs -d ext_dir=~/pear/ext \ @@ -512,9 +595,16 @@ </screen> </para> <para> + PEAR 1.4+ + <screen> + <userinput> +$ pear config-create /home/user/pear .pearrc + </userinput> + </screen> + </para> + <para> Ezzel létrejön egy helyi konfigurációs fájl a home könyvtárunkban - <filename>.pearrc</filename> néven. Ezenkívül létrejön a könyvtárban egy - pear könyvtár, és ebbe kerül az összes telepített PEAR csomag. + <filename>.pearrc</filename> néven. </para> <para> Ezt követően ha hozzáadjuk a ~/pear/bin könyvtárat az elérési úthoz @@ -522,6 +612,7 @@ lefuttatjuk a következő parancssort: </para> <para> + PEAR 1.3.2 és korábbi verziók <screen> <userinput> $ pear -c ~/.pearrc install Archive_Tar PEAR Console_Getopt XML_RPC @@ -529,10 +620,21 @@ </screen> </para> <para> - akkor rendelkezni fogunk a PEAR egy helyi másolatával, ami hatástalanítja + PEAR 1.3.3+ + <screen> + <userinput> +$ pear install -o PEAR + </userinput> + </screen> + </para> + <para> + Ezáltal létrejön egy könyvtárszerkezet a home könyvtárunkban lévő + <filename>pear</filename> alkönyvtár alapján, a telepítendő csomagok + tárolására. + Így rendelkezni fogunk a PEAR egy helyi másolatával, ami hatástalanítja a rendszeren lévő másolatot. Az újonnan telepített fájlok használatához - hozzá kell adni a PHP include_path-hoz az új elérési utat, amit - megtehetünk kódból: + hozzá kell adni a PHP include_path direktívájához az új elérési utat, + amit megtehetünk kódból: </para> <para> <programlisting role="php"> @@ -548,46 +650,293 @@ </para> </sect2> <sect2 id="installation.shared.ftp"> - <title>A PEAR egy helyi másolatának telepítése ftp-n keresztül</title> + <title>A PEAR egy helyi másolatának telepítése FTP protokollon keresztül</title> <para> - A PEAR helyi másolatának ftp-n keresztül történő telepítésére szükségünk - van egy jogosultságokat beállítani képes ftp kliensre. Elsőként hozzunk - létre egy könyvtárat, ami NEM a publikusan elérhető webtárhelyen van, és - adjunk neki egy nevet. Állítsuk be bármilyen felhasználó által olvashatóra és - írhatóra (0777 jogosultságok), ezt követően töltsük le a - http://go-pear-org egy másolatát, és mentsünk el go-pear.php néven. - Töltsük fel egy alkönyvtárba a publikusan elérhető webtárhelyen. Ajánlott - a könyvtárat jelszóvédetté tenni egy .htaccess fájl segítségével. - </para> - <para> - Ezután jelenítsük meg böngészőnkben a feltöltött go-pear.php fájlt. Ha - webcímünk http://www.example.com, a go-pear.php-t a - public_html/install/go-pear.php elérési úton helyeztük el, és a - http://www.example.com/ a public_html/ könyvtárra mutat, akkor - böngészőnkben a http://www.example.com/install/go-pear.php -t - jelenítsük meg. Kövessük a telepítési utasításokat. Amikor a telepítő - megkérdezi, hogy hova szeretnénk telepíteni a PEAR-t, válasszuk azt a könyvtárat, - amelyet létrehoztunk és olvashatóvá-írhatóvá tettünk minden felhasználó - számára. Szükséges továbbá a PHP cli verziójának elérési útjának ismerete. - Ennek felderítéséhez a következő szkriptet használhatjuk: + Kétféle módszer létezik a PEAR helyi másolatának telepítésére + FTP protokollon keresztül: a régi, nehéz mód, és az új, könnyű mód. + Az új mód igénybevételéhez a PEAR legújabb változatára történő előzetes + frissítésre van szükség. </para> - <para> - <programlisting role="php"> + <sect3> + <title>Új, továbbfejlesztett módszer a PEAR 1.4.0 és a Net_FTP csomagok használatával</title> + <para> + A PEAR egy helyi példányának telepítése FTP protokollon keresztül a PEAR 1.4.0+ + verziójától kezdve nagyon leegyszerűsödött. + </para> + <para> + Sok felhasználó ütközött problémába a PEAR telepítése során távoli kiszolgálók + esetében, amelyeken nem rendelkeznek parancssori hozzáféréssel. Gyakran az + egyetlen lehetőségük az FTP használata volt, de ez nem hatékony megoldás olyan + összetett csomagok esetében, amelyek a telepítő különböző funkcióit + kihasználják (például a sztringcseréket). + </para> + <para> + A szükséges lépések a helyes távoli telepítéshez: + </para> + <para> + <orderedlist> + <listitem> + <para> + Győződjünk meg róla, hogy rendelkezünk működő parancssori PEAR telepítővel + számítógépünkön (a "pear" parancs, nem a webes felület). + </para> + </listitem> + <listitem> + <para> + Győződjünk meg róla, hogy rendelkezünk FTP hozzáféréssel a távoli szerveren, + és írási jogosultsággal FTP-n keresztül. + </para> + </listitem> + <listitem> + <para> + Jegyezzük fel a teljes elérési utat a home könyvtárunkhoz a távoli szerveren + </para> + </listitem> + <listitem> + <para> + Hozzunk létre egy testreszabott konfigurációs fájlt mind a helyi, + mind a távoli kiszolgálónak + </para> + </listitem> + <listitem> + <para> + Töltsük fel a távoli konfigurációs fájlt a távoli szerverre + </para> + </listitem> + <listitem> + <para> + A helyi konfigurációs fájlt felhasználva állítsuk be a remote_config + értéket a távoli szerveren található konfigurációs fájl helyére + </para> + </listitem> + <listitem> + <para> + Telepítsünk csomagokat tetszés szerint! + </para> + </listitem> + </orderedlist> + </para> + <para> + <emphasis> + 1. Győződjünk meg róla, hogy rendelkezünk működő parancssori PEAR telepítővel + számítógépünkön (a "pear" parancs, nem a webes felület). + </emphasis> + </para> + <para> + Olvassuk el a <ulink url="&url.pear.manual;/en/installation.cli.php">telepítési útmutatót</ulink>. + </para> + <para> + <emphasis> + 2. Győződjünk meg róla, hogy rendelkezünk FTP hozzáféréssel a távoli szerveren, + és írási jogosultsággal FTP-n keresztül. + </emphasis> + </para> + <para> + Ez nagyon egyszerű - amennyiben be tudunk jelentkezni a távoli szerverre + az FTP parancs használatával DOS parancssorból vagy UNIX shellből, rendelkezünk + FTP hozzáféréssel. SFTP hozzáférés egyelőre nem támogatott, de amint a Net_FTP + csomag támogatni fogja, elérhető lesz. + </para> + <para> + Jegyezzük fel a bejelentkezéshez használt felhasználói nevet és jelszót. + </para> + <para> + Az írási jogosultság tesztelése egyszerű. Ha tudunk fájlt feltölteni, van írási jogosultságunk. + </para> + <para> + <emphasis> + 3. Jegyezzük fel a teljes elérési utat a home könyvtárunkhoz a távoli szerveren + </emphasis> + </para> + <para> + Ez is nagyon egyszerű. Megállapításához töltsük fel a következő szkriptet a könyvtárunkba: + </para> + <para> + <programlisting> + <![CDATA[ +<?php + echo dirname(__FILE__); +?> + ]]> + </programlisting> + </para> + <para> + Valószínűleg a következőhöz hasonló eredményt kapunk: <filename>/home/username/htdocs</filename>. + Ha bejelentkezünk FTP-n keresztül és be tudunk lépni a /home/username könyvtárba, + jó úton járunk. + </para> + <para> + <emphasis> + 4. Hozzunk létre egy testreszabott konfigurációs fájlt mind a helyi, + mind a távoli kiszolgálónak + </emphasis> + </para> + <para> + A következőképpen tehetjük meg Windows és UNIX alatt: + </para> + <para> + Windows: + </para> + <para> + Válasszunk egy helyet a helyi számítógépen a távoli kód tárolására. + Például <filename>C:\remote\pear</filename>. Parancssorból + (Start menü => Kellékek => Parancssor) + hívjuk meg a következőket: + </para> + <para> + <screen> + <![CDATA[ +C:\> mkdir remote +C:\> cd remote +C:\remote\> mkdir pear +C:\remote\> cd pear +C:\remote\pear> pear config-create -w C:\remote\pear remote.ini +C:\remote\pear> pear config-create /home/username/pear .pearrc + ]]> + </screen> + </para> + <para> + Unix alatt is hasonlóképpen járjunk el: + </para> + <para> + <screen> + <![CDATA[ +$ cd +$ mkdir remote +$ cd remote +$ mkdir pear +$ cd pear +$ pear config-create /home/mylocaluser remote.conf +$ pear config-create /home/username/pear .pearrc + ]]> + </screen> + </para> + <para> + <emphasis> + 5. Töltsük fel a távoli konfigurációs fájlt a távoli szerverre + </emphasis> + </para> + <para> + Mindkét operációs rendszerben használjunk egy FTP programot a + <filename>.pearrc</filename> fájl feltöltésére + <filename>/home/username/pear/.pearrc</filename> néven. + </para> + <para> + <emphasis> + 6. A helyi konfigurációs fájlt felhasználva állítsuk be a remote_config + értéket a távoli szerveren található konfigurációs fájl helyére + </emphasis> + </para> + <para> + Windows: + </para> + <para> + <screen> + <![CDATA[ +C:\remote\pear\> pear -c remote.ini config-set remote_config ftp://user:pass@myremotehost.com/.pearrc + ]]> + </screen> + </para> + <para> + Unix: + </para> + <para> + <screen> + <![CDATA[ +$ pear -c remote.conf config-set remote_config ftp://user:pass@myremotehost.com/.pearrc + ]]> + </screen> + </para> + <para> + <emphasis> + 7. Telepítsünk csomagokat tetszés szerint! + </emphasis> + </para> + <para> + Ettől kezdve használhatjuk a pear parancsot a szokásos módon, amely + automatikusan szinkronizálni fogja a helyi és a távoli fájlokat. + </para> + <para> + <emphasis> + Hogyan működik? + </emphasis> + </para> + <para> + Egyszerű. A telepítő feltelepíti a csomagot helyileg, aztán a Net_FTP csomag + használatával minden helyileg telepített fájlt feltölt a megfelelő helyre + a távoli szerveren. Minden parancs, ami érinti a telepítést (install, upgrade + és az upgrade-all is) használható ezzel a módszerrel. A "remote_config" opció + mondja meg a telepítőnek hogy automatikusan tükröznie kell a helyi másolatot + a távoli szerverre. + </para> + <para> + Még izgalmasabb, hogy a távoli konfigurációs fájl kerül használatra sztringcserék + elvégzésekor. Magyarul, ha egy fájlnak szüksége van az adatfájlok útvonalára a + data_dir konfigurációs direktíván keresztül, akkor a távoli szerver elérési + útját fogja megkapni + (<filename>/home/username/pear/data</filename>) a helyi másolat útvonala helyett ( + <filename>C:\remote\pear\data</filename>). Ennek egy mellékhatása van: + a helyi másolat nem fog működni a helyi gépen, de ha egy biztonsági mentésként + gondolunk rá, akkor hasznosnak fogjuk találni (vészhelyetben bármikor feltölthetjük + a könyvtár egész tartalmát a távoli szerverre hagyományos FTP vagy SCP használatával). + </para> + <para> + Fontos megjegyezni, hogy néhány csomag eltérően települ Windows és Unix alatt. Egy ilyen + telepítés előtt győződjünk meg róla, hogy a telepíteni kívánt csomag esetében ez nem + így van, vagy használjunk megegyező operációs rendszereket a helyi és a távoli + számítógépeken. + </para> + </sect3> + <sect3> + <title>A hagyományos módszer a PEAR egy helyi másolatának telepítésére FTP-n keresztül</title> + <para> + A PEAR helyi másolatának ftp-n keresztül történő telepítésére szükségünk + van egy jogosultságokat beállítani képes FTP kliensre. Elsőként hozzunk + létre egy könyvtárat, ami NEM a publikusan elérhető webtárhelyen van, és + adjunk neki egy nevet. Állítsuk be minden felhasználó által olvashatóra és + írhatóra (0777 jogosultságok), ezt követően töltsük le a + &url.pear.go; egy másolatát, és mentsünk el go-pear.php néven. + Töltsük fel egy alkönyvtárba a publikusan elérhető webtárhelyen. Ajánlott + a könyvtárat jelszóvédetté tenni egy .htaccess fájl segítségével. + </para> + <para> + Ezután jelenítsük meg böngészőnkben a feltöltött go-pear.php fájlt. Ha + webcímünk &url.example.http;, a go-pear.php-t a + public_html/install/go-pear.php elérési úton helyeztük el, és a + &url.example.http; a public_html/ könyvtárra mutat, akkor + böngészőnkben a &url.example.http;install/go-pear.php -t + jelenítsük meg. Kövessük a telepítési utasításokat. Amikor a telepítő + megkérdezi, hogy hova szeretnénk telepíteni a PEAR-t, válasszuk azt a könyvtárat, + amelyet létrehoztunk és olvashatóvá-írhatóvá tettünk minden felhasználó + számára. Szükséges továbbá a PHP cli verziójának elérési útjának ismerete. + Ennek felderítéséhez a következő szkriptet használhatjuk: + </para> + <para> + <programlisting role="php"> <![CDATA[ <?php echo `which php`; // if this does not work, also try echo PHP_BIN; ?> ]]> - </programlisting> - </para> - <para> - Miután a PEAR telepítésre került, használhatjuk a web installert csomagok - telepítéséhez és frissítéséhez, ugyanúgy, mint bármilyen más PEAR telepítés - esetén tennénk. Az újonnan telepített fájlok használatához az új elérési - utat hozzá kell adni a PHP include_path-hoz, vagy az apache .htaccess - fájljában a php_value direktíva használatával hivatkozni kell rá. - </para> + </programlisting> + </para> + <para> + Miután a PEAR telepítésre került, ugyanúgy használhatjuk a web installert csomagok + telepítéséhez és frissítéséhez mint bármilyen más PEAR telepítés + esetén tennénk. Az újonnan telepített fájlok használatához az új elérési + utat hozzá kell adni a PHP include_path-jához. + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); +?> +]]> + </programlisting> + </para> + </sect3> </sect2> </sect1> @@ -676,8 +1025,8 @@ </para> <para> Ha további kérdések merülnek fel a kézi telepítéssel kapcsolatban, - a <ulink url="&email.pear.general;">felhasználói levelezőlistán</ulink> - lehet segítséget kérni (angolul). + a <ulink url="mailto:&email.pear.general;">felhasználói levelezőlistán</ulink> + kérhetünk segítséget (angolul). </para> </sect1> @@ -688,89 +1037,97 @@ <para> Ez a fejezet az egyes csomagok legfrissebb, fejlesztés alatt álló verzióinak telepítéséről nyújt majd leírást. - </para> + </para> + <para> + NEM ajánlott csomagok CVS verzióinak használata éles környezetekben! + A CVS változatok nem szabályos megjelenések, ami a következőket jelenti: + <itemizedlist> + <listitem> + <simpara>Lehetséges, hogy nem kapunk semmiféle segítséget a csomag karbantartójától, vagy bárki mástól.</simpara> + </listitem> + <listitem> + <simpara>A CVS-ben lévő verziók tönkretehetik a PEAR Telepítő frissítő mechanizmusát.</simpara> + </listitem> + </itemizedlist> + </para> + <para> + Csak akkor használjunk csomagot a CVS-ből, ha: + <itemizedlist> + <listitem> + <simpara>A csomag karbantartója ajánlotta.</simpara> + </listitem> + <listitem> + <simpara>Egy csomag fejlesztésében szeretnénk részt venni.</simpara> + </listitem> + <listitem> + <simpara>Igazán szükségünk egy speciális foltra/funkcióra, ami még nem jelent meg.</simpara> + </listitem> + </itemizedlist> + </para> + <para> + Ha továbbra is meg vagyunk győződve arról, hogy egy csomag CVS verzióját szeretnénk + használni, akkor ugyanazokat a lépéseket kell elvégeznünk, amelyet a csomag karbantartója + végez a csomag egy új verziójának kiadásakor. Ha problémákba ütközünk a következő + lépések elvégzése során, lapozzuk fel a kézikönyv <link linkend="guide-developers">Fejlesztői + Kalauz</link>át! + </para> + <orderedlist> + <listitem> <para> - NEM ajánlott csomagok CVS verzióinak használata éles környezetekben! - A CVS változatok nem szabályos megjelenések, ami a következőket jelenti: - <itemizedlist> - <listitem> - <simpara>Lehetséges, hogy nem kapunk semmiféle segítséget a csomag karbantartójától, vagy bárki mástól.</simpara> - </listitem> - <listitem> - <simpara>A CVS-ben lévő verziók tönkretehetik a PEAR Telepítő frissítő mechanizmusát.</simpara> - </listitem> - </itemizedlist> + Szerezzük be a csomag fájljait a CVS-ből a <ulink url="&url.php.anoncvs;">&url.php.anoncvs;</ulink> + címen leírt módon. </para> <para> - Csak akkor használjunk csomagot a CVS-ből, ha: - <itemizedlist> - <listitem> - <simpara>A csomag karbantartója ajánlotta.</simpara> - </listitem> - <listitem> - <simpara>Egy csomag fejlesztésében szeretnénk részt venni.</simpara> - </listitem> - <listitem> - <simpara>Igazán szükségünk egy speciális foltra/funkcióra, ami még nem jelent meg.</simpara> - </listitem> - </itemizedlist> + A megszerzendő modul neve <filename>pear/<csomagnév></filename>, + például <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. </para> + </listitem> + <listitem> <para> - Ha továbbra is meg vagyunk győződve arról, hogy egy csomag CVS verzióját szeretnénk - használni, akkor ugyanazokat a lépéseket kell elvégeznünk, amelyet a csomag karbantartója - végez a csomag egy új verziójának kiadásakor. Ha problémákba ütközünk a következő - lépések elvégzése során, lapozzuk fel a kézikönyv <link linkend="guide-developers">Fejlesztői - Kalauz</link>át! + Vizsgáljuk meg a <filename>package.xml</filename> fájlt, különösen a fileset elemeket. + Meg kell egyezniük a meglévő fájl- és könyvtárstruktúrákkal. Ha eltérnek, lépjünk + kapcsolatba a karbantartóval, és kérjük el tőle a <filename>package.xml</filename> fájl + legfrissebb verzióját. </para> - <orderedlist> - <listitem> - <para> - Szerezzük be a csomag fájljait a CVS-ből a <ulink url="http://www.php.net/anoncvs.php">http://www.php.net/anoncvs.php</ulink> - címen leírt módon. - </para> - <para> - A megszerzendő modul neve <filename>pear/<csomagnév></filename>, - például <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. - </para> - </listitem> - <listitem> - <para> - Vizsgáljuk meg a <filename>package.xml</filename> fájlt, különösen a fileset elemeket. - Meg kell egyezniük a meglévő fájl- és könyvtárstruktúrákkal. Ha eltérnek, lépjünk - kapcsolatba a karbantartóval, és kérjük el tőle a <filename>package.xml</filename> fájl - legfrissebb verzióját. - </para> - </listitem> - <listitem> - <para> - Hozzunk létre egy érvényes csomagot a PEAR Telepítő felhasználásával - <command>pear package <útvonal a package.xml fájlhoz></command> - </para> - </listitem> - <listitem> - <para> - Ha már telepítettük a csomagot, távolítsuk el azt a különböző verziókból adódó - problémák elkerüléséhez: - <command>pear uninstall <package></command> - </para> - </listitem> - <listitem> - <para> - Telepítsük a csomagarchívumunkat: - <command>pear install <csomag-fájl></command> - </para> - <para> - Ezzel telepítettük a csomag CVS verzióját! - </para> - </listitem> - </orderedlist> + </listitem> + <listitem> <para> - Frissítsük a csomagot egy hivatalos verzióra amilyen hamar csak lehetséges. - Mielőtt telepítjük a hivatalos verziót, távolítsuk el a CVS változatot a - verzióproblémák elkerülésére! + Hozzunk létre egy érvényes csomagot a PEAR Telepítő felhasználásával + <command>pear package <útvonal a package.xml fájlhoz></command> + </para> + </listitem> + <listitem> + <para> + Ha már telepítettük a csomagot, távolítsuk el azt a különböző verziókból adódó + problémák elkerüléséhez: + <command>pear uninstall <package></command> + </para> + </listitem> + <listitem> + <para> + Telepítsük a csomagarchívumunkat: + <command>pear install <csomag-fájl></command> + </para> + <para> + Ezzel telepítettük a csomag CVS verzióját! + </para> + </listitem> + </orderedlist> + <para> + Frissítsük a csomagot egy hivatalos verzióra amilyen hamar csak lehetséges. + Mielőtt telepítjük a hivatalos verziót, távolítsuk el a CVS változatot a + verzióproblémák elkerülésére! </para> </sect1> + <sect1 id="installation.pecl"> + <title>Installing PECL packages</title> + <para> + The procedure of installing PECL packages is described in + <ulink url="&url.php.manual;en/install.pecl.php">the manual</ulink> + on the PHP website. + </para> + </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/diff.php/peardoc/hu/chapters/installation.xml?r1=1.7&r2=1.8&ty=u Index: peardoc/hu/chapters/installation.xml diff -u peardoc/hu/chapters/installation.xml:1.7 peardoc/hu/chapters/installation.xml:1.8 --- peardoc/hu/chapters/installation.xml:1.7 Sat Jun 18 20:04:57 2005 +++ peardoc/hu/chapters/installation.xml Wed Oct 5 16:45:29 2005 @@ -1,9 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2" ?> -<!-- EN-Revision: 1.20 Maintainer: norbert_m Status: ready --> -<!-- - WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING - THIS DOCUMENT YET. - --> +<!-- EN-Revision: 1.31 Maintainer: norbert_m Status: ready --> <chapter id="installation"> <chapterinfo> <author> @@ -23,17 +19,16 @@ <link linkend="about.pear">általános szerkezetét</link>. </para> <para> - Az alap telepítés, ami a PHP disztribúciójában, a <link - linkend="about-pfc">PFC</link> részeként kerül terjesztésre, + Az alap telepítés, ami a PHP disztribúciójával együtt kerül terjesztésre, tartalmazza az összes dolgot, ami szükséges a PEAR telepítőeszközök futtatásához. Ha rendelkezünk egy telepített PHP verzióval, - akkor a PEAR alapjai már a számítógépen vannak, ha a PHP fordításakor + akkor a PEAR alapjai már a számítógépen vannak, amennyiben a PHP fordításakor a <filename>./configure</filename> szkript futtatásakor a <literal>--without-pear</literal> opciót külön nem adtuk meg. </para> <para> - Azokat a csomagokat, amelyek nem részei a <link linkend="about-pfc"> - PFC</link>-nek a PEAR csomag-menedzserrel (PEAR package manager) + Azokat a csomagokat, amelyek nem részei a PHP disztribúciónak, + a PEAR csomag-menedzserrel (PEAR package manager) telepíthetjük. A menedzser a Debian <quote><ulink url="&url.debian.apt;"> apt-get</ulink></quote>-jéhez hasonlítható. Még egyszer: ha a számítógépen a PHP egy újabb verziója telepítve van (>4.3.0), @@ -88,14 +83,18 @@ gyökerében lévő <filename>c:\php\go-pear.bat</filename> kötegelt állományt. A telepítő néhány kérdést tesz fel, ezt követően a PEAR package manager telepítve lesz a telepítéskor megadott útvonalon. - Végül hozzá kell adni az útvonalat a PATH környezeti változóhoz - (Start > Vezérlőpult > Rendszer > Környezeti beállítások). + Végül hozzá kell adni az útvonalat a <literal>PATH</literal> + környezeti változóhoz. + Ezt megtehetjük kézzel (Start > Vezérlőpult > Rendszer > + Környezeti beállítások), vagy futtathatjuk (dupla kattintással) az + újonnan generált <filename>PEAR_ENV.reg</filename> fájlt a PHP + forrásának könyvtárából. Ezt követően elérhető a PEAR package manager, indítása a parancssorból történik, <literal>pear</literal> paranccsal. </para> <para> - A rendszeren lévő PEAR telepítés frissítéséhez navigáljunk a go-pear.org - címre egy böngészővel, és mentsük el a kimenetet egy helyi fájlba, + A rendszeren lévő PEAR telepítés frissítéséhez navigáljunk a &url.pear.go; + címre egy böngészőben, és mentsük el a kimenetet helyi fájlként, <filename>go-pear.php</filename> néven. Ezután parancssorból futtathatjuk a szkriptet a frissítési folyamat elindításához. <screen> @@ -109,16 +108,25 @@ <title>PEAR hosting környezetekben</title> <para> - Olyan oldalak esetében, melyek webhosting szolgáltatók tárhelyén - helyezkednek el, ahol nem rendelkezünk közvetlen hozzáféréssel a - tárhelyhez (helyi belépéssel, telnettel, vagy SSH-val), nem használható - a PEAR package manager. Ha egy ilyen cég ügyfelei vagyunk, nagyon + Olyan szolgáltatók tárhelyén, ahol nem rendelkezünk közvetlen + hozzáféréssel (helyi belépéssel, telnettel, vagy SSH-val), a PEAR + telepítő csak a PEAR_RemoteInstaller segítségével, FTP protokollon + keresztül használható (az sftp hozzáférés még nem támogatott). + </para> + <warning> + <simpara> + Az FTP nem biztonságos protokoll, mert a jelszavak kódolatlanul + kerülnek továbbításra a hálózaton. + </simpara> + </warning> + <para> + Ha egy okos cég ügyfelei vagyunk, nagyon valószínű, hogy a leggyakrabban használt PEAR csomagok már telepítve vannak a szerveren. Amennyiben ez nem így van, vagy további csomagokra - van szükségünk, lépjünk kapcsolatba a szolgáltatóval, és kérjük meg + van szükségünk, lépjünk kapcsolatba a szolgáltatóval és kérjük meg a csomag telepítésére. Ha a telepítést megtagadják, új szolgáltató után nézhetünk, vagy <link linkend="installation.manually">telepíthetjük - a csomagot kézzel</link>. + a csomagokat kézzel</link>. </para> </sect2> </sect1> @@ -175,10 +183,10 @@ <sect2> <title>Fél-automatikus telepítés</title> <para> - Ha egy package release-t .gzip-elt, tar-olt állományban töltöttünk le - a <ulink url="http://pear.php.net/">pear.php.net</ulink> oldalról, - telepíthetjük helyileg is. Ehhez a következő parancssort kell - lefuttatnunk: + Ha egy csomag egy megjelenését gzip-elt, tar-olt állományban + töltöttük le a <ulink url="&url.pear;">&url.pear;</ulink> webhelyről, + telepíthetjük helyileg is. Ehhez a következő parancssot kell + kiadnunk: </para> <para> <screen> @@ -223,10 +231,38 @@ </entry> </row> <row> + <entry>channel-add</entry> + <entry>Csatorna hozzáadása (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-alias</entry> + <entry>Álnév megadása egy csatornához (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-delete</entry> + <entry>Csatorna eltávolítása a listából (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-discover</entry> + <entry>Csatorna inicializálása a szerverének nevéből (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-info</entry> + <entry>Információ lekérése egy csatornáról (PEAR 1.4+)</entry> + </row> + <row> + <entry>channel-update</entry> + <entry>Létező csatorna frissítése (PEAR 1.4+)</entry> + </row> + <row> <entry>clear-cache</entry> <entry>Az XML-RPC gyorsítótár törlése</entry> </row> <row> + <entry>config-create</entry> + <entry>Alapértelmezett konfigurációs fájl létrehozása (PEAR 1.4+)</entry> + </row> + <row> <entry>config-get</entry> <entry>Egy konfigurációs beállítás lekérdezése</entry> </row> @@ -239,6 +275,10 @@ <entry>Konfigurációs beállítás módosítása egy megadott értékre</entry> </row> <row> + <entry>convert</entry> + <entry>Convert a package.xml 1.0 format to package.xml 2.0 format (PEAR 1.4+)</entry> + </row> + <row> <entry>config-show</entry> <entry>Az összes konfigurációs érték listázása</entry> </row> @@ -278,6 +318,14 @@ <entry>Minden csomag listázása (telepített és/vagy elérhető)</entry> </row> <row> + <entry>list-channels</entry> + <entry>Elérhető csatornák listázása (PEAR 1.4+)</entry> + </row> + <row> + <entry>list-files</entry> + <entry>Egy telepített csomag fájljainak listázása (PEAR 1.4+)</entry> + </row> + <row> <entry>list-upgrades</entry> <entry>A rendszeren telepített csomagokhoz elérhető frissítések listázása</entry> </row> @@ -306,6 +354,10 @@ <entry>Csomag konzisztenciájának ellenőrzése</entry> </row> <row> + <entry>run-scripts</entry> + <entry>Egy csomag telepítés utáni szkriptjeinek futtatása (PEAR 1.4+)</entry> + </row> + <row> <entry>remote-info</entry> <entry>Információ a távoli csomagokról</entry> </row> @@ -334,6 +386,10 @@ <entry>Egy csomag eltávolítása</entry> </row> <row> + <entry>update-channels</entry> + <entry>Csatornalista frissítése (PEAR 1.4+)</entry> + </row> + <row> <entry>upgrade</entry> <entry> Egy csomag frissítése az aktuális verzióra (lásd még: @@ -444,8 +500,34 @@ <entry> </entry> </row> <row> + <entry>remote_config</entry> + <entry> + Távoli konfigurációs fájl, egy helyi telepítés tükrözésére egy + távoli szerveren FTP protokollon keresztül (PEAR 1.4+) + </entry> + <entry> </entry> + </row> + <row> + <entry>auto_discover</entry> + <entry> + Új csatornák automatikus felderítése parancssorból vagy + függőségek alapján. + </entry> + <entry>0</entry> + </row> + <row> + <entry>default_channel</entry> + <entry>Alapértelmezett csatorna (PEAR 1.4+)</entry> + <entry>pear.php.net (pecl.php.net a pecl parancs használatakor)</entry> + </row> + <row> + <entry>preferred_mirror</entry> + <entry>Preferred channel mirror (PEAR 1.4+)</entry> + <entry>pear.php.net (pecl.php.net a pecl parancs használatakor)</entry> + </row> + <row> <entry>master_server</entry> - <entry>PEAR szerver</entry> + <entry>PEAR szerver [PEAR 1.4+ felett elavult]</entry> <entry>pear.php.net</entry> </row> <row> @@ -503,6 +585,7 @@ használhatjuk: </para> <para> + PEAR 1.3.5 és korábbi verziók <screen> <userinput> $ pear -s -c ~/.pearrc -d doc_dir=~/pear/docs -d ext_dir=~/pear/ext \ @@ -512,9 +595,16 @@ </screen> </para> <para> + PEAR 1.4+ + <screen> + <userinput> +$ pear config-create /home/user/pear .pearrc + </userinput> + </screen> + </para> + <para> Ezzel létrejön egy helyi konfigurációs fájl a home könyvtárunkban - <filename>.pearrc</filename> néven. Ezenkívül létrejön a könyvtárban egy - pear könyvtár, és ebbe kerül az összes telepített PEAR csomag. + <filename>.pearrc</filename> néven. </para> <para> Ezt követően ha hozzáadjuk a ~/pear/bin könyvtárat az elérési úthoz @@ -522,6 +612,7 @@ lefuttatjuk a következő parancssort: </para> <para> + PEAR 1.3.2 és korábbi verziók <screen> <userinput> $ pear -c ~/.pearrc install Archive_Tar PEAR Console_Getopt XML_RPC @@ -529,10 +620,21 @@ </screen> </para> <para> - akkor rendelkezni fogunk a PEAR egy helyi másolatával, ami hatástalanítja + PEAR 1.3.3+ + <screen> + <userinput> +$ pear install -o PEAR + </userinput> + </screen> + </para> + <para> + Ezáltal létrejön egy könyvtárszerkezet a home könyvtárunkban lévő + <filename>pear</filename> alkönyvtár alapján, a telepítendő csomagok + tárolására. + Így rendelkezni fogunk a PEAR egy helyi másolatával, ami hatástalanítja a rendszeren lévő másolatot. Az újonnan telepített fájlok használatához - hozzá kell adni a PHP include_path-hoz az új elérési utat, amit - megtehetünk kódból: + hozzá kell adni a PHP include_path direktívájához az új elérési utat, + amit megtehetünk kódból: </para> <para> <programlisting role="php"> @@ -548,46 +650,293 @@ </para> </sect2> <sect2 id="installation.shared.ftp"> - <title>A PEAR egy helyi másolatának telepítése ftp-n keresztül</title> + <title>A PEAR egy helyi másolatának telepítése FTP protokollon keresztül</title> <para> - A PEAR helyi másolatának ftp-n keresztül történő telepítésére szükségünk - van egy jogosultságokat beállítani képes ftp kliensre. Elsőként hozzunk - létre egy könyvtárat, ami NEM a publikusan elérhető webtárhelyen van, és - adjunk neki egy nevet. Állítsuk be bármilyen felhasználó által olvashatóra és - írhatóra (0777 jogosultságok), ezt követően töltsük le a - http://go-pear-org egy másolatát, és mentsünk el go-pear.php néven. - Töltsük fel egy alkönyvtárba a publikusan elérhető webtárhelyen. Ajánlott - a könyvtárat jelszóvédetté tenni egy .htaccess fájl segítségével. - </para> - <para> - Ezután jelenítsük meg böngészőnkben a feltöltött go-pear.php fájlt. Ha - webcímünk http://www.example.com, a go-pear.php-t a - public_html/install/go-pear.php elérési úton helyeztük el, és a - http://www.example.com/ a public_html/ könyvtárra mutat, akkor - böngészőnkben a http://www.example.com/install/go-pear.php -t - jelenítsük meg. Kövessük a telepítési utasításokat. Amikor a telepítő - megkérdezi, hogy hova szeretnénk telepíteni a PEAR-t, válasszuk azt a könyvtárat, - amelyet létrehoztunk és olvashatóvá-írhatóvá tettünk minden felhasználó - számára. Szükséges továbbá a PHP cli verziójának elérési útjának ismerete. - Ennek felderítéséhez a következő szkriptet használhatjuk: + Kétféle módszer létezik a PEAR helyi másolatának telepítésére + FTP protokollon keresztül: a régi, nehéz mód, és az új, könnyű mód. + Az új mód igénybevételéhez a PEAR legújabb változatára történő előzetes + frissítésre van szükség. </para> - <para> - <programlisting role="php"> + <sect3> + <title>Új, továbbfejlesztett módszer a PEAR 1.4.0 és a Net_FTP csomagok használatával</title> + <para> + A PEAR egy helyi példányának telepítése FTP protokollon keresztül a PEAR 1.4.0+ + verziójától kezdve nagyon leegyszerűsödött. + </para> + <para> + Sok felhasználó ütközött problémába a PEAR telepítése során távoli kiszolgálók + esetében, amelyeken nem rendelkeznek parancssori hozzáféréssel. Gyakran az + egyetlen lehetőségük az FTP használata volt, de ez nem hatékony megoldás olyan + összetett csomagok esetében, amelyek a telepítő különböző funkcióit + kihasználják (például a sztringcseréket). + </para> + <para> + A szükséges lépések a helyes távoli telepítéshez: + </para> + <para> + <orderedlist> + <listitem> + <para> + Győződjünk meg róla, hogy rendelkezünk működő parancssori PEAR telepítővel + számítógépünkön (a "pear" parancs, nem a webes felület). + </para> + </listitem> + <listitem> + <para> + Győződjünk meg róla, hogy rendelkezünk FTP hozzáféréssel a távoli szerveren, + és írási jogosultsággal FTP-n keresztül. + </para> + </listitem> + <listitem> + <para> + Jegyezzük fel a teljes elérési utat a home könyvtárunkhoz a távoli szerveren + </para> + </listitem> + <listitem> + <para> + Hozzunk létre egy testreszabott konfigurációs fájlt mind a helyi, + mind a távoli kiszolgálónak + </para> + </listitem> + <listitem> + <para> + Töltsük fel a távoli konfigurációs fájlt a távoli szerverre + </para> + </listitem> + <listitem> + <para> + A helyi konfigurációs fájlt felhasználva állítsuk be a remote_config + értéket a távoli szerveren található konfigurációs fájl helyére + </para> + </listitem> + <listitem> + <para> + Telepítsünk csomagokat tetszés szerint! + </para> + </listitem> + </orderedlist> + </para> + <para> + <emphasis> + 1. Győződjünk meg róla, hogy rendelkezünk működő parancssori PEAR telepítővel + számítógépünkön (a "pear" parancs, nem a webes felület). + </emphasis> + </para> + <para> + Olvassuk el a <ulink url="&url.pear.manual;/en/installation.cli.php">telepítési útmutatót</ulink>. + </para> + <para> + <emphasis> + 2. Győződjünk meg róla, hogy rendelkezünk FTP hozzáféréssel a távoli szerveren, + és írási jogosultsággal FTP-n keresztül. + </emphasis> + </para> + <para> + Ez nagyon egyszerű - amennyiben be tudunk jelentkezni a távoli szerverre + az FTP parancs használatával DOS parancssorból vagy UNIX shellből, rendelkezünk + FTP hozzáféréssel. SFTP hozzáférés egyelőre nem támogatott, de amint a Net_FTP + csomag támogatni fogja, elérhető lesz. + </para> + <para> + Jegyezzük fel a bejelentkezéshez használt felhasználói nevet és jelszót. + </para> + <para> + Az írási jogosultság tesztelése egyszerű. Ha tudunk fájlt feltölteni, van írási jogosultságunk. + </para> + <para> + <emphasis> + 3. Jegyezzük fel a teljes elérési utat a home könyvtárunkhoz a távoli szerveren + </emphasis> + </para> + <para> + Ez is nagyon egyszerű. Megállapításához töltsük fel a következő szkriptet a könyvtárunkba: + </para> + <para> + <programlisting> + <![CDATA[ +<?php + echo dirname(__FILE__); +?> + ]]> + </programlisting> + </para> + <para> + Valószínűleg a következőhöz hasonló eredményt kapunk: <filename>/home/username/htdocs</filename>. + Ha bejelentkezünk FTP-n keresztül és be tudunk lépni a /home/username könyvtárba, + jó úton járunk. + </para> + <para> + <emphasis> + 4. Hozzunk létre egy testreszabott konfigurációs fájlt mind a helyi, + mind a távoli kiszolgálónak + </emphasis> + </para> + <para> + A következőképpen tehetjük meg Windows és UNIX alatt: + </para> + <para> + Windows: + </para> + <para> + Válasszunk egy helyet a helyi számítógépen a távoli kód tárolására. + Például <filename>C:\remote\pear</filename>. Parancssorból + (Start menü => Kellékek => Parancssor) + hívjuk meg a következőket: + </para> + <para> + <screen> + <![CDATA[ +C:\> mkdir remote +C:\> cd remote +C:\remote\> mkdir pear +C:\remote\> cd pear +C:\remote\pear> pear config-create -w C:\remote\pear remote.ini +C:\remote\pear> pear config-create /home/username/pear .pearrc + ]]> + </screen> + </para> + <para> + Unix alatt is hasonlóképpen járjunk el: + </para> + <para> + <screen> + <![CDATA[ +$ cd +$ mkdir remote +$ cd remote +$ mkdir pear +$ cd pear +$ pear config-create /home/mylocaluser remote.conf +$ pear config-create /home/username/pear .pearrc + ]]> + </screen> + </para> + <para> + <emphasis> + 5. Töltsük fel a távoli konfigurációs fájlt a távoli szerverre + </emphasis> + </para> + <para> + Mindkét operációs rendszerben használjunk egy FTP programot a + <filename>.pearrc</filename> fájl feltöltésére + <filename>/home/username/pear/.pearrc</filename> néven. + </para> + <para> + <emphasis> + 6. A helyi konfigurációs fájlt felhasználva állítsuk be a remote_config + értéket a távoli szerveren található konfigurációs fájl helyére + </emphasis> + </para> + <para> + Windows: + </para> + <para> + <screen> + <![CDATA[ +C:\remote\pear\> pear -c remote.ini config-set remote_config ftp://user:pass@myremotehost.com/.pearrc + ]]> + </screen> + </para> + <para> + Unix: + </para> + <para> + <screen> + <![CDATA[ +$ pear -c remote.conf config-set remote_config ftp://user:pass@myremotehost.com/.pearrc + ]]> + </screen> + </para> + <para> + <emphasis> + 7. Telepítsünk csomagokat tetszés szerint! + </emphasis> + </para> + <para> + Ettől kezdve használhatjuk a pear parancsot a szokásos módon, amely + automatikusan szinkronizálni fogja a helyi és a távoli fájlokat. + </para> + <para> + <emphasis> + Hogyan működik? + </emphasis> + </para> + <para> + Egyszerű. A telepítő feltelepíti a csomagot helyileg, aztán a Net_FTP csomag + használatával minden helyileg telepített fájlt feltölt a megfelelő helyre + a távoli szerveren. Minden parancs, ami érinti a telepítést (install, upgrade + és az upgrade-all is) használható ezzel a módszerrel. A "remote_config" opció + mondja meg a telepítőnek hogy automatikusan tükröznie kell a helyi másolatot + a távoli szerverre. + </para> + <para> + Még izgalmasabb, hogy a távoli konfigurációs fájl kerül használatra sztringcserék + elvégzésekor. Magyarul, ha egy fájlnak szüksége van az adatfájlok útvonalára a + data_dir konfigurációs direktíván keresztül, akkor a távoli szerver elérési + útját fogja megkapni + (<filename>/home/username/pear/data</filename>) a helyi másolat útvonala helyett ( + <filename>C:\remote\pear\data</filename>). Ennek egy mellékhatása van: + a helyi másolat nem fog működni a helyi gépen, de ha egy biztonsági mentésként + gondolunk rá, akkor hasznosnak fogjuk találni (vészhelyetben bármikor feltölthetjük + a könyvtár egész tartalmát a távoli szerverre hagyományos FTP vagy SCP használatával). + </para> + <para> + Fontos megjegyezni, hogy néhány csomag eltérően települ Windows és Unix alatt. Egy ilyen + telepítés előtt győződjünk meg róla, hogy a telepíteni kívánt csomag esetében ez nem + így van, vagy használjunk megegyező operációs rendszereket a helyi és a távoli + számítógépeken. + </para> + </sect3> + <sect3> + <title>A hagyományos módszer a PEAR egy helyi másolatának telepítésére FTP-n keresztül</title> + <para> + A PEAR helyi másolatának ftp-n keresztül történő telepítésére szükségünk + van egy jogosultságokat beállítani képes FTP kliensre. Elsőként hozzunk + létre egy könyvtárat, ami NEM a publikusan elérhető webtárhelyen van, és + adjunk neki egy nevet. Állítsuk be minden felhasználó által olvashatóra és + írhatóra (0777 jogosultságok), ezt követően töltsük le a + &url.pear.go; egy másolatát, és mentsünk el go-pear.php néven. + Töltsük fel egy alkönyvtárba a publikusan elérhető webtárhelyen. Ajánlott + a könyvtárat jelszóvédetté tenni egy .htaccess fájl segítségével. + </para> + <para> + Ezután jelenítsük meg böngészőnkben a feltöltött go-pear.php fájlt. Ha + webcímünk &url.example.http;, a go-pear.php-t a + public_html/install/go-pear.php elérési úton helyeztük el, és a + &url.example.http; a public_html/ könyvtárra mutat, akkor + böngészőnkben a &url.example.http;install/go-pear.php -t + jelenítsük meg. Kövessük a telepítési utasításokat. Amikor a telepítő + megkérdezi, hogy hova szeretnénk telepíteni a PEAR-t, válasszuk azt a könyvtárat, + amelyet létrehoztunk és olvashatóvá-írhatóvá tettünk minden felhasználó + számára. Szükséges továbbá a PHP cli verziójának elérési útjának ismerete. + Ennek felderítéséhez a következő szkriptet használhatjuk: + </para> + <para> + <programlisting role="php"> <![CDATA[ <?php echo `which php`; // if this does not work, also try echo PHP_BIN; ?> ]]> - </programlisting> - </para> - <para> - Miután a PEAR telepítésre került, használhatjuk a web installert csomagok - telepítéséhez és frissítéséhez, ugyanúgy, mint bármilyen más PEAR telepítés - esetén tennénk. Az újonnan telepített fájlok használatához az új elérési - utat hozzá kell adni a PHP include_path-hoz, vagy az apache .htaccess - fájljában a php_value direktíva használatával hivatkozni kell rá. - </para> + </programlisting> + </para> + <para> + Miután a PEAR telepítésre került, ugyanúgy használhatjuk a web installert csomagok + telepítéséhez és frissítéséhez mint bármilyen más PEAR telepítés + esetén tennénk. Az újonnan telepített fájlok használatához az új elérési + utat hozzá kell adni a PHP include_path-jához. + </para> + <para> + <programlisting role="php"> +<![CDATA[ +<?php +ini_set('include_path', '~/pear/lib' . PATH_SEPARATOR . ini_get('include_path')); +?> +]]> + </programlisting> + </para> + </sect3> </sect2> </sect1> @@ -676,8 +1025,8 @@ </para> <para> Ha további kérdések merülnek fel a kézi telepítéssel kapcsolatban, - a <ulink url="&email.pear.general;">felhasználói levelezőlistán</ulink> - lehet segítséget kérni (angolul). + a <ulink url="mailto:&email.pear.general;">felhasználói levelezőlistán</ulink> + kérhetünk segítséget (angolul). </para> </sect1> @@ -688,89 +1037,97 @@ <para> Ez a fejezet az egyes csomagok legfrissebb, fejlesztés alatt álló verzióinak telepítéséről nyújt majd leírást. - </para> + </para> + <para> + NEM ajánlott csomagok CVS verzióinak használata éles környezetekben! + A CVS változatok nem szabályos megjelenések, ami a következőket jelenti: + <itemizedlist> + <listitem> + <simpara>Lehetséges, hogy nem kapunk semmiféle segítséget a csomag karbantartójától, vagy bárki mástól.</simpara> + </listitem> + <listitem> + <simpara>A CVS-ben lévő verziók tönkretehetik a PEAR Telepítő frissítő mechanizmusát.</simpara> + </listitem> + </itemizedlist> + </para> + <para> + Csak akkor használjunk csomagot a CVS-ből, ha: + <itemizedlist> + <listitem> + <simpara>A csomag karbantartója ajánlotta.</simpara> + </listitem> + <listitem> + <simpara>Egy csomag fejlesztésében szeretnénk részt venni.</simpara> + </listitem> + <listitem> + <simpara>Igazán szükségünk egy speciális foltra/funkcióra, ami még nem jelent meg.</simpara> + </listitem> + </itemizedlist> + </para> + <para> + Ha továbbra is meg vagyunk győződve arról, hogy egy csomag CVS verzióját szeretnénk + használni, akkor ugyanazokat a lépéseket kell elvégeznünk, amelyet a csomag karbantartója + végez a csomag egy új verziójának kiadásakor. Ha problémákba ütközünk a következő + lépések elvégzése során, lapozzuk fel a kézikönyv <link linkend="guide-developers">Fejlesztői + Kalauz</link>át! + </para> + <orderedlist> + <listitem> <para> - NEM ajánlott csomagok CVS verzióinak használata éles környezetekben! - A CVS változatok nem szabályos megjelenések, ami a következőket jelenti: - <itemizedlist> - <listitem> - <simpara>Lehetséges, hogy nem kapunk semmiféle segítséget a csomag karbantartójától, vagy bárki mástól.</simpara> - </listitem> - <listitem> - <simpara>A CVS-ben lévő verziók tönkretehetik a PEAR Telepítő frissítő mechanizmusát.</simpara> - </listitem> - </itemizedlist> + Szerezzük be a csomag fájljait a CVS-ből a <ulink url="&url.php.anoncvs;">&url.php.anoncvs;</ulink> + címen leírt módon. </para> <para> - Csak akkor használjunk csomagot a CVS-ből, ha: - <itemizedlist> - <listitem> - <simpara>A csomag karbantartója ajánlotta.</simpara> - </listitem> - <listitem> - <simpara>Egy csomag fejlesztésében szeretnénk részt venni.</simpara> - </listitem> - <listitem> - <simpara>Igazán szükségünk egy speciális foltra/funkcióra, ami még nem jelent meg.</simpara> - </listitem> - </itemizedlist> + A megszerzendő modul neve <filename>pear/<csomagnév></filename>, + például <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. </para> + </listitem> + <listitem> <para> - Ha továbbra is meg vagyunk győződve arról, hogy egy csomag CVS verzióját szeretnénk - használni, akkor ugyanazokat a lépéseket kell elvégeznünk, amelyet a csomag karbantartója - végez a csomag egy új verziójának kiadásakor. Ha problémákba ütközünk a következő - lépések elvégzése során, lapozzuk fel a kézikönyv <link linkend="guide-developers">Fejlesztői - Kalauz</link>át! + Vizsgáljuk meg a <filename>package.xml</filename> fájlt, különösen a fileset elemeket. + Meg kell egyezniük a meglévő fájl- és könyvtárstruktúrákkal. Ha eltérnek, lépjünk + kapcsolatba a karbantartóval, és kérjük el tőle a <filename>package.xml</filename> fájl + legfrissebb verzióját. </para> - <orderedlist> - <listitem> - <para> - Szerezzük be a csomag fájljait a CVS-ből a <ulink url="http://www.php.net/anoncvs.php">http://www.php.net/anoncvs.php</ulink> - címen leírt módon. - </para> - <para> - A megszerzendő modul neve <filename>pear/<csomagnév></filename>, - például <command> cvs -d :pserver:cvsread@cvs.php.net:/repository checkout pear/HTTP_Client</command>. - </para> - </listitem> - <listitem> - <para> - Vizsgáljuk meg a <filename>package.xml</filename> fájlt, különösen a fileset elemeket. - Meg kell egyezniük a meglévő fájl- és könyvtárstruktúrákkal. Ha eltérnek, lépjünk - kapcsolatba a karbantartóval, és kérjük el tőle a <filename>package.xml</filename> fájl - legfrissebb verzióját. - </para> - </listitem> - <listitem> - <para> - Hozzunk létre egy érvényes csomagot a PEAR Telepítő felhasználásával - <command>pear package <útvonal a package.xml fájlhoz></command> - </para> - </listitem> - <listitem> - <para> - Ha már telepítettük a csomagot, távolítsuk el azt a különböző verziókból adódó - problémák elkerüléséhez: - <command>pear uninstall <package></command> - </para> - </listitem> - <listitem> - <para> - Telepítsük a csomagarchívumunkat: - <command>pear install <csomag-fájl></command> - </para> - <para> - Ezzel telepítettük a csomag CVS verzióját! - </para> - </listitem> - </orderedlist> + </listitem> + <listitem> <para> - Frissítsük a csomagot egy hivatalos verzióra amilyen hamar csak lehetséges. - Mielőtt telepítjük a hivatalos verziót, távolítsuk el a CVS változatot a - verzióproblémák elkerülésére! + Hozzunk létre egy érvényes csomagot a PEAR Telepítő felhasználásával + <command>pear package <útvonal a package.xml fájlhoz></command> + </para> + </listitem> + <listitem> + <para> + Ha már telepítettük a csomagot, távolítsuk el azt a különböző verziókból adódó + problémák elkerüléséhez: + <command>pear uninstall <package></command> + </para> + </listitem> + <listitem> + <para> + Telepítsük a csomagarchívumunkat: + <command>pear install <csomag-fájl></command> + </para> + <para> + Ezzel telepítettük a csomag CVS verzióját! + </para> + </listitem> + </orderedlist> + <para> + Frissítsük a csomagot egy hivatalos verzióra amilyen hamar csak lehetséges. + Mielőtt telepítjük a hivatalos verziót, távolítsuk el a CVS változatot a + verzióproblémák elkerülésére! </para> </sect1> + <sect1 id="installation.pecl"> + <title>Installing PECL packages</title> + <para> + The procedure of installing PECL packages is described in + <ulink url="&url.php.manual;en/install.pecl.php">the manual</ulink> + on the PHP website. + </para> + </sect1> </chapter> <!-- Keep this comment at the end of the file Local variables: