archived-doc-es/reference/pdo_dblib/reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->

<reference xml:id="ref.pdo-dblib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <?phpdoc extension-membership="bundledexternal" ?>
 <title>Microsoft SQL Server y Funciones del Controlador PDO Sybase (PDO_DBLIB)</title>
 <titleabbrev>Controlador PDO MS SQL Server</titleabbrev>
 <partintro>

  <section xml:id="ref.pdo-dblib.intro">
   &reftitle.intro;
   <para>
    PDO_DBLIB es un controlador que implementa la <link
    linkend="intro.pdo">interfaz de PHP Data Objects (PDO)</link> para
    permitir el acceso de PHP a Microsoft SQL Server y bases de datos Sybase
    mediante la biblioteca FreeTDS.
   </para>
   <para>
    Esta extensión ya no está disponible en Windows.
   </para>
   <para>
    En Windows, se debe utilizar SqlSrv, un controlador alternativo para MS SQL
    disponible en Microsoft : <link xlink:href="&url.sqlsrv;">&url.sqlsrv;
    </link>.
   </para>
   <para>
    Si no es posible utilizar SqlSrv, puede emplearse el controlador
    <link linkend="ref.pdo-odbc">PDO_ODBC</link> para conectarse a un servidor
    de bases de datos Microsoft SQL y Sybase, teniendo en cuenta que el controlador
    nativo de Windows DB-LIB es antiguo, no seguro a nivel de hilos y ya no es
    soportado por Microsoft.
   </para>
  </section>
 </partintro>

 <refentry xml:id="ref.pdo-dblib.connection">
  <refnamediv>
   <refname>PDO_DBLIB DSN</refname>
   <refpurpose>Conexión al Servidor Microsoft SQL y bases de datos Sybase</refpurpose>
  </refnamediv>

  <refsect1 role="description">
   &reftitle.description;
   <para>
    El Data Source Name (DSN) de PDO_DBLIB se compone de los siguientes elementos:
    <variablelist>
     <varlistentry>
      <term>Prefijo DSN</term>
      <listitem>
       <para>
        El prefijo DSN es <userinput>sybase:</userinput> si PDO_DBLIB fue vinculado
        con las bibliotecas Sybase ct-lib, <userinput>mssql:</userinput> si
        PDO_DBLIB fue vinculado con las bibliotecas de Microsoft SQL Server,
        o <userinput>dblib:</userinput> si PDO_DBLIB fue vinculado con las
        bibliotecas FreeTDS.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>host</literal></term>
      <listitem>
       <para>
        El host donde se encuentra el servidor de base de datos.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>dbname</literal></term>
      <listitem>
       <para>
        El nombre de la base de datos.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>charset</literal></term>
      <listitem>
       <para>
        El juego de caracteres del cliente.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>appname</literal></term>
      <listitem>
       <para>
        El nombre de la aplicación (utilizado en <literal>sysprocesses</literal>).
        Por omisión, <literal>"PHP Generic DB-lib"</literal> o
        <literal>"PHP freetds"</literal>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>secure</literal></term>
      <listitem>
       <para>
        Actualmente no utilizado.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
     <title>Ejemplos con PDO_DBLIB DSN</title>
     <para>
      Los ejemplos siguientes muestran PDO_DBLIB DSN para conectarse a
      Microsoft SQL Server y bases de datos Sybase:
      <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:"~/.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
-->