<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<chapter xml:id="faq.obtaining" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Obtaining PHP</title>
  <titleabbrev>Obtaining PHP</titleabbrev>

   <para>
    This section has details about PHP download locations, and
    OS issues.
   </para>

  <qandaset>
   <qandaentry xml:id="faq.obtaining.where">
    <question>
     <para>Where can I obtain PHP?</para>
    </question>
    <answer>
     <para>
      You can download PHP from any of the members of the
      PHP network of sites. These can be found at 
      <link xlink:href="&url.php;">&url.php;</link>.
      You can also use anonymous Git to get the absolute latest
      version of the source. For more information, go to 
      <link xlink:href="&url.php.anongit;">&url.php.anongit;</link>.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.obtaining.precompiled">
    <question>
     <para>Are pre-compiled binary versions available?</para>
    </question>
    <answer>
     <para>
      We only distribute precompiled binaries for Windows systems,
      as we are not able to compile PHP for every major Linux/Unix
      platform with every extension combination. Also note, that
      many Linux distributions come with PHP built in these days.
      Windows binaries can be downloaded from our <link
      xlink:href="&url.php.downloads;">Downloads</link> page, for Linux
      binaries, please visit your distribution's website.
     </para>
    </answer>
   </qandaentry>

   <qandaentry xml:id="faq.obtaining.optional">
    <question>
     <para>
      Where can I get libraries needed to compile some of
      the optional PHP extensions?
     </para>
    </question>
    <answer>
     <para>
      <note>
       <simpara>
        Those marked with a * are to the best of our knowledge not thread safe; they are not recommended for use in a multi-threaded environment.
       </simpara>
      </note>
     </para>
     <para>
      <itemizedlist>
       <listitem>
        <simpara>
         <link xlink:href="&url.ldap.openldap.source;">LDAP (Unix)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.ldap.netscape.sdk;">LDAP (Unix/Win)</link> : 
         Mozilla Directory (LDAP) SDK
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.ldap.bind9;">free LDAP server</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.sleepycat;">Berkeley DB2 (Unix/Win)</link> :
         &url.sleepycat;.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.net-snmp;">SNMP* (Unix): </link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.gd;">GD (Unix/Win)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.msql;">mSQL* (Unix)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.pgsql;">PostgreSQL (Unix)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.imap;">IMAP* (Win/Unix)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.sybase;">Sybase-CT* (Linux, libc5)</link> : 
         Available locally.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.freetype;">FreeType (libttf):</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.zlib;">ZLib (Unix/Win32)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.expat;">expat XML parser (Unix/Win32)</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.pdf;">PDFLib</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.mcrypt;">mcrypt</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.mhash;">mhash</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.t1lib;">t1lib</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.dmalloc;">dmalloc</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.aspell;">aspell</link>.
        </simpara>
       </listitem>
       <listitem>
        <simpara>
         <link xlink:href="&url.readline;">readline</link>.
        </simpara>
       </listitem>
      </itemizedlist>
     </para>
    </answer>
   </qandaentry>
  
   <qandaentry xml:id="faq.obtaining.how">
    <question>
     <para>How do I get these libraries to work?</para>
    </question>
    <answer>
     <para>
      You will need to follow instructions provided with the library. Some of
      these libraries are detected automatically when you run the 'configure'
      script of PHP (such as the GD library), and others you will have to
      enable using '<literal>--with-EXTENSION</literal>' options to 
      '<literal>configure</literal>'. Run 
      '<literal>configure --help</literal>' for a listing of these.     
     </para>
    </answer>
   </qandaentry>
   <qandaentry xml:id="faq.obtaining.compilent">
    <question>
     <para>
      I got the latest version of the PHP source code from the Git
      repository on my Windows machine, what do I need to compile it?
     </para>
    </question>
    <answer>
     <para>
      See the PHP Wiki for the latest instructions: <link xlink:href="https://wiki.php.net/internals/windows/stepbystepbuild">Step by Step Build Instructions</link>
      
    </para>
    </answer>
   </qandaentry>
   <qandaentry xml:id="faq.obtaining.browscap">
    <question>
     <para>Where do I find the Browser Capabilities File?</para>
    </question>
    <answer>
     <para>
      You can find a <filename>browscap.ini</filename> file at 
      <link xlink:href="&url.browscap.download;">&url.browscap.download;</link>.
     </para>
    </answer>
   </qandaentry>
   <qandaentry xml:id="faq.obtaining.threadsafety">
    <question>
     <para>What does thread safety mean when downloading PHP?</para>
    </question>
    <answer>
     <para>
      Thread Safety means that binary can work in a multithreaded webserver 
      context, such as Apache 2 on Windows. Thread Safety works by creating 
      a local storage copy in each thread, so that the data won't collide 
      with another thread.
     </para>
     <para>
      So what do I choose? If you choose to run PHP as a CGI binary, then 
      you won't need thread safety, because the binary is invoked at each 
      request. For multithreaded webservers, such as IIS5 and IIS6, you should 
      use the threaded version of PHP.
     </para>
    </answer>
   </qandaentry>
  </qandaset>
 </chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
