Podręcznik PHP
Poprzedni |  | Następny

# pg_connect

(PHP 3, PHP 4, PHP 5)

pg_connect -- Otwiera tymczasowe połączenie do PostgreSQL-a

## Opis

resource pg_connect ( string łąńcuch_połączenia [, int typ_połączenia] )

pg_connect() Otwiera tymczasowe połączenie do serwera PostgreSQL określonego przez `łąńcuch_połączenia`.

Jeśli funkcja pg_connect() zostanie wywołana drugi raz z tym samym `łąńcuchem_połączenia` jak istniejące połączenie, zostanie zwrócony identyfikator istniejącego połączenia chyba, że podasz `PGSQL_CONNECT_FORCE_NEW` jako `typ_połączenia`.

Stara składnia z wieloma parametrami $conn = pg_connect("host", "port", "opcje", "tty", "nazwa_bazy") jest przestarzała.

## Parametry

`łąńcuch_połączenia`

  `łąńcuch_połączenia` może być pusty, użyte zostaą wszystkie domyślne parametry lub może zawierać jeden lub więcej parametrów ustawień oddzielonych przez biały znak. Każdy parametr ustawień jest w postaci `słowo_kluczowe = wartość`. Odstępy wokół znaku równości są opcjonalne. Aby zapisać pustą wartość lub wartość zawierającą spacje, należy otoczyć ją przez pojedynczy cudzysłów, np. `słowo_kluczowe = 'ta wartość'`. Pojedyncze cudzysłowy i lewe ukośniki w wartości musza być poprzedzone znakiem unikowym (lewym ukośnikiem) tj. \' i \\

  Obecnie rozpoznwane parametry słów kluczowych to: `host`, `hostaddr`, `port`, `dbname`, `user`, `password`, `connect_timeout`, `options`, `tty` (ignorowany), `sslmode`, `requiressl` (przestarzały na rzecz `sslmode`) i `service`. Które z tych parametrów istnieją zależy od Twojej wersji PostgreSQL.

`typ_połączenia`

  Jeśli jest podany `PGSQL_CONNECT_FORCE_NEW`, wtedy nowe połączenie jest tworzone, nawet jeśli `łąńcuch_połączenia` jest identyczny z istniejącym połączeniem.

## Zwracane wartości

Zasób, połączenie do bazy PostgreSQL w przypadku powodzenia, lub `FALSE` gdy zawiedzie.

## Przykłady

Przykład 1. Używanie pg_connect

`<?php
$dbconn = pg_connect ("dbname=mary");
//Otwiera połączenie z bazą "mary"
$dbconn2 = pg_connect ("host=localhost port=5432 dbname=mary");
//Otwiera połączenie z bazą "mary" na komputerze "localhost" przez port "5432"
$dbconn3 = pg_connect ("host=sheep port=5432 dbname=mary user=lamb password=foo");
//Otwiera połączenie z bazą "mary" na komputerze "sheep" z użyciem nazwy użytkownika i hasła
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_connect ($conn_string);
//Otwiera połączenie z bazą "test" na komputerze "sheep" z użyciem nazwy użytkownika i hasła
?>`

## Patrz także

pg_pconnect()
pg_close()
pg_host()
pg_port()
pg_tty()
pg_options()
pg_dbname()

Poprzedni | Spis treści | Następny
pg_close | Początek rozdziału | pg_connection_busy