php/archived-doc-es
1
0
Fork 0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00
Code Issues Packages Projects Releases Wiki Activity

sqlsrv: fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-26 15:29:12 +00:00
parent 40a6d08e42
commit bd7e5ad1ca
30 changed files with 277 additions and 281 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
reference/sqlsrv/book.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes Maintainer: PhilDaiguille -->
<book xml:id="book.sqlsrv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.sqlsrv">
<?phpdoc extension-membership="pecl" ?>
<title>Controlador Microsoft SQL Server para PHP</title>
<titleabbrev>SQLSRV</titleabbrev>
@@ -11,20 +10,20 @@
<!-- {{{ preface -->
<preface xml:id="intro.sqlsrv">
&reftitle.intro;
<para>
<simpara>
La extensión SQLSRV permite acceder a un servidor de base de datos
Microsoft SQL y SQL Azure. La versión 3.0 del controlador soporta SQL Server,
comenzando por SQL Server 2005, e incluyendo SQL Server 2012 y SQL
Server 2012 LocalDB (para más información acerca de LocalDB, ver
<link xlink:href="&url.sqlsrv.localdb;">el controlador PHP para el soporte de SQL Server para LocalDB</link>
y <link xlink:href="&url.sqlsrv.localdbinfo;">SQL Server 2012 Express LocalDB</link>.)
</para>
<para>
</simpara>
<simpara>
La extensión SQLSRV es soportada por Microsoft y está disponible para
descargar aquí : <link xlink:href="&url.sqlsrv;">&url.sqlsrv;</link>.
SQL Server 2012 LocalDB puede ser descargado aquí :
<link xlink:href="&url.sqlsrv.localdbdownload;">&url.sqlsrv.localdbdownload;</link>.
</para>
</simpara>
</preface>
<!-- }}} -->
@@ -33,7 +32,6 @@
&reference.sqlsrv.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

20
reference/sqlsrv/configure.xml
View File

@@ -1,27 +1,27 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 184f3f7bd45643cb80f828d0bb001991ec3a5fad Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<section xml:id="sqlsrv.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sqlsrv.installation">
&reftitle.install;
<para>
<simpara>
La extensión SQLSRV se activa añadiendo la biblioteca DLL correspondiente
en el directorio de extensiones de PHP y añadiendo la entrada correspondiente
en el archivo &php.ini;. La descarga de SQLSRV incluye
8 controladores, de los cuales 4 están dedicados al soporte de PDO.
</para>
<para>
</simpara>
<simpara>
La versión más reciente del controlador está disponible para su descarga aquí :
<link xlink:href="&url.sqlsrv;">descarga de SQLSRV</link>.
</para>
<para>
</simpara>
<simpara>
Para obtener más información sobre los requisitos previos de SQLSRV, consúltese el
capítulo sobre los
<link xlink:href="&url.sqlsrv.system.requirements;">requisitos del sistema SQLSRV</link>.
</para>
<para>
</simpara>
<simpara>
A partir de la versión 4.0, la extensión SQLSRV solo es compatible cuando PHP 7.0 funciona en Linux o Windows.
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:

18
reference/sqlsrv/functions/sqlsrv-begin-transaction.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-begin-transaction">
<refnamediv>
@@ -13,7 +13,7 @@
<type>bool</type><methodname>sqlsrv_begin_transaction</methodname>
<methodparam><type>resource</type><parameter>conn</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La transacción iniciada por <function>sqlsrv_begin_transaction</function> incluye
todas las sentencias que fueron ejecutadas después de la llamada a
<function>sqlsrv_begin_transaction</function> y antes de llamar a
@@ -22,7 +22,7 @@
estas funciones en vez de ejecutar sentencias SQL que empiecen y consoliden/reviertan
transacciones. Para más información, ver
<link xlink:href="&url.sqlsrv.transaction.handling;">SQLSRV Transactions</link>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -30,9 +30,9 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
El recurso de la conexión devuelta por una llamada a <function>sqlsrv_connect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -40,20 +40,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>sqlsrv_begin_transaction</function></title>
<para>
<simpara>
El siguiente ejemplo demuestra cómo utilizar
<function>sqlsrv_begin_transaction</function> junto con
<function>sqlsrv_commit</function> y <function>sqlsrv_rollback</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

18
reference/sqlsrv/functions/sqlsrv-cancel.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-cancel">
<refnamediv>
@@ -13,14 +13,14 @@
<type>bool</type><methodname>sqlsrv_cancel</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Cancela una sentencia de base de datos. Cualquier resultado asociado con la sentencia que no haya sido
utilizado será eliminado. Después de llamar a <function>sqlsrv_cancel</function>
, la sentencia especificada puede ser reejecutada si fue creada con
<function>sqlsrv_prepare</function>. No es necesario llamar a
<function>sqlsrv_cancel</function> si todos los resultados asociados se han
utilizado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,9 +29,9 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
El recurso de la sentencia que se va a cancelar.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -39,9 +39,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -93,13 +93,13 @@ sqlsrv_cancel( $stmt);
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
La principal diferencia entre <function>sqlsrv_cancel</function> y
<function>sqlsrv_free_stmt</function> es que una sentencia cancelada con
<function>sqlsrv_cancel</function> puede ser reejecutada si fue creada con
<function>sqlsrv_prepare</function>. Una sentencia cancelada con
<function>sqlsrv_free_statement</function> no puede ser reejecutada.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

10
reference/sqlsrv/functions/sqlsrv-client-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-client-info">
<refnamediv>
@@ -13,9 +13,9 @@
<type>array</type><methodname>sqlsrv_client_info</methodname>
<methodparam><type>resource</type><parameter>conn</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve información sobre el cliente y la conexión especificada
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,9 +24,9 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
La conexión sobre la que se va a retornar información.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

14
reference/sqlsrv/functions/sqlsrv-close.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-close">
<refnamediv>
@@ -13,9 +13,9 @@
<type>bool</type><methodname>sqlsrv_close</methodname>
<methodparam><type>resource</type><parameter>conn</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Cierra una conexión abierta y libera los recursos asociados a la conexión.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,9 +24,9 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
La conexión que se va a cerrar.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -34,9 +34,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/sqlsrv/functions/sqlsrv-commit.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-commit">
<refnamediv>
@@ -13,7 +13,7 @@
<type>bool</type><methodname>sqlsrv_commit</methodname>
<methodparam><type>resource</type><parameter>conn</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Consolida una transacción que se inició con <function>sqlsrv_begin_transaction</function>.
La conexión retorna al modo auto-commit después de que se llame a <function>sqlsrv_commit</function>.
La transacción que se consolida incluye todas las sentencias que fueron
@@ -22,7 +22,7 @@
funciones en vez de ejecutar las sentencias SQL que empiezan y consolidan/revierten
transacciones. Para más información, ver
<link xlink:href="&url.sqlsrv.transaction.handling;">SQLSRV Transactions</link>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,9 +31,9 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
La conexión en la que se va a consolidar la transacción.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -41,20 +41,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo de <function>sqlsrv_commit</function></title>
<para>
<simpara>
El siguiente ejemplo demuestra cómo utilizar <function>sqlsrv_commit</function>
junto con <function>sqlsrv_begin_transaction</function> y
<function>sqlsrv_rollback</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

14
reference/sqlsrv/functions/sqlsrv-configure.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-configure">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>setting</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Cambia la configuración de los drivers del gestionador de errores y de log.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,10 +25,10 @@
<varlistentry>
<term><parameter>setting</parameter></term>
<listitem>
<para>
<simpara>
El nombre de la propiedad a configurar. Los valores posibles son
"WarningsReturnAsErrors", "LogSubsystems", and "LogSeverity".
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -77,9 +77,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

26
reference/sqlsrv/functions/sqlsrv-connect.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-connect">
<refnamediv>
@@ -14,11 +14,11 @@
<methodparam><type>string</type><parameter>serverName</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>connectionInfo</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Establece una conexión con una base de datos Microsoft SQL Server. Por omisión,
la conexión intenta utilizar la autenticación Windows. Para conectarse
utilizando la autenticación SQL Server, se deben añadir los argumentos "UID" y "PWD" en el array de opciones de conexión.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,24 +27,24 @@
<varlistentry>
<term><parameter>serverName</parameter></term>
<listitem>
<para>
<simpara>
El nombre del servidor con el que se desea establecer la conexión.
Para conectarse a una instancia particular, se debe especificar el nombre
del servidor, seguido de un backslash, y luego el nombre de la instancia
(i.e. serverName\sqlexpress).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>connectionInfo</parameter></term>
<listitem>
<para>
<simpara>
Un array asociativo que especifica las opciones para la conexión al servidor.
Si los valores de las claves UID y PWD no están especificados, la conexión
intentará utilizar la autenticación Windows. Para una lista completa
de las claves soportadas, consulte las
<link xlink:href="&url.sqlsrv.connection.options;">opciones de conexión SQLSRV</link>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,9 +52,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Un recurso de conexión. Si la conexión no pudo ser abierta, se retornará &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -123,21 +123,21 @@ if( $conn ) {
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
Por omisión, la función <function>sqlsrv_connect</function> utiliza la cola de conexiones
para aumentar el rendimiento. Para desactivar esta cola de conexiones
(i.e. y así, forzar una nueva conexión en cada llamada a la función), se debe definir
la opción "ConnectionPooling" en el array $connectionOptions a 0 (o &false;).
Para más información, consulte el capítulo sobre la
<link xlink:href="&url.sqlsrv.connection.pooling;">cola de conexiones SQLSRV</link>.
</para>
<para>
</simpara>
<simpara>
La extensión SQLSRV no tiene una función dedicada para modificar la base de datos
a la que está conectada. La base de datos objetivo se especifica
en el array $connectionOptions pasado a la función sqlsrv_connect.
Para cambiar la base de datos en una conexión abierta, se debe ejecutar la siguiente consulta:
"USE dbName" (i.e. sqlsrv_query($conn, "USE dbName")).
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

14
reference/sqlsrv/functions/sqlsrv-errors.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-errors">
<refnamediv>
@@ -14,9 +14,9 @@
<type>mixed</type><methodname>sqlsrv_errors</methodname>
<methodparam choice="opt"><type>int</type><parameter>errorsOrWarnings</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve información de errores y alertas de la última operación SQLSRV realizada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,12 +25,12 @@
<varlistentry>
<term><parameter>errorsOrWarnings</parameter></term>
<listitem>
<para>
<simpara>
Determina si se ha de retornar información de error, alertas, o
ambas. Si este parámetro no se informa, se devolverá tanto información de error como
de alerta. Este parámetro puede tomar los
siguientes valores: SQLSRV_ERR_ALL, SQLSRV_ERR_ERRORS, SQLSRV_ERR_WARNINGS.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -115,14 +115,14 @@ if( $stmt === false ) {
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
Por defecto, las alertas generadas en una llamada a cualquier función SQLSRV se tratarán
como errores. Esto significa que si una alerta ocurre en una llamada a una función SQLSRV,
la función devolverá &false;. Sin embargo, las alertas correspondientes a los valores de
SQLSTATE 01000, 01001, 01003, y 01S02 nunca se tratarán como errores. Para
obtener información sobre cómo cambiar este comportamiento, ver <function>sqlsrv_configure</function>
y la configuración de WarningsReturnAsErrors.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

22
reference/sqlsrv/functions/sqlsrv-execute.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-execute">
<refnamediv>
@@ -13,11 +13,11 @@
<type>bool</type><methodname>sqlsrv_execute</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Ejecuta una sentencia preparada con <function>sqlsrv_prepare</function>. Esta
función es ideal para ser ejecutar múltiples veces una sentencia preparada
con diferentes valores de parámetros.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,9 +26,9 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de sentencia devuelto por <function>sqlsrv_prepare</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -36,20 +36,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>ejemplo de <function>sqlsrv_execute</function></title>
<para>
<simpara>
Este ejemplo muestra como preparar una sentencia con
<function>sqlsrv_prepare</function> y reejecutarla múltiples veces (con
diferentes valores de parámetros) utilizando <function>sqlsrv_execute</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -92,13 +92,13 @@ foreach( $orders as $id => $qty) {
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
Cuando se prepara una sentencia que utiliza variables como parámetros, las variables
se pasan como parámetros a la sentencia. Esto significa que si se actualizan los valores de las
variables, la próxima vez que se ejecute la sentencia lo hará con los nuevos valores
de los parámetros. Para las sentencias que se quieran ejecutar únicamente una vez, utilizar
<function>sqlsrv_query</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

42
reference/sqlsrv/functions/sqlsrv-fetch-array.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-fetch-array">
<refnamediv>
@@ -16,10 +16,10 @@
<methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve la siguiente fila de datos disponible como un array asociativo, un array
numérico, o ambos (por defecto).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,48 +28,48 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de sentencia devuelta por sqlsrv_query o sqlsrv_prepare.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>fetchType</parameter></term>
<listitem>
<para>
<simpara>
Una constante predefinida con el tipo de array a devolver. Los valores
posibles son <constant>SQLSRV_FETCH_ASSOC</constant>,
<constant>SQLSRV_FETCH_NUMERIC</constant>, y
<constant>SQLSRV_FETCH_BOTH</constant> (por defecto).
</para>
<para>
</simpara>
<simpara>
El tipo de objeto devuelto SQLSRV_FETCH_ASSOC no debe utilizarse cuando se trate un
conjunto de resultados con múltiples columnas con el mismo nombre.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row</parameter></term>
<listitem>
<para>
<simpara>
Especifica la fila para acceder a un conjunto de resultados que utiliza un cursor con scroll.
Los valores posibles son <constant>SQLSRV_SCROLL_NEXT</constant>,
<constant>SQLSRV_SCROLL_PRIOR</constant>, <constant>SQLSRV_SCROLL_FIRST</constant>,
<constant>SQLSRV_SCROLL_LAST</constant>, <constant>SQLSRV_SCROLL_ABSOLUTE</constant> y,
<constant>SQLSRV_SCROLL_RELATIVE</constant> (por defecto). Cuando se especifica
este parámetro, el parámetro <parameter>fetchType</parameter> debe ser definido explícitamente.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
<simpara>
Especifica la fila a la que se desea acceder si el parámetro de fila se define como
<constant>SQLSRV_SCROLL_ABSOLUTE</constant> o
<constant>SQLSRV_SCROLL_RELATIVE</constant>. Notar que la primera fila
en un conjunto de resultado tiene el índice 0.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -77,10 +77,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array en caso de éxito, &null; si no hay más filas a devolver, y
&false; si se produce un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -143,19 +143,19 @@ sqlsrv_free_stmt( $stmt);
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
Cuando no se especifica el parámetro <parameter>fetchType</parameter> o se utiliza explícitamente la constante
<constant>SQLSRV_FETCH_TYPE</constant> en los ejemplos anteriores, se
devolverá un array que tiene tanto claves asociativas como claves nuéricas.
</para>
<para>
</simpara>
<simpara>
Si se devuelve más de una columna con el mismo nombre, la última columna
tendrá prioridad para tomar el nombre. Para evitar colisiones de nombre de campo, utilizar alias.
</para>
<para>
</simpara>
<simpara>
Si se devuelve una columna sin nombre, la clave asociativa para ese elemento del array
será un string vacío ("").
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

34
reference/sqlsrv/functions/sqlsrv-fetch-object.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: regiemix Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: regiemix Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-fetch-object">
<refnamediv>
@@ -17,11 +17,11 @@
<methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve la siguiente fila de datos de un conjunto resultado como una instancia de la clase
especificada, donde las propiedades correspondientes a los nombres de los campos de la fila recuperada y los valores, se corresponden con
los valores de la fila recuperada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,29 +30,29 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de consulta creado por <function>sqlsrv_query</function> o
<function>sqlsrv_execute</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>className</parameter></term>
<listitem>
<para>
<simpara>
El nombre de la clase a instanciar. Si no se especifica el nombre de la clase,
se instanciará la clase stdClass.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>ctorParams</parameter></term>
<listitem>
<para>
<simpara>
Los valores pasados al constructor de la clase especificada. Si el constructor
de la clase especificada tiene parámetros, se proporcionará el array
ctorParams.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -76,12 +76,12 @@
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
<simpara>
Especifica la fila a la que se accederá si el parámetro de fila se ha especificado como
<constant>SQLSRV_SCROLL_ABSOLUTE</constant> o
<constant>SQLSRV_SCROLL_RELATIVE</constant>. Notar que la primera fila en un
conjunto de resultado tiene el índice 0.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -89,19 +89,19 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un objeto en caso de éxito, &null; si no hay más filas a devolver,
y &false; si se produce un error o si la clase especificada no existe.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>sqlsrv_fetch_object</function></title>
<para>
<simpara>
El siguiente ejemplo demuestra cómo devolver una columna como un objeto stdClass.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -149,11 +149,11 @@ while( $obj = sqlsrv_fetch_object( $stmt)) {
nombre, el valor de campo será ignorado y se añadirá una alerta
a la colección de errores.
</para>
<para>
<simpara>
Cuando se trate un conjunto de resultado que tenga varias columnas con el mismo nombre, podría
ser mejor utilizar <function>sqlsrv_fetch_array</function> o la combinación de
<function>sqlsrv_fetch</function> y <function>sqlsrv_get_field</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

22
reference/sqlsrv/functions/sqlsrv-fetch.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-fetch">
<refnamediv>
@@ -16,10 +16,10 @@
<methodparam choice="opt"><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Hace que esté disponible para ser leída la siguiente fila del conjunto de resultado. Utilizar
<function>sqlsrv_get_field</function> para leer los campos de la fila.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,10 +28,10 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de consulta creado por la ejecución de <function>sqlsrv_query</function>
o <function>sqlsrv_execute</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -55,12 +55,12 @@
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
<simpara>
Especifica la fila que será accedida si el parámetro de fila se configura como
<constant>SQLSRV_SCROLL_ABSOLUTE</constant> o
<constant>SQLSRV_SCROLL_RELATIVE</constant>. Notar que la primera fila en el
conjunto resultado tiene el índice 0.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -68,21 +68,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si la fila siguiente del conjunto de resultado se obtuvo satisfactoriamente,
&false; si se produce un error, y &null; si no hay más filas en el conjunto de resultado.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>sqlsrv_fetch</function></title>
<para>
<simpara>
El ejemplo siguiente demuestra como obtener una fila con
<function>sqlsrv_fetch</function> y los campos de la fila con
<function>sqlsrv_get_field</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

10
reference/sqlsrv/functions/sqlsrv-field-metadata.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-field-metadata">
<refnamediv>
@@ -15,12 +15,12 @@
<type>mixed</type><methodname>sqlsrv_field_metadata</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Recupera los datos meta para los campos de una consulta preparada por la función
<function>sqlsrv_prepare</function> o la función <function>sqlsrv_query</function>.
La función <function>sqlsrv_field_metadata</function> puede ser llamada sobre una
consulta antes o después de su ejecución.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,10 +29,10 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de consulta desde el cual los datos meta serán
recuperados.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

18
reference/sqlsrv/functions/sqlsrv-free-stmt.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-free-stmt">
<refnamediv>
@@ -13,13 +13,13 @@
<type>bool</type><methodname>sqlsrv_free_stmt</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Libera todos los recursos para la consulta especificada. La consulta no podrá
ser utilizada después de pasar a la función <function>sqlsrv_free_stmt</function>.
Si la función <function>sqlsrv_free_stmt</function> es llamada mientras la
consulta está en ejecución, la ejecución de la consulta es interrumpida
y la consulta es cancelada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,11 +28,11 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
La consulta cuyos recursos serán liberados.
Tenga en cuenta que &null; es un valor de argumento válido. Este valor
permite que la función sea llamada varias veces en un script.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -79,14 +79,14 @@ sqlsrv_free_stmt( $stmt);
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
La principal diferencia entre la función <function>sqlsrv_free_stmt</function> y
la función <function>sqlsrv_cancel</function> es que un recurso de consulta
cancelado con la función <function>sqlsrv_cancel</function> puede ser re-ejecutado
si ha sido creado con la función <function>sqlsrv_prepare</function>.
Un recurso de consulta cancelado con la función
<function>sqlsrv_free_statement</function> no puede ser re-ejecutado.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

14
reference/sqlsrv/functions/sqlsrv-get-config.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-get-config">
<refnamediv>
@@ -13,9 +13,9 @@
<type>mixed</type><methodname>sqlsrv_get_config</methodname>
<methodparam><type>string</type><parameter>setting</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve el valor de la configuración especificada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,9 +24,9 @@
<varlistentry>
<term><parameter>setting</parameter></term>
<listitem>
<para>
<simpara>
El nombre de la configuración para la cual se devolverá el valor. Para una lista de las configuraciones, ver la función <function>sqlsrv_configure</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -34,9 +34,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el valor de la configuración solicitada. Si se proporciona una configuración no válida, se devolverá &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

26
reference/sqlsrv/functions/sqlsrv-get-field.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-get-field">
<refnamediv>
@@ -15,10 +15,10 @@
<methodparam><type>int</type><parameter>fieldIndex</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>getAsType</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Recupera los datos del campo desde la línea actualmente seleccionada.
Los campos deben ser leídos en orden. Sus índices comienzan en 0.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,33 +27,33 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de consulta devuelto por la función
<function>sqlsrv_query</function> o la función
<function>sqlsrv_execute</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>fieldIndex</parameter></term>
<listitem>
<para>
<simpara>
El índice del campo a recuperar. Los índices de los campos comienzan en 0.
Los campos deben ser leídos en orden, es decir, si se accede al campo
con índice 1, el campo con índice 0 ya no estará disponible.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>getAsType</parameter></term>
<listitem>
<para>
<simpara>
El tipo de datos PHP para los datos del campo devuelto. Si este argumento
no está definido, los datos del campo serán devueltos en forma de un tipo de datos PHP por omisión. Para más información sobre los
tipos de datos PHP por omisión, consulte la sección sobre
<link xlink:href="&url.sqlsrv.default.phptypes;">los tipos de datos PHP por omisión</link>
de la documentación Microsoft SQLSRV.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -61,21 +61,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve los datos desde el campo especificado en caso de éxito.
Devuelve &false; si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>sqlsrv_get_field</function> example</title>
<para>
<simpara>
El siguiente ejemplo muestra cómo recuperar una línea con la
función <function>sqlsrv_fetch</function> y recupera
los campos de la línea con la función <function>sqlsrv_get_field</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

14
reference/sqlsrv/functions/sqlsrv-has-rows.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-has-rows">
<refnamediv>
@@ -13,9 +13,9 @@
<type>bool</type><methodname>sqlsrv_has_rows</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Indica si la consulta especificada contiene filas.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,11 +24,11 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de consulta devuelto por la función
<function>sqlsrv_query</function> o la función
<function>sqlsrv_execute</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -36,10 +36,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si la consulta especificada contiene filas,
&false; si no contiene ninguna o si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/sqlsrv/functions/sqlsrv-next-result.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-next-result">
<refnamediv>
@@ -14,11 +14,11 @@
<!-- Example: Required parameter -->
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Activa el siguiente resultado de la consulta especificada. Los resultados
incluyen los conjuntos de resultados, el número de filas y los parámetros
de salida.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,9 +27,9 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
La consulta sobre la cual se llamará el siguiente resultado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -37,25 +37,25 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si el siguiente resultado ha sido recuperado con éxito,
&false; si ocurre un error, y &null; si no hay más
resultados para recuperar.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>sqlsrv_next_result</function></title>
<para>
<simpara>
El siguiente ejemplo ejecuta una consulta batch que realiza inserciones
en una tabla y luego realiza una selección de la tabla. Esto produce
2 resultados en la consulta: uno para las filas afectadas por el INSERT,
y otro para las filas devueltas por el SELECT. Para recuperar las filas
devueltas por el SELECT, la función <function>sqlsrv_next_result</function>
debe ser llamada para pasar el primer resultado.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

14
reference/sqlsrv/functions/sqlsrv-num-fields.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-num-fields">
<refnamediv>
@@ -13,9 +13,9 @@
<type>mixed</type><methodname>sqlsrv_num_fields</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Recupera el número de campos (columnas) en una consulta.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,12 +24,12 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
La consulta desde la cual se devuelve el número de campos.
La función <function>sqlsrv_num_fields</function> puede ser
llamada sobre una consulta antes o después de la ejecución de
la consulta.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -37,10 +37,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el número de campos en caso de éxito.
Devuelve &false; en caso contrario.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

14
reference/sqlsrv/functions/sqlsrv-num-rows.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-num-rows">
<refnamediv>
@@ -13,7 +13,7 @@
<type>mixed</type><methodname>sqlsrv_num_rows</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Recupera el número de filas de un conjunto de resultados. Esta función
requiere que el recurso de consulta haya sido creado con un cursor
estático o keyset. Para más información, consulte las funciones
@@ -21,7 +21,7 @@
o el capítulo
<link xlink:href="&url.sqlsrv.specify.cursortype;">Especificar un tipo de cursor y seleccionar filas</link>
en la documentación de Microsoft SQLSRV.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,7 +30,7 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
La consulta desde la cual se devuelve el número total de filas.
El recurso de consulta debe haber sido creado con un cursor estático
o keyset. Para más información, consulte las funciones
@@ -38,7 +38,7 @@
o el capítulo
<link xlink:href="&url.sqlsrv.specify.cursortype;">Especificar un tipo de cursor y seleccionar filas</link>
en la documentación de Microsoft SQLSRV.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -46,11 +46,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el número total de filas recuperadas en caso de éxito, y
&false; si ocurre un error. Si se utiliza un cursor anterior (por omisión),
o un cursor dinámico, se devolverá &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

30
reference/sqlsrv/functions/sqlsrv-prepare.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-prepare">
<refnamediv>
@@ -16,11 +16,11 @@
<methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Prepara una consulta para su ejecución. Esta función es ideal para
preparar una consulta que será ejecutada varias veces con diferentes
valores de argumentos.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -29,18 +29,18 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de conexión devuelto por la función
<function>sqlsrv_connect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>sql</parameter></term>
<listitem>
<para>
<simpara>
La cadena que define la consulta a preparar y ejecutar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -97,10 +97,10 @@
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Un array especificando las opciones de propiedades de la consulta.
Las claves soportadas se describen en la tabla siguiente:
</para>
</simpara>
<table>
<title>Opciones de la consulta</title>
<tgroup cols="3">
@@ -144,21 +144,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un recurso de consulta en caso de éxito, o &false; si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>sqlsrv_prepare</function></title>
<para>
<simpara>
Este ejemplo muestra cómo preparar una consulta con la función
<function>sqlsrv_prepare</function> y su re-ejecución varias veces
(con diferentes valores de argumentos) utilizando la función
<function>sqlsrv_execute</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -202,14 +202,14 @@ foreach( $orders as $id => $qty) {
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
Cuando se prepara una consulta que utiliza variables como argumentos,
las variables están ligadas a la consulta. Esto significa que si se actualizan
los valores de estas variables, la próxima ejecución de la consulta tomará
en cuenta estos nuevos valores. Para las consultas que se prevé ejecutar
solo una vez, utilice la función
<function>sqlsrv_query</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

26
reference/sqlsrv/functions/sqlsrv-query.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-query">
<refnamediv>
@@ -16,9 +16,9 @@
<methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Prepara y ejecuta una consulta.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,18 +27,18 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de conexión devuelto por la función
<function>sqlsrv_connect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>sql</parameter></term>
<listitem>
<para>
<simpara>
El string que define la consulta a preparar y ejecutar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -94,10 +94,10 @@
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
<simpara>
Un array especificando las opciones de la consulta. Las claves soportadas son
descritas en la tabla siguiente:
</para>
</simpara>
<table>
<title>Opciones de consulta</title>
<tgroup cols="3">
@@ -141,9 +141,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un recurso de consulta en caso de éxito, y &false; si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -175,13 +175,13 @@ if( $stmt === false ) {
<refsect1 role="notes">
&reftitle.notes;
<para>
<simpara>
Para las consultas que no se prevé ejecutar más de una vez,
utilice la función <function>sqlsrv_query</function>.
Si se desea re-ejecutar una consulta con diferentes valores para sus
parámetros, utilice la combinación de la función
<function>sqlsrv_prepare</function> y la función <function>sqlsrv_execute</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

18
reference/sqlsrv/functions/sqlsrv-rollback.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-rollback">
<refnamediv>
@@ -14,11 +14,11 @@
<type>bool</type><methodname>sqlsrv_rollback</methodname>
<methodparam><type>resource</type><parameter>conn</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Anula una transacción que ha sido iniciada gracias a la función
<function>sqlsrv_begin_transaction</function> y devuelve
la conexión en modo auto-validación.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,10 +27,10 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
El recurso de conexión devuelto por una llamada
a la función <function>sqlsrv_connect</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -38,20 +38,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>sqlsrv_rollback</function></title>
<para>
<simpara>
El siguiente ejemplo muestra la forma de utilizar la función
<function>sqlsrv_begin_transaction</function> con las funciones
<function>sqlsrv_commit</function> y <function>sqlsrv_rollback</function>.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

14
reference/sqlsrv/functions/sqlsrv-rows-affected.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-rows-affected">
<refnamediv>
@@ -14,12 +14,12 @@
<type class="union"><type>int</type><type>false</type></type><methodname>sqlsrv_rows_affected</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve el número de filas modificadas por la última consulta de tipo
INSERT, UPDATE, o DELETE. Para más información sobre el número
de filas devueltas por una consulta SELECT, consulte la función
<function>sqlsrv_num_rows</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,9 +28,9 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
El recurso de la consulta ejecutada.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -38,12 +38,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el número de filas afectadas por la última consulta
INSERT, UPDATE, o DELETE. Si ninguna fila es afectada, se devolverá 0.
Si el número de filas afectadas no puede ser determinado, se devolverá -1.
Si ocurre un error, se devolverá &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

14
reference/sqlsrv/functions/sqlsrv-send-stream-data.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-send-stream-data">
<refnamediv>
@@ -13,10 +13,10 @@
<type>bool</type><methodname>sqlsrv_send_stream_data</methodname>
<methodparam><type>resource</type><parameter>stmt</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Envía datos desde el flujo al servidor. Hasta 8 Ko
de datos son enviados en cada llamada.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,11 +25,11 @@
<varlistentry>
<term><parameter>stmt</parameter></term>
<listitem>
<para>
<simpara>
Un recurso de petición devuelto por la
función <function>sqlsrv_query</function> o
por la función <function>sqlsrv_execute</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -37,10 +37,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si aún hay datos por
enviar, y &false; si no hay más.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/sqlsrv/functions/sqlsrv-server-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.sqlsrv-server-info">
<refnamediv>
@@ -13,9 +13,9 @@
<type>array</type><methodname>sqlsrv_server_info</methodname>
<methodparam><type>resource</type><parameter>conn</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve información sobre el servidor.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -24,9 +24,9 @@
<varlistentry>
<term><parameter>conn</parameter></term>
<listitem>
<para>
<simpara>
El recurso de conexión que conecta el cliente y el servidor.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

6
reference/sqlsrv/ini.xml
View File

@@ -1,17 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2471b0dc9ba5f9aff8b1b73060515dd9ce41b634 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sqlsrv.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
<simpara>
La tabla siguiente lista las opciones de configuración disponibles
para la extensión. Para más información sobre estas opciones,
consúltese el capítulo sobre la
<link xlink:href="&url.sqlsrv.error.handling;">gestión de errores
y alertas SQLSRV</link>.
</para>
</simpara>
<table>
<title>&ConfigureOptions; SQLSRV</title>
<tgroup cols="4">

26
reference/sqlsrv/setup.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 184f3f7bd45643cb80f828d0bb001991ec3a5fad Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: c758e862cf7648f657acb9e073bcc657f368a701 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="sqlsrv.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sqlsrv.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
@@ -28,18 +27,18 @@
<member><link xlink:href="&url.sqlsrv.snac.x64download;">Descarga del paquete x64</link></member>
</simplelist>
</para>
<para>
<simpara>
La descarga SQLSRV viene con 8 controladores, de los cuales 4 están dedicados al soporte de PDO.
</para>
<para>
</simpara>
<simpara>
La versión más reciente del controlador está disponible para descargar aquí:
<link xlink:href="&url.sqlsrv;">descarga de SQLSRV</link>.
</para>
<para>
</simpara>
<simpara>
Para más información sobre los requisitos previos de SQLSRV, consulte el
capítulo sobre los
<link xlink:href="&url.sqlsrv.system.requirements;">requisitos del sistema SQLSRV</link>.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -56,24 +55,23 @@
&reftitle.resources;
<section xml:id="sqlsrv.resources.link">
<title>Recurso de conexión</title>
<para>
<simpara>
Un recurso de conexión devuelto por la función
<function>sqlsrv_connect</function>.
</para>
</simpara>
</section>
<section xml:id="sqlsrv.resources.statement">
<title>Recurso de consulta</title>
<para>
<simpara>
Un recurso de consulta devuelto por la función
<function>sqlsrv_query</function> o la función
<function>sqlsrv_prepare</function>.
</para>
</simpara>
</section>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml