cvs: peardoc /en/chapters installation.xml

mj Sat Sep 20 14:02:37 2003 EDT Modified files: /peardoc/en/chapters installation.xml Log: * Splitting installation instructions into *nix/Windows part Index: peardoc/en/chapters/installation.xml diff -u peardoc/en/chapters/installation.xml:1.9 peardoc/en/chapters/installation.xml:1.10 --- peardoc/en/chapters/installation.xml:1.9 Sat Aug 30 02:15:14 2003 +++ peardoc/en/chapters/installation.xml Sat Sep 20 14:02:36 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1" ?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <!-- WORK IN PROGRESS, THERE IS PROBABLY LITTLE POINT IN TRANSLATING THIS DOCUMENT YET. @@ -24,17 +24,18 @@ </para> <para> The base installation that comes with the PHP distribution as part - of the PFC, contains all the stuff that is needed to run the PEAR - installation tools etc. If you have a recent installation of PHP - 4, you can relax: The PEAR base installation is already installed - on your system, unless you have compiled your PHP with the - <filename>./configure</filename> flag '--without-pear'. + of the <link linkend="about-pfc">PFC</link>, contains all the stuff + that is needed to run the PEAR installation tools etc. If you have + a recent installation of PHP 4, you can relax: The PEAR base + installation is already there, unless you have compiled your PHP + with the <filename>./configure</filename> flag '--without-pear'. </para> <para> - The packages that are not part of the PFC can be installed with the PEAR + The packages that are not part of the + <link linkend="about-pfc">PFC</link> can be installed with the PEAR package manager. The manager is comparable to Debian's <quote>apt-get</quote>. Again: If you are running a recent version of PHP - (&gt; 4.3.0) you can skip the next paragraph. But if you are + (&gt; 4.3.0) you can skip the next section. But if you are running PHP 4.2.* or earlier, you need to manually install the manager. </para> <para> @@ -48,70 +49,75 @@ <sect1 id="installation.getting"> <title>Getting the PEAR package manager</title> - <simpara> - Linux: From PHP 4.3.0 and newer, PEAR Package Manager is installed - if no ./configure --without-pear was specified. - </simpara> - <note> + + <sect2> + <title>Unix/Linux/BSD</title> <para> - Some Linux distributions (e.g. Redhat) seem to be using - <filename>links</filename> instead of <filename>lynx</filename> - as the name for their command line browser. If this is the case - for you, you need to change the above line correspondingly. + When using PHP &gt;= 4.3.0, the PEAR Package Manager is already + installed unless one has used the <filename>./configure</filename> + option <literal>--without-pear</literal>. </para> - </note> - <simpara> - Windows: From PHP 4.3.2 and newer, go-pear script is bundled. - Please execute (double click on under Windows Explorer and the - like) - </simpara> - <para> - <screen> - <userinput> -drive:path\to\php\go-pear.bat - </userinput> - </screen> - </para> - <simpara> - Answer all relevant questions. - This should install the PEAR Package Manager in the path you - specified. Add this path to your PATH environment (start > - control panel > system > environment), type pear in a prompt - and the magic should operate. - </simpara> - <simpara> - For all of you who are not using the latest version of PHP - (&gt; 4.3.0) or wish to reinstall the Package Manager - a provisional way is provided. - You can execute the following command under linux - </simpara> - <para> - <screen> - <userinput> -&dollar; lynx -source http://go-pear.org | php - </userinput> - </screen> - </para> - <simpara> - Under Windows download the script from go-pear.org, - save it and run the following command - </simpara> - <para> - <screen> - <userinput> -php go-pear (or whatever you named the file) - </userinput> - </screen> - </para> - <simpara> - For those of you wondering if you can install pear on your webhost - you will not be able to use the pear command (unless you have an ssh - access to the server). Not all is lost though. The PEAR package manager - just simplifies the process of installing the packages. One way to go is - to install the pear command on your desktop and copy the files over to - the server. Don't forget you can use set_include_path() to make the - directory where you copied the PEAR files available across your site. - </simpara> + <para> + For all versions prior to 4.3.0 or if you want to re-install the + Package Manager, you can use the following provisional way: + <screen> + <userinput> +&dollar; lynx -source http://go-pear.org/ | php + </userinput> + </screen> + </para> + <note> + <para> + Some Linux distributions (e.g. Redhat) seem to be using + <filename>links</filename> instead of <filename>lynx</filename> + as the name for their command line browser. If this is the case + for you, you need to change the above line correspondingly. + </para> + </note> + </sect2> + + <sect2> + <title>Windows</title> + + <para> + After you have downloaded and installed PHP, you have to manually + execute the batch file located in e.g. + <filename>c:\php\go-pear.bat</filename>. The setup will ask you + some questions and afterwards the PEAR Package Manager will be + installed in the path, which you have specific during installation. + Finally you have to add that installation path to your PATH + environment (Start &gt; Control Panel &gt; System &gt; Environment). + After that you can access the PEAR Package Manager by running the + command <literal>pear</literal> in a Windows Command Prompt. + </para> + <para> + To update your PEAR installation from go-pear.org, request + http://go-pear.org/ in your browser and save the output to a local + file <filename>go-pear.php</filename>. You can then run + <screen> + <userinput> +php go-pear.php + </userinput> + </screen> + in a Windows Command Prompt to start the update process. + </para> + </sect2> + <sect2> + <title>PEAR in hosting environments</title> + + <para> + If you are running your site at a web hosting provider with no + direct access to the server (via local logins, telnet or ssh), you + can't use the PEAR Package Manager. If you are customer of a + smart web hosting company, the chances are very well that the + most commonly used PEAR packages are already installed on the + machine that is hosting your site. If that is not the case or if + you need additional packages, you should contact your provider and + ask them nicely to install the package. If they refuse to do so, + you can either look for a new web hosting company or you can + install the package manually. + </para> + </sect2> </sect1> <sect1 id="installation.cli"> <title>Command line installer</title>