mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-19 06:16:58 +08:00
278 lines
17 KiB
HTML
278 lines
17 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>打开一个到 MySQL 服务器的连接</title>
|
||
</head>
|
||
<body class="docs"><div id="layout">
|
||
<div id="layout-content"><div id="function.mysql-connect" class="refentry">
|
||
<div class="refnamediv">
|
||
<h1 class="refname">mysql_connect</h1>
|
||
<p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">mysql_connect</span> — <span class="dc-title">打开一个到 MySQL 服务器的连接</span></p>
|
||
|
||
</div>
|
||
|
||
<div id="function.mysql-connect-refsynopsisdiv">
|
||
<div class="warning"><strong class="warning">Warning</strong>
|
||
<p class="para">本扩展自 PHP 5.5.0
|
||
起已废弃，并在自 PHP 7.0.0 开始被移除。应使用 <a href="book.mysqli.html" class="link">MySQLi</a>
|
||
或 <a href="ref.pdo_mysql.html" class="link">PDO_MySQL</a> 扩展来替换之。参见
|
||
<a href="mysqlinfo.api.choosing.html" class="link">MySQL：选择 API</a> 指南以及<a href="faq.databases.html#faq.databases.mysql.deprecated" class="link">相关 FAQ</a> 来获取更多信息。用以替代本函数的有：</p>
|
||
<ul class="simplelist">
|
||
<li class="member"><span class="function"><a href="mysqli_connect.html" class="function">mysqli_connect()</a></span></li>
|
||
<li class="member"><span class="methodname"><a href="pdo.construct.html" class="methodname">PDO::__construct()</a></span></li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="refsect1 description" id="refsect1-function.mysql-connect-description">
|
||
<h3 class="title">说明</h3>
|
||
<div class="methodsynopsis dc-description">
|
||
<span class="methodname"><strong>mysql_connect</strong></span>
|
||
([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$server</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">$password</code></span>
|
||
[, <span class="methodparam"><span class="type">bool</span> <code class="parameter">$new_link</code></span>
|
||
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$client_flags</code></span>
|
||
]]]]] ) : <span class="type">resource</span></div>
|
||
|
||
<p class="para rdfs-comment">
|
||
打开或重复使用一个到 MySQL 服务器的连接。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 parameters" id="refsect1-function.mysql-connect-parameters">
|
||
<h3 class="title">参数</h3>
|
||
<p class="para">
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">server</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
MySQL 服务器。可以包括端口号，例如
|
||
"hostname:port"，或者到本地套接字的路径，例如对于 localhost 的 ":/path/to/socket"。
|
||
</p>
|
||
<p class="para">
|
||
如果 PHP 指令 <a href="mysql.configuration.html#ini.mysql.default-host" class="link">
|
||
mysql.default_host</a> 未定义（默认情况），则默认值是 'localhost:3306'。
|
||
在 <a href="ini.core.html#ini.sql.safe-mode" class="link">SQL 安全模式</a> 时，参数被忽略，总是使用 'localhost:3306'。
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">username</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
用户名。默认值由 <a href="mysql.configuration.html#ini.mysql.default-user" class="link">mysql.default_user</a> 定义。
|
||
在 <a href="ini.core.html#ini.sql.safe-mode" class="link">SQL 安全模式</a> 时，参数被忽略，总是使用服务器进程所有者的用户名。
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">password</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
密码。默认值由<a href="mysql.configuration.html#ini.mysql.default-password" class="link">mysql.default_password</a>定义。在 <a href="ini.core.html#ini.sql.safe-mode" class="link">SQL 安全模式</a> 时，参数被忽略，总是使用空密码。
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">new_link</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
如果用同样的参数第二次调用
|
||
<span class="function"><strong>mysql_connect()</strong></span>，将不会建立新连接，而将返回已经打开的连接标识。参数
|
||
<code class="parameter">new_link</code> 改变此行为并使
|
||
<span class="function"><strong>mysql_connect()</strong></span> 总是打开新的连接，甚至当
|
||
<span class="function"><strong>mysql_connect()</strong></span> 曾在前面被用同样的参数调用过。
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">client_flags</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
<code class="parameter">client_flags</code>
|
||
参数可以是以下常量的组合：<strong><code>MYSQL_CLIENT_SSL</code></strong>，<strong><code>MYSQL_CLIENT_COMPRESS</code></strong>，<strong><code>MYSQL_CLIENT_IGNORE_SPACE</code></strong>
|
||
或 <strong><code>MYSQL_CLIENT_INTERACTIVE</code></strong>。进一步信息见<a href="mysql.constants.html#mysql.client-flags" class="xref">MySQL 客户端常量</a>。
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 returnvalues" id="refsect1-function.mysql-connect-returnvalues">
|
||
<h3 class="title">返回值</h3>
|
||
<p class="para">
|
||
如果成功则返回一个 MySQL 连接标识， 或者在失败时返回 <strong><code>FALSE</code></strong>。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 changelog" id="refsect1-function.mysql-connect-changelog">
|
||
<h3 class="title">更新日志</h3>
|
||
<p class="para">
|
||
<table class="doctable informaltable">
|
||
|
||
<thead>
|
||
<tr>
|
||
<th>版本</th>
|
||
<th>说明</th>
|
||
</tr>
|
||
|
||
</thead>
|
||
|
||
<tbody class="tbody">
|
||
<tr>
|
||
<td>4.3.0</td>
|
||
<td>
|
||
添加 <code class="parameter">client_flags</code> 参数。
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>4.2.0</td>
|
||
<td>
|
||
添加 <code class="parameter">new_link</code> 参数。
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>3.0.10</td>
|
||
<td>
|
||
对 <code class="parameter">server</code> 添加 ":/path/to/socket" 支持。
|
||
</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>3.0.0</td>
|
||
<td>
|
||
对 <code class="parameter">server</code> 添加 ":port" 支持。
|
||
</td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
|
||
</table>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 examples" id="refsect1-function.mysql-connect-examples">
|
||
<h3 class="title">范例</h3>
|
||
<p class="para">
|
||
<div class="example" id="example-2120">
|
||
<p><strong>Example #1 <span class="function"><strong>mysql_connect()</strong></span> 例子</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">mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'localhost'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_user'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_password'</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$link</span><span style="color: #007700">) {<br /> die(</span><span style="color: #DD0000">'Could not connect: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br />}<br />echo </span><span style="color: #DD0000">'Connected successfully'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">mysql_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>
|
||
<p class="para">
|
||
<div class="example" id="example-2121">
|
||
<p><strong>Example #2 <span class="function"><strong>mysql_connect()</strong></span> 例子：使用 <em>hostname:port</em> 语法</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">// we connect to example.com and port 3307<br /></span><span style="color: #0000BB">$link </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'example.com:3307'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_user'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_password'</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$link</span><span style="color: #007700">) {<br /> die(</span><span style="color: #DD0000">'Could not connect: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br />}<br />echo </span><span style="color: #DD0000">'Connected successfully'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">mysql_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// we connect to localhost at port 3307<br /></span><span style="color: #0000BB">$link </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'127.0.0.1:3307'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_user'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_password'</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$link</span><span style="color: #007700">) {<br /> die(</span><span style="color: #DD0000">'Could not connect: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br />}<br />echo </span><span style="color: #DD0000">'Connected successfully'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">mysql_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>
|
||
<p class="para">
|
||
<div class="example" id="example-2122">
|
||
<p><strong>Example #3 <span class="function"><strong>mysql_connect()</strong></span> 例子：使用 ":/path/to/socket" 语法</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">// we connect to localhost and socket e.g. /tmp/mysql.sock<br /><br />//variant 1: ommit localhost<br /></span><span style="color: #0000BB">$link </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'/tmp/mysql'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_user'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_password'</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$link</span><span style="color: #007700">) {<br /> die(</span><span style="color: #DD0000">'Could not connect: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br />}<br />echo </span><span style="color: #DD0000">'Connected successfully'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">mysql_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$link</span><span style="color: #007700">);<br /><br /><br /></span><span style="color: #FF8000">// variant 2: with localhost<br /></span><span style="color: #0000BB">$link </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">'localhost:/tmp/mysql.sock'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_user'</span><span style="color: #007700">, </span><span style="color: #DD0000">'mysql_password'</span><span style="color: #007700">);<br />if (!</span><span style="color: #0000BB">$link</span><span style="color: #007700">) {<br /> die(</span><span style="color: #DD0000">'Could not connect: ' </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br />}<br />echo </span><span style="color: #DD0000">'Connected successfully'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">mysql_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>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 notes" id="refsect1-function.mysql-connect-notes">
|
||
<h3 class="title">注释</h3>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">本扩展自 PHP 5.5.0
|
||
起已废弃，并在自 PHP 7.0.0 开始被移除。应使用 <a href="book.mysqli.html" class="link">MySQLi</a>
|
||
或 <a href="ref.pdo_mysql.html" class="link">PDO_MySQL</a> 扩展来替换之。参见
|
||
<a href="mysqlinfo.api.choosing.html" class="link">MySQL：选择 API</a> 指南以及<a href="faq.databases.html#faq.databases.mysql.deprecated" class="link">相关 FAQ</a> 来获取更多信息。用以替代本函数的有：</p>
|
||
<p class="para">
|
||
<ul class="simplelist">
|
||
<li class="member"><span class="function"><a href="mysqli_connect.html" class="function">mysqli_connect()</a></span></li>
|
||
<li class="member"><span class="methodname"><a href="pdo.construct.html" class="methodname">PDO::__construct()</a></span></li>
|
||
</ul>
|
||
</p>
|
||
</p></blockquote>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
只要将 server 指定为 "localhost" 或
|
||
"localhost:port"，MySQL 客户端库会越过此值并尝试连接到本地套接字（Windows
|
||
中的名字管道）。如果想用 TCP/IP，应该用 "127.0.0.1"
|
||
代替 "localhost"。如果 MySQL 客户端库试图连接到一个错误的本地套接字，则应该在
|
||
PHP 配置中设定 <a href="mysql.configuration.html#ini.mysql.default-host" class="xref"></a>
|
||
的正确路径并把 server 留空。
|
||
</p>
|
||
</p></blockquote>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
脚本一结束，到服务器的连接就被关闭，除非之前已经明确调用
|
||
<span class="function"><a href="mysql_close.html" class="function">mysql_close()</a></span> 关闭了。
|
||
</p>
|
||
</p></blockquote>
|
||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||
<p class="para">
|
||
可以在函数名前加上一个
|
||
<a href="language.operators.errorcontrol.html" class="link">@</a>
|
||
来抑制出错时的错误信息。
|
||
</p>
|
||
</p></blockquote>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 seealso" id="refsect1-function.mysql-connect-seealso">
|
||
<h3 class="title">参见</h3>
|
||
<p class="para">
|
||
<ul class="simplelist">
|
||
<li class="member"><span class="function"><a href="mysql_pconnect.html" class="function" rel="rdfs-seeAlso">mysql_pconnect()</a> - 打开一个到 MySQL 服务器的持久连接</span></li>
|
||
<li class="member"><span class="function"><a href="mysql_close.html" class="function" rel="rdfs-seeAlso">mysql_close()</a> - 关闭 MySQL 连接</span></li>
|
||
</ul>
|
||
</p>
|
||
</div>
|
||
|
||
</div></div></div></body></html> |