cvs: phpdoc-he /chapters install.windows.xml
| From: | Hadar Porat | Date: | Thu, 17 Oct 2002 19:25:26 +0000 |
| Subject: | cvs: phpdoc-he /chapters install.windows.xml | ||
| Groups: | php.doc.he | ||
| Request: | Send a blank email to doc-he+get-22@lists.php.net to get a copy of this message | ||
hadar_p Thu Oct 17 15:25:26 2002 EDT
Modified files:
/phpdoc-he/chapters install.windows.xml
Log:
Half of the file finish
Index: phpdoc-he/chapters/install.windows.xml diff -u phpdoc-he/chapters/install.windows.xml:1.1 phpdoc-he/chapters/install.windows.xml:1.2 --- phpdoc-he/chapters/install.windows.xml:1.1 Sat Oct 5 14:47:30 2002 +++ phpdoc-he/chapters/install.windows.xml Thu Oct 17 15:25:26 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <sect1 id="install.windows"> <title>äú÷ðä òì îòøëåú Windows</title> <para> @@ -9,44 +9,42 @@ àðçðå îúééçñéí ìîòøëåú ä- Windows äðúîëåú ë- Win32 </para> <para> - There are two main ways to install PHP for Windows: either - <link linkend="install.windows.manual">manually</link> - or by using the <link linkend="install.windows.installer">InstallShield</link> - installer. + éùðï ùúé ùéèåú îøëæéåú ìäú÷éï àú PHP ì- Windows: àå + <link linkend="install.windows.manual">éãðéú</link> + àå òì éãé ùéîåù áîú÷éï ùì ä- + <link linkend="install.windows.installer">InstallShield</link>. </para> <para> - If you have Microsoft Visual Studio, you can also - <link linkend="install.windows.build">build</link> - PHP from the original source code. + àí éù ìê Microsoft Visual Studio, àúä âí úåëì + <link linkend="install.windows.build">ìáðåú</link> + àú PHP îä÷åã î÷åø äî÷åøé. </para> <para> - Once you have PHP installed on your Windows system, you may also - want to <link linkend="install.windows.extensions">load various extensions</link> - for added functionality. + áøâò ùäú÷ðú PHP òì îòøëú ä- Windows ùìê äåùìîä, àúä àåìé âí + úøöä <link linkend="install.windows.extensions">ìèòåï úåñôåú (extensions) ùåðåú</link> òì îðú ìäåñéó ôåð÷öéåðìéåú. </para> - + <sect2 id="install.windows.installer"> <title>Windows InstallShield</title> <para> - The Windows PHP installer available from the downloads page at - <ulink url="&url.php;">&url.php;</ulink>, this installs the CGI version - of PHP and, for IIS, PWS, and Xitami, configures the web server as - well. Also note, that while the InstallShield installer is an - easy way to make PHP work, it is restricted in many aspects, as - automatic setup of extensions for example is not supported. + äú÷ðú PHP ì- Windows æîéðä îòîåã ääåøãåú á- <ulink url="&url.php;">&url.php;</ulink>. + äú÷ðä æå îú÷éðä àú âøñú ä- CGI ùì PHP, åáùáéì IIS, PWS, å- Xitami, îâãéøä àú äùøú + ëîå-ëï. ùéí ìá âí ùáòåã ùäú÷ðú InstallShield äéà ãøê ÷ìä + ìòùåú ù- PHP éòáåã, äú÷ðä æå îöåîöîú áäéáèéí øáéí. + ìãåâîà, äú÷ðä àåèåîèéú ùì úåñôåú (extensions) ìà ðúîëú. </para> <simpara> - Install your selected <acronym>HTTP</acronym> server on your system - and make sure that it works. + äú÷ï àú ùøú <acronym>HTTP</acronym> äøöåé ìê òì äîòøëú ùìê + åáãå÷ ùäåà òåáã. </simpara> <simpara> - Run the executable installer and follow the instructions provided by - the installation wizard. Two types of installation are supported - - standard, which provides sensible defaults for all the settings it - can, and advanced, which asks questions as it goes along. + äôòì àú ÷åáõ ääú÷ðä åò÷åá àçø ääåøàåú ùîñåô÷åú òì + éãé àùó ääú÷ðä. ùðé ñåâé äú÷ðä ðúîëéí - + øâéìä (standard), àùø îòðé÷ä áøéøåú îçãì äâéåðéåú ìëì ääâãøåú, + åîú÷ãí (advanced), àùø ùåàìú ùàìåú áîäìê ääú÷ðä. </simpara> <simpara> @@ -59,44 +57,42 @@ </simpara> <simpara> - Once the installation has completed the installer will inform you - if you need to restart your system, restart the server, or just - start using PHP. + áøâò ùääú÷ðä äåùìîä, ääú÷ðä úåãéò ìê àí àúä öøéê ìäôòéì + îçãù àú äîòøëú ùìê, ìäôòéì îçãù àú äùøú, àå ø÷ ìäúçéì + ìäùúîù òí PHP. </simpara> <warning> <para> - Be aware, that this setup of PHP is not secure. If you would - like to have a secure PHP setup, you'd better go on the manual - way, and set every option carefully. This automatically working - setup gives you an instantly working PHP installation, but it is - not meant to be used on online servers. + úäéä îåãò, ùñåâ ääú÷ðä äæàú äéà ìà îàåáèçú. àí àúä øåöä + ìäú÷éï àú PHP áöåàä îàåáèçú, òãéó ìê ììëú áùéèä äéãðéú, + åìëååï ëì àôùøåú áæäéøåú. ääú÷ðä äàåèåîèéú ðåúðú äú÷ðä + ùì PHP îééãéú, àáì æä ìà îéåòã ìùéîåù òì ùøúéí î÷ååððéí. </para> </warning> </sect2> <sect2 id="install.windows.manual"> - <title>Manual Installation Steps</title> + <title>ùìáé äú÷ðä éãðéú</title> <simpara> - This install guide will help you manually install and configure - PHP on your Windows webserver. You need to download the - zip binary distribution from the downloads page at - <ulink url="&url.php;">&url.php;</ulink>. The original version - of this guide was compiled by &link.bob;, and can be found at <ulink - url="&url.win32install;">&url.win32install;</ulink>. + îãøéê äú÷ðä æä éòæåø ìê áäú÷ðä éãðéú åäâãøú PHP + òáåø ùøú ä- Windows ùìê. àúä öøéê ìäåøéã àú ä- Zip + ùì ääôöä äáéðàøéú îòîåã ääåøãåú á- <ulink url="&url.php;">&url.php;</ulink>. + äâøñä äî÷åøéú ùì îãøéê æä çåáøä ò"é &link.bob;, åéëåìä + ìäéîöà á- <ulink url="&url.win32install;">&url.win32install;</ulink>. </simpara> <para> - This guide provides manual installation support for: + îãøéê æä îñô÷ úîéëä áäú÷ðä éãðéú áùáéì: <itemizedlist> <listitem> <para> - Personal Web Server 3 and 4 or newer + Personal Web Server 3 å- 4 åîòìä </para> </listitem> <listitem> <para> - Internet Information Server 3 and 4 or newer + Internet Information Server 3 å- 4 åîòìä </para> </listitem> <listitem> @@ -106,7 +102,7 @@ </listitem> <listitem> <para> - OmniHTTPd 2.0b1 and up + OmniHTTPd 2.0b1 åîòìä </para> </listitem> <listitem> @@ -127,182 +123,172 @@ </itemizedlist> </para> <para> - PHP 4 for Windows comes in two flavours - a CGI executable (php.exe), - and several SAPI modules (for example: php4isapi.dll). The latter form - is new to PHP 4, and provides significantly improved performance and - some new functionality. + PHP 4 áùáéì Windows áà áùðé öåøåú - ééùåí CGI (php.exe), + åîñôø îåãåìé SAPI (ìãåâîà: php4isapi.dll). äöåøä äùðééä + äéà äçãùä ì- PHP 4 åîòðé÷ä áéöåòéí îùåôøéí åôåð÷öéåðìéåú + çãùä. </para> <warning> <simpara> - The SAPI modules have been significantly improved in the 4.1 release, - however, you may find that you encounter possible server errors or - other server modules such as ASP failing, in older systems. + îåãåìé SAPI ùåôøå áàåôï îùîòåúé áäôöä 4.1, ìîøåú æàú, + ééúëï åúôâåù ùâéàåú ùøú àå îåãåìé ùøú àçøéí ëîå ëéùìåï + ASP, áîòøëåú éùðåú éåúø. </simpara> </warning> <simpara> - If you choose one of the SAPI modules and use Windows 95, be sure - to download the DCOM update from the <ulink - url="&url.dcom.update;">Microsoft DCOM pages</ulink>. For the - ISAPI module, an ISAPI 4.0 compliant Web server is required - (tested on IIS 4.0, PWS 4.0 and IIS 5.0). IIS 3.0 is - <emphasis>NOT</emphasis> supported. You should download and - install the Windows NT 4.0 Option Pack with IIS 4.0 if you - want native PHP support. + àí àúä áçøú àçã îîåãåìé SAPI åàúä îùúîù á- Windows 95, úäéä áèåç + ìäåøéã àú òãëåï DCOM î<ulink url="&url.dcom.update;">òîåã ùì Microsoft DCOM</ulink>. + áùáéì ìäùúîù áîåãåì ISAPI, ùøú ISAPI 4.0 îúàéí ãøåù + (ðáã÷ òì IIS 4.0, PWS 4.0 åòì IIS 5.0). IIS 3.0 + <emphasis>ìà</emphasis> ðúîê. òìéê ìäåøéã åìäú÷éï + àú Windows NT 4.0 Option Pack äëåììú IIS 4.0 àí àúä + øåöä úîéëú PHP èáòéú. </simpara> <para> - The following steps should be performed on all installations - before the server specific instructions. + äùìáéí äáàéí öøéëéí ìäúáöò áëì ñåâé ääú÷ðåú, ìôðé + áéöåò äåøàåú ä÷ùåøåú ìñåâé äùøúéí. <itemizedlist> <listitem> <simpara> - Extract the distribution file to a directory of your choice. - <filename>c:\php\</filename> is a good start. You probably - do not want to use a path in which spaces are included (for - example: c:\program files\php is not a good idea). Some - web servers will crash if you do. + ôúç àú ëéååõ ääôöä ìúé÷ééä ùúáçø. <filename>c:\php\</filename> + äéà äúçìä èåáä. ÷øåá ìååãàé àúä ìà úøöä ìäùúîù áúé÷ééä + äëåììú øååçéí (ìãåâîà: c:\program files\php äéà ìà + øòéåï èåá). çì÷ îäùøúéí éôìå àí úòùä úòùä ëê. </simpara> </listitem> <listitem> <simpara> - You need to ensure that the DLLs which PHP uses can be found. - The precise DLLs involved depend on which web server you use - and whether you want to run PHP as a CGI or as a server module. - <filename>php4ts.dll</filename> is always used. If you are - using a server module (e.g. ISAPI or Apache) then you will - need the relevant DLL from the <filename>sapi</filename> - folder. If you are using any PHP extension DLLs then you - will need those as well. To make sure that the DLLs can be - found, you can either copy them to the system directory - (e.g. <filename>winnt/system32</filename> or - <filename>windows/system</filename>) or you can make sure - that they live in the same directory as the main PHP - executable or DLL your web server will use (e.g. - <filename>php.exe</filename>, <filename>php4apache.dll</filename>). + àúä öøéê ìååãà ù÷áöé ä- DLL ùàåúí PHP îùúîù áäí éëåìéí ìäéîöà. + ÷áöé ä- DLL äîãåéé÷éí úìåéí áàéæä ùøú àúä îùúîù åäàí àúä øåöä + ìäøéõ PHP ëééùåí CGI àå ëîåãåì ùøú. <filename>php4ts.dll</filename> + úîéã éäéä áùéîåù. àí àúä îùúîù áîåãåì ùøú (ëîå ISAPI àå Apache) + àæ àúä úöèøê àú ä- DLL äøìååðèé îúé÷ééú <filename>sapi</filename>. + àí àúä îùúîù áúåñôåú PHP ëìùäï, àæ àúä úöèøê àåúí âí ëï. + àúä éëåì ìååãà ù÷áöé ä- DLL éëåìéí ìäéîöà, àå òì éãé äòú÷úí + ìúé÷ééú äîòøëú (ëîå <filename>winnt/system32</filename> àå + <filename>windows/system</filename>) àå ìååãà ùäí ðîöàéí + áúé÷ééä äøàùéú ùì ééùåí PHP àå ä- DLL ùì äùøú ùáå àúä + îùúîù (ëîå <filename>php.exe</filename>, <filename>php4apache.dll + </filename>). </simpara> <para> - The PHP binary, the SAPI modules, and some extensions rely on - external DLLs for execution. Make sure that these DLLs in the - distribution exist in a directory that is in the Windows PATH. - The best bet to do it is to copy the files below into your - system directory, which is typically: + ééùåí PHP, îåãåìé SAPI, åîñôø úåñôåú ðòæøéí á÷áöé DLL çéöåðééí + òì îðú ìôòåì. úååãà ù÷áöé DLL àìå áäôöä ÷ééîéí áúé÷ééä äîåâãøú + á- Windows PATH. äùéèä äëé èåáä ìòùåú àú æä äéà ìäòúé÷ àú ä÷áöéí + äáàéí ìúé÷ééú äîòøëú, ùäí áãøê ëìì: <simplelist> <member> - <filename>c:\windows\system</filename> for Windows 9x/ME + <filename>c:\windows\system</filename> ìâáé Windows 9x/ME </member> <member> - <filename>c:\winnt\system32</filename> for Windows NT/2000 + <filename>c:\winnt\system32</filename> ìâáé Windows NT/2000 </member> <member> - <filename>c:\windows\system32</filename> for Windows XP + <filename>c:\windows\system32</filename> ìâáé Windows XP </member> </simplelist> - The files to copy are: + ä÷áöéí ìäòúé÷ äí: <simplelist> <member> - <filename>php4ts.dll</filename>, if it already exists there, - overwrite it + <filename>php4ts.dll</filename>, àí äåà ëáø ÷ééí ùí, + ëúåá òìéå. </member> <member> - The files in your distribution's 'dlls' directory. - If you have them already installed on your system, overwrite them - only if something doesn't work correctly (Before overwriting them, - it is a good idea to make a backup of them, or move them to - another folder - just in case something goes wrong). + ä÷áöéí áúé÷ééú 'dlls' áäôöä ùìê. àí àúä ëáø + äú÷ðú àåúí òì äîòøëú ùìê, ëúåá òìéäí ø÷ àí îùäå ìà òåáã + ëøàåé (ìôðé ëúéáä òìéäí, æä øòéåï èåá ìòùåú âéáåé ìäí, + àå ìäòáéø àåúí ìúé÷ééä àçøú - ø÷ áî÷øä ùîùäå ééìê øò). </member> </simplelist> </para> <para> - Download the latest version of the Microsoft Data Access Components - (MDAC) for your platform, especially if you use Microsoft Windows - 9x/NT4. MDAC is available at <ulink url="&url.mdac;">&url.mdac;</ulink>. + äåøã àú äâøñä äàçøåðä ùìê Microsoft Data Access Components + (MDAC) ìôìôåøîä ùìê, áòé÷ø àí àúä îùúîù á- Microsoft Windows + 9x/NT4. MDAC éëåì ìäéîöà á- <ulink url="&url.mdac;">&url.mdac;</ulink>. </para> </listitem> <listitem> <para> - Copy your chosen ini file (see below) to your - '%WINDOWS%' directory on Windows 9x/Me or to your - '%SYSTEMROOT%' directory under Windows NT/2000/XP - and rename it to &php.ini;. Your - '%WINDOWS%' or '%SYSTEMROOT%' directory is - typically: + äòú÷ àú ÷åáõ ä- ini ùáçøú (øàä ìîèä) ìúé÷ééä '%WINDOWS%' + òì Windows 9x/Me àå ìúé÷ééä '%SYSTEMROOT%' òì + Windows NT/2000/XP åùðä àú ùí ä÷åáõ ì- &php.ini;. äúé÷ééä + '%WINDOWS%' or '%SYSTEMROOT%' ùìê äéà + áãøê ëìì: <simplelist> - <member><filename>c:\windows</filename> for Windows 9x/ME/XP</member> - <member><filename>c:\winnt</filename> or <filename>c:\winnt40</filename> for NT/2000 servers</member> + <member><filename>c:\windows</filename> ìâáé Windows 9x/ME/XP</member> + <member><filename>c:\winnt</filename> àå <filename>c:\winnt40</filename> ìâáé ùøúé NT/2000</member> </simplelist> </para> <para> - There are two ini files distributed in the zip file, - <filename>php.ini-dist</filename> and - <filename>php.ini-optimized</filename>. We advise - you to use <filename>php.ini-optimized</filename>, - because we optimized the default settings in this - file for performance, and security. The best is to - study all the <link linkend="configuration.file">ini - settings</link> and set every element manually yourself. - If you would like to achieve the best security, then this - is the way for you, although PHP works fine with these - default ini files. + éùðí ùðé ÷áöé ini îåôöéí á÷åáõ Zip, + <filename>php.ini-dist</filename> å- + <filename>php.ini-optimized</filename>. àðçðå îîìéöéí + ìê ìäùúîù á- <filename>php.ini-optimized</filename>, + îùåí ùàðçðå ééòìðå àú ääâãøåú á÷åáõ æä ìáéöåòéí, + åìàáèçä. äùéèä äëé èåáä ììîåã àú ëì <link linkend="configuration.file">äâãøåú + ini</link> äéà ìäâãéø ëì àìîðè éãðéú áòöîê. + àí àúä îòåðééï ìäùéâ àú äàáèçä äèåáä áéåúø, àæ æàú + äùéèä áùáéìê, ìîøåú ù- PHP éòáåã èåá òí ääâãøåú + ùì ä- ini äî÷åøééí. </para> </listitem> <listitem> <para> - Edit your new &php.ini; file: + òøåê àú ÷åáõ &php.ini; äçãù ùìê: <itemizedlist> <listitem> <simpara> - You will need to change the 'extension_dir' setting to - point to your php-install-dir, or where you have placed - your <filename>php_*.dll</filename> files. Please do not - forget the last backslash. ex: - <filename>c:\php\extensions\</filename> + àúä úöèøê ìùðåú àú äâãøú 'extension_dir' ùúöáéò + àì php-install-dir, àå ìàï ùàúä ùîú àú ä÷áöéí + <filename>php_*.dll</filename> ùìê. ùéí ìá ìà + ìùëåç àú äìåëñï äàçøåï, ìãåâîà: + <filename>c:\php\extensions\</filename> </simpara> </listitem> <listitem> <simpara> - If you are using OmniHTTPd, do not follow the next step. - Set the 'doc_root' to point to your webservers - document_root. For example: <filename>c:\apache\htdocs</filename> - or <filename>c:\webroot</filename> + àí àúä îùúîù á- OmniHTTPd, àì úáöò àú äùìá äáà. + äâãø àú 'doc_root' ùéöáéò ì- document_root ùì + ùøúé ä- Web ùìê. ìãåâîà, <filename>c:\apache\htdocs</filename> + àå <filename>c:\webroot</filename> </simpara> </listitem> <listitem> <simpara> - Choose which extensions you would like to load when PHP - starts. See the section about - <link linkend="install.windows.extensions">Windows - extensions</link>, about how to set up one, and what - is already built in. Note that on a new installation - it is advisable to first get PHP working and tested - without any extensions before enabling them in - &php.ini;. + áçø àéæä úåñôåú àúä øåöä ìèòåï îúé ù- PHP + îúçéì. øàä àú äçì÷ áðåùà <link linkend="install.windows.extensions">úåñôåú + Windows</link> äëåìì àéê ìäôòéì úåñôú, åàéæä + úåñôåú ëáø ðëììå. ùéí ìá ùáäú÷ðä çãùä, + îåîìõ ìäôòéì åìðñåú àú PHP áôòí äøàùåðä + áìé úåñôåú, ìôðé ùàúä îôòéì àåúí á- &php.ini;. </simpara> </listitem> <listitem> <simpara> - On PWS and IIS, you can set the <filename>browscap.ini</filename> - to point to: - <filename>c:\windows\system\inetsrv\browscap.ini</filename> on + òì PWS å- IIS, àúä éëåì ìäâãéø àú <filename>browscap.ini</filename> + ùéöáéò àì: + <filename>c:\windows\system\inetsrv\browscap.ini</filename> òì Windows 9x/Me, - <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> on - NT/2000, and + <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> òì + NT/2000, å- <filename>c:\windows\system32\inetsrv\browscap.ini</filename> - on XP. + òì XP. </simpara> </listitem> <listitem> <simpara> - Note that the <filename>mibs</filename> directory supplied - with the Windows distribution contains support files for - SNMP. This directory should be moved to - <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> - being the drive where PHP is installed.) + ùéí ìá ùúé÷ééú<filename>mibs</filename> äîñåô÷ú + òí äôöú ä- Windows îëéìä ÷áöé úîéëä áùáéì + SNMP. äúé÷ééä äæàú öøéëä ìòáåø ì- + <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> + äåà äëåðï ùáå PHP îåú÷ï.) </simpara> </listitem> <listitem> <simpara> - If you're using NTFS on Windows NT, 2000 or XP, make sure that - the user running the webserver has read permissions to your - &php.ini; (e.g. make it readable by Everyone). + àí àúä îùúîù á- NTFS òì Windows NT, 2000 àå XP, ååãà ëé + ìîùúîù ùîøéõ àú ùøú ä- Web éù äøùàåú ÷øéàä ì- &php.ini; ùìê + (ìãåâîà, äâãø àåúå ì÷øéàä ò"é ëåìí). </simpara> </listitem> </itemizedlist> @@ -310,21 +296,21 @@ </listitem> <listitem> <para> - For PWS give execution permission to the webroot: + áùáéì PWS äâãø äøùàú áéöåò (execution) ì- webroot: <itemizedlist> <listitem> <simpara> - Start PWS Web Manager + äúçì àú PWS Web Manager </simpara> </listitem> <listitem> <simpara> - Edit Properties of the "Home"-Directory + òøåê îàôééðéí ùì úé÷ééú "Home" </simpara> </listitem> <listitem> <simpara> - Select the "execute"-Checkbox + áçø àú àôùøåú ä- "execute" </simpara> </listitem> </itemizedlist> @@ -337,10 +323,10 @@ </sect2> <sect2 id="install.windows.build"> - <title>Building from source</title> + <title>áðééä îî÷åø</title> <para> - Before getting started, it is worthwhile answering the question: - "Why is building on Windows so hard?" Two reasons come to mind: + ìôðé ùîúçéìéí, æä îùúìí ìòðåú òì äùàìä: ìîä äáðééä òì Windows + äéà ëì ëê ÷ùä?" ùúé ñéáåú áàåú ìîçùáä: </para> <orderedlist> <listitem><simpara> @@ -353,27 +339,26 @@ this heritage shows through from time to time. </simpara></listitem> <listitem><simpara> - Pretty much all of the instructions that follow are of the - "set and forget" variety. So sit back and try follow the - instructions below as faithfully as you can. + áîéãä âãåìä ëé ääåøàåú ùìäìï äí îñåâ "äâãø åùëç". + àæ úúøååç åðñä ìò÷åá àçøé ääåøàåú äáàåú áðàîðåú + ëëì ùàúä éëåì. </simpara></listitem> </orderedlist> <sect3 id="install.windows.build.prepare"> - <title>Preparations</title> + <title>äëðåú</title> <para> - Before you get started, you have a lot to download... + ìôðé ùàúä îúçéì, éù ìê äøáä ìäåøéã... </para> <itemizedlist> <listitem><simpara> - For starters, get the Cygwin toolkit from the closest <ulink - url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink> - mirror site. This will provide you most of the popular GNU - utilities used by the build process. + áùáéì ääúçìä, äùâ àú Cygwin toolkit îùøú äøàé ä÷øåá + ùì <ulink url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink>. + æä éñô÷ ìê àú øåá úåëðåú äòæø ùúöèøê áúäìéê äáðééä. </simpara></listitem> <listitem><simpara> - Download the rest of the build tools you will need from the PHP - site at <ulink url="http://www.php.net/extra/win32build.zip" + äåøã àú ùàø ëìé äáðééä ùàúä öøéê îàúø PHP áëúåáú + <ulink url="http://www.php.net/extra/win32build.zip" >http://www.php.net/extra/win32build.zip</ulink>. </simpara></listitem> <listitem><simpara>
Index: phpdoc-he/chapters/install.windows.xml diff -u phpdoc-he/chapters/install.windows.xml:1.1 phpdoc-he/chapters/install.windows.xml:1.2 --- phpdoc-he/chapters/install.windows.xml:1.1 Sat Oct 5 14:47:30 2002 +++ phpdoc-he/chapters/install.windows.xml Thu Oct 17 15:25:26 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <sect1 id="install.windows"> <title>äú÷ðä òì îòøëåú Windows</title> <para> @@ -9,44 +9,42 @@ àðçðå îúééçñéí ìîòøëåú ä- Windows äðúîëåú ë- Win32 </para> <para> - There are two main ways to install PHP for Windows: either - <link linkend="install.windows.manual">manually</link> - or by using the <link linkend="install.windows.installer">InstallShield</link> - installer. + éùðï ùúé ùéèåú îøëæéåú ìäú÷éï àú PHP ì- Windows: àå + <link linkend="install.windows.manual">éãðéú</link> + àå òì éãé ùéîåù áîú÷éï ùì ä- + <link linkend="install.windows.installer">InstallShield</link>. </para> <para> - If you have Microsoft Visual Studio, you can also - <link linkend="install.windows.build">build</link> - PHP from the original source code. + àí éù ìê Microsoft Visual Studio, àúä âí úåëì + <link linkend="install.windows.build">ìáðåú</link> + àú PHP îä÷åã î÷åø äî÷åøé. </para> <para> - Once you have PHP installed on your Windows system, you may also - want to <link linkend="install.windows.extensions">load various extensions</link> - for added functionality. + áøâò ùäú÷ðú PHP òì îòøëú ä- Windows ùìê äåùìîä, àúä àåìé âí + úøöä <link linkend="install.windows.extensions">ìèòåï úåñôåú (extensions) ùåðåú</link> òì îðú ìäåñéó ôåð÷öéåðìéåú. </para> - + <sect2 id="install.windows.installer"> <title>Windows InstallShield</title> <para> - The Windows PHP installer available from the downloads page at - <ulink url="&url.php;">&url.php;</ulink>, this installs the CGI version - of PHP and, for IIS, PWS, and Xitami, configures the web server as - well. Also note, that while the InstallShield installer is an - easy way to make PHP work, it is restricted in many aspects, as - automatic setup of extensions for example is not supported. + äú÷ðú PHP ì- Windows æîéðä îòîåã ääåøãåú á- <ulink url="&url.php;">&url.php;</ulink>. + äú÷ðä æå îú÷éðä àú âøñú ä- CGI ùì PHP, åáùáéì IIS, PWS, å- Xitami, îâãéøä àú äùøú + ëîå-ëï. ùéí ìá âí ùáòåã ùäú÷ðú InstallShield äéà ãøê ÷ìä + ìòùåú ù- PHP éòáåã, äú÷ðä æå îöåîöîú áäéáèéí øáéí. + ìãåâîà, äú÷ðä àåèåîèéú ùì úåñôåú (extensions) ìà ðúîëú. </para> <simpara> - Install your selected <acronym>HTTP</acronym> server on your system - and make sure that it works. + äú÷ï àú ùøú <acronym>HTTP</acronym> äøöåé ìê òì äîòøëú ùìê + åáãå÷ ùäåà òåáã. </simpara> <simpara> - Run the executable installer and follow the instructions provided by - the installation wizard. Two types of installation are supported - - standard, which provides sensible defaults for all the settings it - can, and advanced, which asks questions as it goes along. + äôòì àú ÷åáõ ääú÷ðä åò÷åá àçø ääåøàåú ùîñåô÷åú òì + éãé àùó ääú÷ðä. ùðé ñåâé äú÷ðä ðúîëéí - + øâéìä (standard), àùø îòðé÷ä áøéøåú îçãì äâéåðéåú ìëì ääâãøåú, + åîú÷ãí (advanced), àùø ùåàìú ùàìåú áîäìê ääú÷ðä. </simpara> <simpara> @@ -59,44 +57,42 @@ </simpara> <simpara> - Once the installation has completed the installer will inform you - if you need to restart your system, restart the server, or just - start using PHP. + áøâò ùääú÷ðä äåùìîä, ääú÷ðä úåãéò ìê àí àúä öøéê ìäôòéì + îçãù àú äîòøëú ùìê, ìäôòéì îçãù àú äùøú, àå ø÷ ìäúçéì + ìäùúîù òí PHP. </simpara> <warning> <para> - Be aware, that this setup of PHP is not secure. If you would - like to have a secure PHP setup, you'd better go on the manual - way, and set every option carefully. This automatically working - setup gives you an instantly working PHP installation, but it is - not meant to be used on online servers. + úäéä îåãò, ùñåâ ääú÷ðä äæàú äéà ìà îàåáèçú. àí àúä øåöä + ìäú÷éï àú PHP áöåàä îàåáèçú, òãéó ìê ììëú áùéèä äéãðéú, + åìëååï ëì àôùøåú áæäéøåú. ääú÷ðä äàåèåîèéú ðåúðú äú÷ðä + ùì PHP îééãéú, àáì æä ìà îéåòã ìùéîåù òì ùøúéí î÷ååððéí. </para> </warning> </sect2> <sect2 id="install.windows.manual"> - <title>Manual Installation Steps</title> + <title>ùìáé äú÷ðä éãðéú</title> <simpara> - This install guide will help you manually install and configure - PHP on your Windows webserver. You need to download the - zip binary distribution from the downloads page at - <ulink url="&url.php;">&url.php;</ulink>. The original version - of this guide was compiled by &link.bob;, and can be found at <ulink - url="&url.win32install;">&url.win32install;</ulink>. + îãøéê äú÷ðä æä éòæåø ìê áäú÷ðä éãðéú åäâãøú PHP + òáåø ùøú ä- Windows ùìê. àúä öøéê ìäåøéã àú ä- Zip + ùì ääôöä äáéðàøéú îòîåã ääåøãåú á- <ulink url="&url.php;">&url.php;</ulink>. + äâøñä äî÷åøéú ùì îãøéê æä çåáøä ò"é &link.bob;, åéëåìä + ìäéîöà á- <ulink url="&url.win32install;">&url.win32install;</ulink>. </simpara> <para> - This guide provides manual installation support for: + îãøéê æä îñô÷ úîéëä áäú÷ðä éãðéú áùáéì: <itemizedlist> <listitem> <para> - Personal Web Server 3 and 4 or newer + Personal Web Server 3 å- 4 åîòìä </para> </listitem> <listitem> <para> - Internet Information Server 3 and 4 or newer + Internet Information Server 3 å- 4 åîòìä </para> </listitem> <listitem> @@ -106,7 +102,7 @@ </listitem> <listitem> <para> - OmniHTTPd 2.0b1 and up + OmniHTTPd 2.0b1 åîòìä </para> </listitem> <listitem> @@ -127,182 +123,172 @@ </itemizedlist> </para> <para> - PHP 4 for Windows comes in two flavours - a CGI executable (php.exe), - and several SAPI modules (for example: php4isapi.dll). The latter form - is new to PHP 4, and provides significantly improved performance and - some new functionality. + PHP 4 áùáéì Windows áà áùðé öåøåú - ééùåí CGI (php.exe), + åîñôø îåãåìé SAPI (ìãåâîà: php4isapi.dll). äöåøä äùðééä + äéà äçãùä ì- PHP 4 åîòðé÷ä áéöåòéí îùåôøéí åôåð÷öéåðìéåú + çãùä. </para> <warning> <simpara> - The SAPI modules have been significantly improved in the 4.1 release, - however, you may find that you encounter possible server errors or - other server modules such as ASP failing, in older systems. + îåãåìé SAPI ùåôøå áàåôï îùîòåúé áäôöä 4.1, ìîøåú æàú, + ééúëï åúôâåù ùâéàåú ùøú àå îåãåìé ùøú àçøéí ëîå ëéùìåï + ASP, áîòøëåú éùðåú éåúø. </simpara> </warning> <simpara> - If you choose one of the SAPI modules and use Windows 95, be sure - to download the DCOM update from the <ulink - url="&url.dcom.update;">Microsoft DCOM pages</ulink>. For the - ISAPI module, an ISAPI 4.0 compliant Web server is required - (tested on IIS 4.0, PWS 4.0 and IIS 5.0). IIS 3.0 is - <emphasis>NOT</emphasis> supported. You should download and - install the Windows NT 4.0 Option Pack with IIS 4.0 if you - want native PHP support. + àí àúä áçøú àçã îîåãåìé SAPI åàúä îùúîù á- Windows 95, úäéä áèåç + ìäåøéã àú òãëåï DCOM î<ulink url="&url.dcom.update;">òîåã ùì Microsoft DCOM</ulink>. + áùáéì ìäùúîù áîåãåì ISAPI, ùøú ISAPI 4.0 îúàéí ãøåù + (ðáã÷ òì IIS 4.0, PWS 4.0 åòì IIS 5.0). IIS 3.0 + <emphasis>ìà</emphasis> ðúîê. òìéê ìäåøéã åìäú÷éï + àú Windows NT 4.0 Option Pack äëåììú IIS 4.0 àí àúä + øåöä úîéëú PHP èáòéú. </simpara> <para> - The following steps should be performed on all installations - before the server specific instructions. + äùìáéí äáàéí öøéëéí ìäúáöò áëì ñåâé ääú÷ðåú, ìôðé + áéöåò äåøàåú ä÷ùåøåú ìñåâé äùøúéí. <itemizedlist> <listitem> <simpara> - Extract the distribution file to a directory of your choice. - <filename>c:\php\</filename> is a good start. You probably - do not want to use a path in which spaces are included (for - example: c:\program files\php is not a good idea). Some - web servers will crash if you do. + ôúç àú ëéååõ ääôöä ìúé÷ééä ùúáçø. <filename>c:\php\</filename> + äéà äúçìä èåáä. ÷øåá ìååãàé àúä ìà úøöä ìäùúîù áúé÷ééä + äëåììú øååçéí (ìãåâîà: c:\program files\php äéà ìà + øòéåï èåá). çì÷ îäùøúéí éôìå àí úòùä úòùä ëê. </simpara> </listitem> <listitem> <simpara> - You need to ensure that the DLLs which PHP uses can be found. - The precise DLLs involved depend on which web server you use - and whether you want to run PHP as a CGI or as a server module. - <filename>php4ts.dll</filename> is always used. If you are - using a server module (e.g. ISAPI or Apache) then you will - need the relevant DLL from the <filename>sapi</filename> - folder. If you are using any PHP extension DLLs then you - will need those as well. To make sure that the DLLs can be - found, you can either copy them to the system directory - (e.g. <filename>winnt/system32</filename> or - <filename>windows/system</filename>) or you can make sure - that they live in the same directory as the main PHP - executable or DLL your web server will use (e.g. - <filename>php.exe</filename>, <filename>php4apache.dll</filename>). + àúä öøéê ìååãà ù÷áöé ä- DLL ùàåúí PHP îùúîù áäí éëåìéí ìäéîöà. + ÷áöé ä- DLL äîãåéé÷éí úìåéí áàéæä ùøú àúä îùúîù åäàí àúä øåöä + ìäøéõ PHP ëééùåí CGI àå ëîåãåì ùøú. <filename>php4ts.dll</filename> + úîéã éäéä áùéîåù. àí àúä îùúîù áîåãåì ùøú (ëîå ISAPI àå Apache) + àæ àúä úöèøê àú ä- DLL äøìååðèé îúé÷ééú <filename>sapi</filename>. + àí àúä îùúîù áúåñôåú PHP ëìùäï, àæ àúä úöèøê àåúí âí ëï. + àúä éëåì ìååãà ù÷áöé ä- DLL éëåìéí ìäéîöà, àå òì éãé äòú÷úí + ìúé÷ééú äîòøëú (ëîå <filename>winnt/system32</filename> àå + <filename>windows/system</filename>) àå ìååãà ùäí ðîöàéí + áúé÷ééä äøàùéú ùì ééùåí PHP àå ä- DLL ùì äùøú ùáå àúä + îùúîù (ëîå <filename>php.exe</filename>, <filename>php4apache.dll + </filename>). </simpara> <para> - The PHP binary, the SAPI modules, and some extensions rely on - external DLLs for execution. Make sure that these DLLs in the - distribution exist in a directory that is in the Windows PATH. - The best bet to do it is to copy the files below into your - system directory, which is typically: + ééùåí PHP, îåãåìé SAPI, åîñôø úåñôåú ðòæøéí á÷áöé DLL çéöåðééí + òì îðú ìôòåì. úååãà ù÷áöé DLL àìå áäôöä ÷ééîéí áúé÷ééä äîåâãøú + á- Windows PATH. äùéèä äëé èåáä ìòùåú àú æä äéà ìäòúé÷ àú ä÷áöéí + äáàéí ìúé÷ééú äîòøëú, ùäí áãøê ëìì: <simplelist> <member> - <filename>c:\windows\system</filename> for Windows 9x/ME + <filename>c:\windows\system</filename> ìâáé Windows 9x/ME </member> <member> - <filename>c:\winnt\system32</filename> for Windows NT/2000 + <filename>c:\winnt\system32</filename> ìâáé Windows NT/2000 </member> <member> - <filename>c:\windows\system32</filename> for Windows XP + <filename>c:\windows\system32</filename> ìâáé Windows XP </member> </simplelist> - The files to copy are: + ä÷áöéí ìäòúé÷ äí: <simplelist> <member> - <filename>php4ts.dll</filename>, if it already exists there, - overwrite it + <filename>php4ts.dll</filename>, àí äåà ëáø ÷ééí ùí, + ëúåá òìéå. </member> <member> - The files in your distribution's 'dlls' directory. - If you have them already installed on your system, overwrite them - only if something doesn't work correctly (Before overwriting them, - it is a good idea to make a backup of them, or move them to - another folder - just in case something goes wrong). + ä÷áöéí áúé÷ééú 'dlls' áäôöä ùìê. àí àúä ëáø + äú÷ðú àåúí òì äîòøëú ùìê, ëúåá òìéäí ø÷ àí îùäå ìà òåáã + ëøàåé (ìôðé ëúéáä òìéäí, æä øòéåï èåá ìòùåú âéáåé ìäí, + àå ìäòáéø àåúí ìúé÷ééä àçøú - ø÷ áî÷øä ùîùäå ééìê øò). </member> </simplelist> </para> <para> - Download the latest version of the Microsoft Data Access Components - (MDAC) for your platform, especially if you use Microsoft Windows - 9x/NT4. MDAC is available at <ulink url="&url.mdac;">&url.mdac;</ulink>. + äåøã àú äâøñä äàçøåðä ùìê Microsoft Data Access Components + (MDAC) ìôìôåøîä ùìê, áòé÷ø àí àúä îùúîù á- Microsoft Windows + 9x/NT4. MDAC éëåì ìäéîöà á- <ulink url="&url.mdac;">&url.mdac;</ulink>. </para> </listitem> <listitem> <para> - Copy your chosen ini file (see below) to your - '%WINDOWS%' directory on Windows 9x/Me or to your - '%SYSTEMROOT%' directory under Windows NT/2000/XP - and rename it to &php.ini;. Your - '%WINDOWS%' or '%SYSTEMROOT%' directory is - typically: + äòú÷ àú ÷åáõ ä- ini ùáçøú (øàä ìîèä) ìúé÷ééä '%WINDOWS%' + òì Windows 9x/Me àå ìúé÷ééä '%SYSTEMROOT%' òì + Windows NT/2000/XP åùðä àú ùí ä÷åáõ ì- &php.ini;. äúé÷ééä + '%WINDOWS%' or '%SYSTEMROOT%' ùìê äéà + áãøê ëìì: <simplelist> - <member><filename>c:\windows</filename> for Windows 9x/ME/XP</member> - <member><filename>c:\winnt</filename> or <filename>c:\winnt40</filename> for NT/2000 servers</member> + <member><filename>c:\windows</filename> ìâáé Windows 9x/ME/XP</member> + <member><filename>c:\winnt</filename> àå <filename>c:\winnt40</filename> ìâáé ùøúé NT/2000</member> </simplelist> </para> <para> - There are two ini files distributed in the zip file, - <filename>php.ini-dist</filename> and - <filename>php.ini-optimized</filename>. We advise - you to use <filename>php.ini-optimized</filename>, - because we optimized the default settings in this - file for performance, and security. The best is to - study all the <link linkend="configuration.file">ini - settings</link> and set every element manually yourself. - If you would like to achieve the best security, then this - is the way for you, although PHP works fine with these - default ini files. + éùðí ùðé ÷áöé ini îåôöéí á÷åáõ Zip, + <filename>php.ini-dist</filename> å- + <filename>php.ini-optimized</filename>. àðçðå îîìéöéí + ìê ìäùúîù á- <filename>php.ini-optimized</filename>, + îùåí ùàðçðå ééòìðå àú ääâãøåú á÷åáõ æä ìáéöåòéí, + åìàáèçä. äùéèä äëé èåáä ììîåã àú ëì <link linkend="configuration.file">äâãøåú + ini</link> äéà ìäâãéø ëì àìîðè éãðéú áòöîê. + àí àúä îòåðééï ìäùéâ àú äàáèçä äèåáä áéåúø, àæ æàú + äùéèä áùáéìê, ìîøåú ù- PHP éòáåã èåá òí ääâãøåú + ùì ä- ini äî÷åøééí. </para> </listitem> <listitem> <para> - Edit your new &php.ini; file: + òøåê àú ÷åáõ &php.ini; äçãù ùìê: <itemizedlist> <listitem> <simpara> - You will need to change the 'extension_dir' setting to - point to your php-install-dir, or where you have placed - your <filename>php_*.dll</filename> files. Please do not - forget the last backslash. ex: - <filename>c:\php\extensions\</filename> + àúä úöèøê ìùðåú àú äâãøú 'extension_dir' ùúöáéò + àì php-install-dir, àå ìàï ùàúä ùîú àú ä÷áöéí + <filename>php_*.dll</filename> ùìê. ùéí ìá ìà + ìùëåç àú äìåëñï äàçøåï, ìãåâîà: + <filename>c:\php\extensions\</filename> </simpara> </listitem> <listitem> <simpara> - If you are using OmniHTTPd, do not follow the next step. - Set the 'doc_root' to point to your webservers - document_root. For example: <filename>c:\apache\htdocs</filename> - or <filename>c:\webroot</filename> + àí àúä îùúîù á- OmniHTTPd, àì úáöò àú äùìá äáà. + äâãø àú 'doc_root' ùéöáéò ì- document_root ùì + ùøúé ä- Web ùìê. ìãåâîà, <filename>c:\apache\htdocs</filename> + àå <filename>c:\webroot</filename> </simpara> </listitem> <listitem> <simpara> - Choose which extensions you would like to load when PHP - starts. See the section about - <link linkend="install.windows.extensions">Windows - extensions</link>, about how to set up one, and what - is already built in. Note that on a new installation - it is advisable to first get PHP working and tested - without any extensions before enabling them in - &php.ini;. + áçø àéæä úåñôåú àúä øåöä ìèòåï îúé ù- PHP + îúçéì. øàä àú äçì÷ áðåùà <link linkend="install.windows.extensions">úåñôåú + Windows</link> äëåìì àéê ìäôòéì úåñôú, åàéæä + úåñôåú ëáø ðëììå. ùéí ìá ùáäú÷ðä çãùä, + îåîìõ ìäôòéì åìðñåú àú PHP áôòí äøàùåðä + áìé úåñôåú, ìôðé ùàúä îôòéì àåúí á- &php.ini;. </simpara> </listitem> <listitem> <simpara> - On PWS and IIS, you can set the <filename>browscap.ini</filename> - to point to: - <filename>c:\windows\system\inetsrv\browscap.ini</filename> on + òì PWS å- IIS, àúä éëåì ìäâãéø àú <filename>browscap.ini</filename> + ùéöáéò àì: + <filename>c:\windows\system\inetsrv\browscap.ini</filename> òì Windows 9x/Me, - <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> on - NT/2000, and + <filename>c:\winnt\system32\inetsrv\browscap.ini</filename> òì + NT/2000, å- <filename>c:\windows\system32\inetsrv\browscap.ini</filename> - on XP. + òì XP. </simpara> </listitem> <listitem> <simpara> - Note that the <filename>mibs</filename> directory supplied - with the Windows distribution contains support files for - SNMP. This directory should be moved to - <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> - being the drive where PHP is installed.) + ùéí ìá ùúé÷ééú<filename>mibs</filename> äîñåô÷ú + òí äôöú ä- Windows îëéìä ÷áöé úîéëä áùáéì + SNMP. äúé÷ééä äæàú öøéëä ìòáåø ì- + <filename>DRIVE:\usr\mibs</filename> (<filename>DRIVE</filename> + äåà äëåðï ùáå PHP îåú÷ï.) </simpara> </listitem> <listitem> <simpara> - If you're using NTFS on Windows NT, 2000 or XP, make sure that - the user running the webserver has read permissions to your - &php.ini; (e.g. make it readable by Everyone). + àí àúä îùúîù á- NTFS òì Windows NT, 2000 àå XP, ååãà ëé + ìîùúîù ùîøéõ àú ùøú ä- Web éù äøùàåú ÷øéàä ì- &php.ini; ùìê + (ìãåâîà, äâãø àåúå ì÷øéàä ò"é ëåìí). </simpara> </listitem> </itemizedlist> @@ -310,21 +296,21 @@ </listitem> <listitem> <para> - For PWS give execution permission to the webroot: + áùáéì PWS äâãø äøùàú áéöåò (execution) ì- webroot: <itemizedlist> <listitem> <simpara> - Start PWS Web Manager + äúçì àú PWS Web Manager </simpara> </listitem> <listitem> <simpara> - Edit Properties of the "Home"-Directory + òøåê îàôééðéí ùì úé÷ééú "Home" </simpara> </listitem> <listitem> <simpara> - Select the "execute"-Checkbox + áçø àú àôùøåú ä- "execute" </simpara> </listitem> </itemizedlist> @@ -337,10 +323,10 @@ </sect2> <sect2 id="install.windows.build"> - <title>Building from source</title> + <title>áðééä îî÷åø</title> <para> - Before getting started, it is worthwhile answering the question: - "Why is building on Windows so hard?" Two reasons come to mind: + ìôðé ùîúçéìéí, æä îùúìí ìòðåú òì äùàìä: ìîä äáðééä òì Windows + äéà ëì ëê ÷ùä?" ùúé ñéáåú áàåú ìîçùáä: </para> <orderedlist> <listitem><simpara> @@ -353,27 +339,26 @@ this heritage shows through from time to time. </simpara></listitem> <listitem><simpara> - Pretty much all of the instructions that follow are of the - "set and forget" variety. So sit back and try follow the - instructions below as faithfully as you can. + áîéãä âãåìä ëé ääåøàåú ùìäìï äí îñåâ "äâãø åùëç". + àæ úúøååç åðñä ìò÷åá àçøé ääåøàåú äáàåú áðàîðåú + ëëì ùàúä éëåì. </simpara></listitem> </orderedlist> <sect3 id="install.windows.build.prepare"> - <title>Preparations</title> + <title>äëðåú</title> <para> - Before you get started, you have a lot to download... + ìôðé ùàúä îúçéì, éù ìê äøáä ìäåøéã... </para> <itemizedlist> <listitem><simpara> - For starters, get the Cygwin toolkit from the closest <ulink - url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink> - mirror site. This will provide you most of the popular GNU - utilities used by the build process. + áùáéì ääúçìä, äùâ àú Cygwin toolkit îùøú äøàé ä÷øåá + ùì <ulink url="http://sources.redhat.com/cygwin/download.html">cygwin</ulink>. + æä éñô÷ ìê àú øåá úåëðåú äòæø ùúöèøê áúäìéê äáðééä. </simpara></listitem> <listitem><simpara> - Download the rest of the build tools you will need from the PHP - site at <ulink url="http://www.php.net/extra/win32build.zip" + äåøã àú ùàø ëìé äáðééä ùàúä öøéê îàúø PHP áëúåáú + <ulink url="http://www.php.net/extra/win32build.zip" >http://www.php.net/extra/win32build.zip</ulink>. </simpara></listitem> <listitem><simpara>