1 | <HTML
|
---|
2 | ><HEAD
|
---|
3 | ><TITLE
|
---|
4 | >pg_connect</TITLE
|
---|
5 | ><META
|
---|
6 | NAME="GENERATOR"
|
---|
7 | CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
---|
8 | REL="HOME"
|
---|
9 | TITLE="Manuál PHP"
|
---|
10 | HREF="index.html"><LINK
|
---|
11 | REL="UP"
|
---|
12 | TITLE="PostgreSQL functions"
|
---|
13 | HREF="ref.pgsql.html"><LINK
|
---|
14 | REL="PREVIOUS"
|
---|
15 | TITLE="pg_close"
|
---|
16 | HREF="function.pg-close.html"><LINK
|
---|
17 | REL="NEXT"
|
---|
18 | TITLE="pg_connection_busy"
|
---|
19 | HREF="function.pg-connection-busy.html"><META
|
---|
20 | HTTP-EQUIV="Content-type"
|
---|
21 | CONTENT="text/html; charset=ISO-8859-2"></HEAD
|
---|
22 | ><BODY
|
---|
23 | CLASS="refentry"
|
---|
24 | BGCOLOR="#FFFFFF"
|
---|
25 | TEXT="#000000"
|
---|
26 | LINK="#0000FF"
|
---|
27 | VLINK="#840084"
|
---|
28 | ALINK="#0000FF"
|
---|
29 | ><DIV
|
---|
30 | CLASS="NAVHEADER"
|
---|
31 | ><TABLE
|
---|
32 | SUMMARY="Header navigation table"
|
---|
33 | WIDTH="100%"
|
---|
34 | BORDER="0"
|
---|
35 | CELLPADDING="0"
|
---|
36 | CELLSPACING="0"
|
---|
37 | ><TR
|
---|
38 | ><TH
|
---|
39 | COLSPAN="3"
|
---|
40 | ALIGN="center"
|
---|
41 | >Manuál PHP</TH
|
---|
42 | ></TR
|
---|
43 | ><TR
|
---|
44 | ><TD
|
---|
45 | WIDTH="10%"
|
---|
46 | ALIGN="left"
|
---|
47 | VALIGN="bottom"
|
---|
48 | ><A
|
---|
49 | HREF="function.pg-close.html"
|
---|
50 | ACCESSKEY="P"
|
---|
51 | >Pøedcházející</A
|
---|
52 | ></TD
|
---|
53 | ><TD
|
---|
54 | WIDTH="80%"
|
---|
55 | ALIGN="center"
|
---|
56 | VALIGN="bottom"
|
---|
57 | ></TD
|
---|
58 | ><TD
|
---|
59 | WIDTH="10%"
|
---|
60 | ALIGN="right"
|
---|
61 | VALIGN="bottom"
|
---|
62 | ><A
|
---|
63 | HREF="function.pg-connection-busy.html"
|
---|
64 | ACCESSKEY="N"
|
---|
65 | >Dal¹í</A
|
---|
66 | ></TD
|
---|
67 | ></TR
|
---|
68 | ></TABLE
|
---|
69 | ><HR
|
---|
70 | ALIGN="LEFT"
|
---|
71 | WIDTH="100%"></DIV
|
---|
72 | ><H1
|
---|
73 | ><A
|
---|
74 | NAME="function.pg-connect"
|
---|
75 | ></A
|
---|
76 | >pg_connect</H1
|
---|
77 | ><DIV
|
---|
78 | CLASS="refnamediv"
|
---|
79 | ><A
|
---|
80 | NAME="AEN70005"
|
---|
81 | ></A
|
---|
82 | ><P
|
---|
83 | > (PHP 3, PHP 4 )</P
|
---|
84 | >pg_connect -- Open a PostgreSQL connection</DIV
|
---|
85 | ><DIV
|
---|
86 | CLASS="refsect1"
|
---|
87 | ><A
|
---|
88 | NAME="AEN70008"
|
---|
89 | ></A
|
---|
90 | ><H2
|
---|
91 | >Description</H2
|
---|
92 | >resource <B
|
---|
93 | CLASS="methodname"
|
---|
94 | >pg_connect</B
|
---|
95 | > ( string connection_string)<BR
|
---|
96 | ></BR
|
---|
97 | ><P
|
---|
98 | > <B
|
---|
99 | CLASS="function"
|
---|
100 | >pg_connect()</B
|
---|
101 | > returns a connection resource
|
---|
102 | that is needed by other PostgreSQL functions.
|
---|
103 | </P
|
---|
104 | ><P
|
---|
105 | > <B
|
---|
106 | CLASS="function"
|
---|
107 | >pg_connect()</B
|
---|
108 | > opens a connection to a
|
---|
109 | PostgreSQL database specified by the
|
---|
110 | <TT
|
---|
111 | CLASS="parameter"
|
---|
112 | ><I
|
---|
113 | >connection_string</I
|
---|
114 | ></TT
|
---|
115 | >. It returns a connection
|
---|
116 | resource on success. It returns <TT
|
---|
117 | CLASS="constant"
|
---|
118 | ><B
|
---|
119 | >FALSE</B
|
---|
120 | ></TT
|
---|
121 | > if the connection could
|
---|
122 | not be made. <TT
|
---|
123 | CLASS="parameter"
|
---|
124 | ><I
|
---|
125 | >connection_string</I
|
---|
126 | ></TT
|
---|
127 | > should be
|
---|
128 | a quoted string.
|
---|
129 | <TABLE
|
---|
130 | WIDTH="100%"
|
---|
131 | BORDER="0"
|
---|
132 | CELLPADDING="0"
|
---|
133 | CELLSPACING="0"
|
---|
134 | CLASS="EXAMPLE"
|
---|
135 | ><TR
|
---|
136 | ><TD
|
---|
137 | ><DIV
|
---|
138 | CLASS="example"
|
---|
139 | ><A
|
---|
140 | NAME="AEN70023"
|
---|
141 | ></A
|
---|
142 | ><P
|
---|
143 | ><B
|
---|
144 | >Pøíklad 1. Using pg_connect</B
|
---|
145 | ></P
|
---|
146 | ><TABLE
|
---|
147 | BORDER="0"
|
---|
148 | BGCOLOR="#E0E0E0"
|
---|
149 | CELLPADDING="5"
|
---|
150 | ><TR
|
---|
151 | ><TD
|
---|
152 | ><PRE
|
---|
153 | CLASS="php"
|
---|
154 | ><?php
|
---|
155 | $dbconn = pg_connect ("dbname=mary");
|
---|
156 | //connect to a database named "mary"
|
---|
157 | $dbconn2 = pg_connect ("host=localhost port=5432 dbname=mary");
|
---|
158 | // connect to a database named "mary" on "localhost" at port "5432"
|
---|
159 | $dbconn3 = pg_connect ("host=sheep port=5432 dbname=mary user=lamb password=foo");
|
---|
160 | //connect to a database named "mary" on the host "sheep" with a username and password
|
---|
161 | $conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
|
---|
162 | $dbconn4 = pg_connect ($conn_string);
|
---|
163 | //connect to a database named "test" on the host "sheep" with a username and password
|
---|
164 | ?></PRE
|
---|
165 | ></TD
|
---|
166 | ></TR
|
---|
167 | ></TABLE
|
---|
168 | ></DIV
|
---|
169 | ></TD
|
---|
170 | ></TR
|
---|
171 | ></TABLE
|
---|
172 | >
|
---|
173 | The arguments available for
|
---|
174 | <TT
|
---|
175 | CLASS="parameter"
|
---|
176 | ><I
|
---|
177 | >connection_string</I
|
---|
178 | ></TT
|
---|
179 | > includes
|
---|
180 | <TT
|
---|
181 | CLASS="parameter"
|
---|
182 | ><I
|
---|
183 | >host</I
|
---|
184 | ></TT
|
---|
185 | >, <TT
|
---|
186 | CLASS="parameter"
|
---|
187 | ><I
|
---|
188 | >port</I
|
---|
189 | ></TT
|
---|
190 | >,
|
---|
191 | <TT
|
---|
192 | CLASS="parameter"
|
---|
193 | ><I
|
---|
194 | >tty</I
|
---|
195 | ></TT
|
---|
196 | >, <TT
|
---|
197 | CLASS="parameter"
|
---|
198 | ><I
|
---|
199 | >options</I
|
---|
200 | ></TT
|
---|
201 | >,
|
---|
202 | <TT
|
---|
203 | CLASS="parameter"
|
---|
204 | ><I
|
---|
205 | >dbname</I
|
---|
206 | ></TT
|
---|
207 | >, <TT
|
---|
208 | CLASS="parameter"
|
---|
209 | ><I
|
---|
210 | >user</I
|
---|
211 | ></TT
|
---|
212 | >, and
|
---|
213 | <TT
|
---|
214 | CLASS="parameter"
|
---|
215 | ><I
|
---|
216 | >password</I
|
---|
217 | ></TT
|
---|
218 | >.
|
---|
219 | </P
|
---|
220 | ><P
|
---|
221 | > If a second call is made to <B
|
---|
222 | CLASS="function"
|
---|
223 | >pg_connect()</B
|
---|
224 | > with
|
---|
225 | the same <TT
|
---|
226 | CLASS="parameter"
|
---|
227 | ><I
|
---|
228 | >connection_string</I
|
---|
229 | ></TT
|
---|
230 | >, no
|
---|
231 | new connection will be established, but instead, the connection
|
---|
232 | resource of the already opened connection will be returned. You
|
---|
233 | can have multiple connections to the same database if you use
|
---|
234 | different connection string.
|
---|
235 | </P
|
---|
236 | ><P
|
---|
237 | > The old syntax with multiple parameters
|
---|
238 | <B
|
---|
239 | CLASS="command"
|
---|
240 | >$conn = pg_connect ("host", "port", "options", "tty", "dbname")
|
---|
241 | </B
|
---|
242 | > has been deprecated.
|
---|
243 | </P
|
---|
244 | ><P
|
---|
245 | > See also <A
|
---|
246 | HREF="function.pg-pconnect.html"
|
---|
247 | ><B
|
---|
248 | CLASS="function"
|
---|
249 | >pg_pconnect()</B
|
---|
250 | ></A
|
---|
251 | >,
|
---|
252 | <A
|
---|
253 | HREF="function.pg-close.html"
|
---|
254 | ><B
|
---|
255 | CLASS="function"
|
---|
256 | >pg_close()</B
|
---|
257 | ></A
|
---|
258 | >, <A
|
---|
259 | HREF="function.pg-host.html"
|
---|
260 | ><B
|
---|
261 | CLASS="function"
|
---|
262 | >pg_host()</B
|
---|
263 | ></A
|
---|
264 | >,
|
---|
265 | <A
|
---|
266 | HREF="function.pg-port.html"
|
---|
267 | ><B
|
---|
268 | CLASS="function"
|
---|
269 | >pg_port()</B
|
---|
270 | ></A
|
---|
271 | >, <A
|
---|
272 | HREF="function.pg-tty.html"
|
---|
273 | ><B
|
---|
274 | CLASS="function"
|
---|
275 | >pg_tty()</B
|
---|
276 | ></A
|
---|
277 | >,
|
---|
278 | <A
|
---|
279 | HREF="function.pg-options.html"
|
---|
280 | ><B
|
---|
281 | CLASS="function"
|
---|
282 | >pg_options()</B
|
---|
283 | ></A
|
---|
284 | > and <A
|
---|
285 | HREF="function.pg-dbname.html"
|
---|
286 | ><B
|
---|
287 | CLASS="function"
|
---|
288 | >pg_dbname()</B
|
---|
289 | ></A
|
---|
290 | >.
|
---|
291 | </P
|
---|
292 | ></DIV
|
---|
293 | ><DIV
|
---|
294 | CLASS="NAVFOOTER"
|
---|
295 | ><HR
|
---|
296 | ALIGN="LEFT"
|
---|
297 | WIDTH="100%"><TABLE
|
---|
298 | SUMMARY="Footer navigation table"
|
---|
299 | WIDTH="100%"
|
---|
300 | BORDER="0"
|
---|
301 | CELLPADDING="0"
|
---|
302 | CELLSPACING="0"
|
---|
303 | ><TR
|
---|
304 | ><TD
|
---|
305 | WIDTH="33%"
|
---|
306 | ALIGN="left"
|
---|
307 | VALIGN="top"
|
---|
308 | ><A
|
---|
309 | HREF="function.pg-close.html"
|
---|
310 | ACCESSKEY="P"
|
---|
311 | >Pøedcházející</A
|
---|
312 | ></TD
|
---|
313 | ><TD
|
---|
314 | WIDTH="34%"
|
---|
315 | ALIGN="center"
|
---|
316 | VALIGN="top"
|
---|
317 | ><A
|
---|
318 | HREF="index.html"
|
---|
319 | ACCESSKEY="H"
|
---|
320 | >Domù</A
|
---|
321 | ></TD
|
---|
322 | ><TD
|
---|
323 | WIDTH="33%"
|
---|
324 | ALIGN="right"
|
---|
325 | VALIGN="top"
|
---|
326 | ><A
|
---|
327 | HREF="function.pg-connection-busy.html"
|
---|
328 | ACCESSKEY="N"
|
---|
329 | >Dal¹í</A
|
---|
330 | ></TD
|
---|
331 | ></TR
|
---|
332 | ><TR
|
---|
333 | ><TD
|
---|
334 | WIDTH="33%"
|
---|
335 | ALIGN="left"
|
---|
336 | VALIGN="top"
|
---|
337 | >pg_close</TD
|
---|
338 | ><TD
|
---|
339 | WIDTH="34%"
|
---|
340 | ALIGN="center"
|
---|
341 | VALIGN="top"
|
---|
342 | ><A
|
---|
343 | HREF="ref.pgsql.html"
|
---|
344 | ACCESSKEY="U"
|
---|
345 | >Nahoru</A
|
---|
346 | ></TD
|
---|
347 | ><TD
|
---|
348 | WIDTH="33%"
|
---|
349 | ALIGN="right"
|
---|
350 | VALIGN="top"
|
---|
351 | >pg_connection_busy</TD
|
---|
352 | ></TR
|
---|
353 | ></TABLE
|
---|
354 | ></DIV
|
---|
355 | ></BODY
|
---|
356 | ></HTML
|
---|
357 | >
|
---|