Envía una string al servidor PostgreSQL

# 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

function 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

- pg_end_copy() - Sincroniza con el servidor PostgreSQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open