php-doc-en/reference/pdo_dblib/reference.xml
Wez Furlong 3e7cfd8e07 Juggle and update
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@195767 c90b9560-bf6c-de11-be94-00142212c4b1
2005-09-11 06:17:09 +00:00

110 lines
3.1 KiB
XML

<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.5 $ -->
<!-- Purpose: database.vendors -->
<!-- Membership: bundled, external, pecl -->
<reference id="ref.pdo-dblib">
<title>Microsoft SQL Server and Sybase Functions (PDO_DBLIB)</title>
<titleabbrev>MS SQL Server (PDO)</titleabbrev>
<partintro>
<section id="pdo-dblib.intro">
&reftitle.intro;
<para>
&warn.experimental;
PDO_DBLIB is a driver that implements the <link linkend="ref.pdo">PHP
Data Objects (PDO) interface</link> to enable access from PHP to
Microsoft SQL Server and Sybase databases through the FreeTDS libary.
</para>
<para>
On Windows, you should use the <link linkend="ref.pdo-odbc">PDO_ODBC</link>
driver to connect to Microsoft SQL Server and Sybase databases, as the
native Windows DB-LIB is ancient, thread un-safe and no longer supported
by Microsoft.
</para>
</section>
</partintro>
<refentry id="ref.pdo-dblib.connection">
<refnamediv>
<refname>PDO_DBLIB DSN</refname>
<refpurpose>Connecting to Microsoft SQL Server and Sybase databases</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>
The PDO_DBLIB Data Source Name (DSN) is composed of the following elements:
<variablelist>
<varlistentry>
<term>DSN prefix</term>
<listitem>
<para>
The DSN prefix is <userinput>sybase:</userinput> if PDO_DBLIB was
linked against the FreeTDS libraries, <userinput>mssql:</userinput>
if PDO_DBLIB was linked against the Microsoft SQL Server libraries,
or <userinput>dblib:</userinput> if linked against any other variety
of DB-lib.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>host</constant></term>
<listitem>
<para>
The hostname on which the database server resides.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>dbname</constant></term>
<listitem>
<para>
The name of the database.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>PDO_DBLIB DSN examples</title>
<para>
The following examples show a PDO_DBLIB DSN for connecting to
Microsoft SQL Server and Sybase databases:
<programlisting><![CDATA[
mssql:host=localhost;dbname=testdb
sybase:host=localhost;dbname=testdb
dblib:host=localhost;dbname=testdb
]]>
</programlisting>
</para>
</example>
</para>
</refsect1>
</refentry>
</reference>
<!-- 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:"../../../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
-->