<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<chapter xml:id="mssql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <!-- {{{ Requirements -->
 <section xml:id="mssql.requirements">
  &reftitle.required;
  <para>
   Requirements for Win32 platforms.
  </para>
  <para>
   The extension requires the MS SQL Client Tools to be installed
   on the system where PHP is installed. The Client Tools can
   be installed from the MS SQL Server CD or by copying
   <filename>ntwdblib.dll</filename> from 
   <filename>\winnt\system32</filename> on the server to
   <filename>\winnt\system32</filename> on the PHP box.
   Copying <filename>ntwdblib.dll</filename> will only provide access
   through named pipes.
   Configuration of the client will require installation of all the tools.
  </para>
  <para>
   This extension is not available anymore on Windows with PHP 5.3 or later.
  </para>
  <para>
   SqlSrv, an alternative driver for MS SQL is available from Microsoft: <link
   xlink:href="&url.sqlsrv;">&url.sqlsrv;</link>.
  </para>
  <para>
   Requirements for Unix/Linux platforms.
  </para>
  <para>
   To use the MSSQL extension on Unix/Linux, you first need to build and 
   install the FreeTDS library. Source code and installation instructions 
   are available at the FreeTDS home page: 
   <link xlink:href="&url.freetds;">&url.freetds;</link>
  </para>
  <note>
   <para>
    On Windows, the DBLIB from Microsoft is used. Functions that return a
    column name are based on the <literal>dbcolname()</literal> function 
    in DBLIB.  DBLIB was developed for SQL Server 6.x where the max
    identifier length is 30.  For this reason, the maximum column length 
    is 30 characters.  On platforms where FreeTDS is used (Linux), this is
    not a problem.
   </para>
  </note>
  <note>
   <para>
    On Windows, if you're using MSSQL 2005 or greater you must copy the 
    <literal>ntwdblib.dll</literal> into the directory where you have 
    installed php and overwrite the one thats already in there. This is 
    due to the version distributed is  old and outdated. Alternatively you 
    can use the <link xlink:href="&url.sqlsrv;">&url.sqlsrv;</link>, 
    <link linkend="book.uodbc">ODBC</link>, 
    <link linkend="ref.pdo-dblib">PDO_DBLIB</link> or 
    <link linkend="ref.pdo-odbc">PDO_ODBC</link> extensions, to talk to MSSQL.
   </para>
  </note>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 &reference.mssql.configure;
 <!-- }}} -->

 <!-- {{{ Configuration -->
 &reference.mssql.ini;
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="mssql.resources">
  &reftitle.resources;
  <section xml:id="mssql.resources.link">
   <title>mssql link</title>
   <para>
    A connection link returned by <function>mssql_connect</function> 
    and <function>mssql_pconnect</function>.
   </para>
  </section>
  <section xml:id="mssql.resources.result">
   <title>mssql result</title>
   <para>
    A result handle returned by <function>mssql_query</function> on 
    <literal>SELECT</literal> queries.
   </para>
  </section>
  <section xml:id="mssql.resources.statement">
   <title>mssql statement</title>
   <para>
    A statement handle returned by <function>mssql_init</function>.
   </para>
  </section>
 </section>
 <!-- }}} -->

</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
-->