array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.pg-put-line.php', 1 => 'pg_put_line', 2 => 'Envía una string al servidor PostgreSQL', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Funciones de PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-prepare.php', 1 => 'pg_prepare', ), 'next' => array ( 0 => 'function.pg-query.php', 1 => 'pg_query', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/pgsql/functions/pg-put-line.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pg_put_line

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

pg_put_line — Envía una string al servidor PostgreSQL

Descripción

pg_put_line(PgSql\Connection $connection = ?, string $query): bool

pg_put_line() envía una string (terminada por null) al servidor PostgreSQL. Esto es necesario en conjunción con un comando COPY FROM de PostgreSQL.

COPY es una carga muy rápida de datos soportada por PostgreSQL. Los datos se pasan sin ser analizados y en una simple transacción.

Una alternativa en lugar de usar el comando bruto pg_put_line() es usar pg_copy_from(). Es una interfaz mucho más simple.

Nota:

Tenga en cuenta que la aplicación debe agregar explícitamente los dos caracteres "\." al final de la string para indicar al servidor que ha terminado de enviar datos, antes de llamar a pg_end_copy().

Advertencia

El uso de pg_put_line() hace que fallen la mayoría de los objetos de gran tamaño, incluyendo pg_lo_read() y pg_lo_tell(). Puede usar pg_copy_from() y pg_copy_to() en su lugar.

Parámetros

connection

Una instancia PgSql\Connection. Cuando connection no es especificado, se usa la conexión por defecto. La conexión por defecto es la última conexión hecha por pg_connect() o pg_pconnect()

Advertencia

Desde PHP 8.1.0, usar la conexión por defecto está obsoleto.

query

Una línea de texto para enviar directamente al servidor PostgreSQL. Un carácter de finalización null se agrega automáticamente.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.1.0 El parámetro connection ahora espera una instancia de PgSql\Connection ; anteriormente, se esperaba un resource.

Ejemplos

Ejemplo #1 Ejemplo con pg_put_line()

<?php
$conn = pg_pconnect("dbname=foo");
pg_query($conn, "create table bar (a int4, b char(16), d float8)");
pg_query($conn, "copy bar from stdin");
pg_put_line($conn, "3\tBonjour le monde\t4.5\n");
pg_put_line($conn, "4\tAurevoir le monde\t7.11\n");
pg_put_line($conn, "\\.\n");
pg_end_copy($conn);
?>

Ver también