mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-18 05:26:57 +08:00
105 lines
8.6 KiB
HTML
105 lines
8.6 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title>Open a new connection to the MaxDB server</title>
|
|
</head>
|
|
<body class="docs"><div id="layout">
|
|
<div id="layout-content"><div id="function.maxdb-connect" class="refentry">
|
|
<div class="refnamediv">
|
|
<h1 class="refname">maxdb_connect</h1>
|
|
<h1 class="refname">maxdb::__construct</h1>
|
|
<p class="verinfo">(PECL maxdb >= 1.0)</p><p class="refpurpose"><span class="refname">maxdb_connect</span> -- <span class="refname">maxdb::__construct</span> — <span class="dc-title">Open a new connection to the MaxDB server</span></p>
|
|
|
|
</div>
|
|
|
|
<div class="refsect1 description" id="refsect1-function.maxdb-connect-description">
|
|
<h3 class="title">说明</h3>
|
|
<p class="para">过程化风格</p>
|
|
<div class="methodsynopsis dc-description">
|
|
<span class="methodname"><strong>maxdb_connect</strong></span>
|
|
([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$host</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$passwd</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$dbname</code></span>
|
|
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$port</code><span class="initializer"> = 0</span></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$socket</code></span>
|
|
]]]]]] ) : <span class="type">resource</span></div>
|
|
|
|
<p class="para rdfs-comment">面向对象风格</p>
|
|
<div class="constructorsynopsis dc-description">
|
|
<span class="methodname"><strong>maxdb::__construct</strong></span>
|
|
([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$host</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$passwd</code></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$dbname</code></span>
|
|
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$port</code><span class="initializer"> = 0</span></span>
|
|
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$socket</code></span>
|
|
]]]]]] )</div>
|
|
|
|
<p class="para rdfs-comment">
|
|
The <span class="function"><strong>maxdb_connect()</strong></span> function attempts to open a connection to the MaxDB Server
|
|
running on <code class="parameter">host</code> which can be either a host name or an IP address. Passing the
|
|
string "localhost" to this parameter, the local host is assumed.
|
|
If successful, the <span class="function"><strong>maxdb_connect()</strong></span>
|
|
will return an resource representing the connection to the database 或者在失败时返回 <strong><code>FALSE</code></strong>.
|
|
</p>
|
|
<p class="para">
|
|
The <code class="parameter">username</code> and <code class="parameter">password</code> parameters specify the
|
|
username and password under which to connect to the MaxDB server. If the password is not provided
|
|
(the <strong><code>NULL</code></strong> value is passed), the MaxDB server will attempt to authenticate the user against
|
|
the <code class="parameter">maxdb.default_pw</code> in <var class="filename">php.ini</var>.
|
|
</p>
|
|
<p class="para">
|
|
The <code class="parameter">dbname</code> parameter if provided will specify the default database to be
|
|
used when performing queries. If not provied, the entry <code class="parameter">maxdb.default_db</code>
|
|
in <var class="filename">php.ini</var> is used.
|
|
</p>
|
|
<p class="para">
|
|
The <code class="parameter">port</code> and <code class="parameter">socket</code> parameters are
|
|
ignored for the MaxDB server.
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 returnvalues" id="refsect1-function.maxdb-connect-returnvalues">
|
|
<h3 class="title">返回值</h3>
|
|
<p class="para">
|
|
Returns a resource which represents the connection to a MaxDB Server or
|
|
<strong><code>FALSE</code></strong> if the connection failed.
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 examples" id="refsect1-function.maxdb-connect-examples">
|
|
<h3 class="title">范例</h3>
|
|
<div class="example" id="example-1334">
|
|
<p><strong>Example #1 面向对象风格</strong></p>
|
|
<div class="example-contents">
|
|
<div class="phpcode"><pre><span style="color: #000000">
|
|
<span style="color: #0000BB"><?php<br />$maxdb </span><span style="color: #007700">= new </span><span style="color: #0000BB">maxdb</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #DD0000">"MONA"</span><span style="color: #007700">, </span><span style="color: #DD0000">"RED"</span><span style="color: #007700">, </span><span style="color: #DD0000">"DEMODB"</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* check connection */<br /></span><span style="color: #007700">if (</span><span style="color: #0000BB">maxdb_connect_errno</span><span style="color: #007700">()) {<br /> </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Connect failed: %s\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">maxdb_connect_error</span><span style="color: #007700">());<br /> exit();<br />}<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Host information: %s\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">$maxdb</span><span style="color: #007700">-></span><span style="color: #0000BB">host_info</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* close connection */<br /></span><span style="color: #0000BB">$maxdb</span><span style="color: #007700">-></span><span style="color: #0000BB">close</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">?></span>
|
|
</span>
|
|
</pre></div>
|
|
</div>
|
|
|
|
</div>
|
|
<div class="example" id="example-1335">
|
|
<p><strong>Example #2 过程化风格</strong></p>
|
|
<div class="example-contents">
|
|
<div class="phpcode"><pre><span style="color: #000000">
|
|
<span style="color: #0000BB"><?php<br />$link </span><span style="color: #007700">= </span><span style="color: #0000BB">maxdb_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #DD0000">"MONA"</span><span style="color: #007700">, </span><span style="color: #DD0000">"RED"</span><span style="color: #007700">, </span><span style="color: #DD0000">"DEMODB"</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* check connection */<br /></span><span style="color: #007700">if (!</span><span style="color: #0000BB">$link</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Connect failed: %s\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">maxdb_connect_error</span><span style="color: #007700">());<br /> exit();<br />}<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"Host information: %s\n"</span><span style="color: #007700">, </span><span style="color: #0000BB">maxdb_get_host_info</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/* close connection */<br /></span><span style="color: #0000BB">maxdb_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
|
|
</span>
|
|
</pre></div>
|
|
</div>
|
|
|
|
</div>
|
|
<p class="para">以上例程的输出类似于：</p>
|
|
<div class="example-contents screen">
|
|
<div class="cdata"><pre>
|
|
Host information: localhost
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div></div></div></body></html> |