<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>mysql_pconnect</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PHP 手册"
HREF="index.html"><LINK
REL="UP"
TITLE="MySQL 函数"
HREF="ref.mysql.html"><LINK
REL="PREVIOUS"
TITLE="mysql_num_rows"
HREF="function.mysql-num-rows.html"><LINK
REL="NEXT"
TITLE="mysql_ping"
HREF="function.mysql-ping.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="refentry"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PHP 手册</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="function.mysql-num-rows.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="function.mysql-ping.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="function.mysql-pconnect"
></A
>mysql_pconnect</H1
><DIV
CLASS="refnamediv"
><A
NAME="AEN136180"
></A
><P
> (PHP 3, PHP 4, PHP 5)</P
>mysql_pconnect --
打开一个到 MySQL 服务器的持久连接
</DIV
><DIV
CLASS="refsect1"
><A
NAME="AEN136183"
></A
><H2
>说明</H2
>resource <B
CLASS="methodname"
>mysql_pconnect</B
> ( [string server [, string username [, string password [, int client_flags]]]] )<BR
></BR
><P
> 如果成功则返回一个正的 MySQL 持久连接标识符，出错则返回 <TT
CLASS="constant"
><B
>FALSE</B
></TT
>。
</P
><P
> <B
CLASS="function"
>mysql_pconnect()</B
>
建立一个到 MySQL
服务器的连接。如果没有提供可选参数，则使用如下默认值：<CODE
CLASS="parameter"
>server</CODE
> =
'localhost:3306'，<CODE
CLASS="parameter"
>username</CODE
> =
服务器进程所有者的用户名，<CODE
CLASS="parameter"
>password</CODE
> =
空密码。<CODE
CLASS="parameter"
>client_flags</CODE
>
参数可以是以下常量的组合：MYSQL_CLIENT_COMPRESS，MYSQL_CLIENT_IGNORE_SPACE
或者 MYSQL_CLIENT_INTERACTIVE。
</P
><P
> <CODE
CLASS="parameter"
>server</CODE
>
参数也可以包括端口号，例如
"hostname:port"，或者是本机套接字的的路径，例如
":/path/to/socket"。
<DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
对 ":port" 的支持是 3.0B4 版添加的。
</P
><P
> 对 ":/path/to/socket" 的支持是 3.0.10 版添加的。
</P
></BLOCKQUOTE
></DIV
>
</P
><P
> <B
CLASS="function"
>mysql_pconnect()</B
>
和
<A
HREF="function.mysql-connect.html"
><B
CLASS="function"
>mysql_connect()</B
></A
>
非常相似，但有两个主要区别。
</P
><P
> 首先，当连接的时候本函数将先尝试寻找一个在同一个主机上用同样的用户名和密码已经打开的（持久）连接，如果找到，则返回此连接标识而不打开新连接。
</P
><P
> 其次，当脚本执行完毕后到
SQL 服务器的连接不会被关闭，此连接将保持打开以备以后使用（<A
HREF="function.mysql-close.html"
><B
CLASS="function"
>mysql_close()</B
></A
>
不会关闭由
<B
CLASS="function"
>mysql_pconnect()</B
> 建立的连接）。
</P
><P
> 可选参数
<CODE
CLASS="parameter"
>client_flags</CODE
>
自 PHP 4.3.0 版起可用。
</P
><P
> 此种连接称为“持久的”。
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>注意: </B
>
注意，此种连接仅能用于模块版本的 PHP。更多信息参见<A
HREF="features.persistent-connections.html"
>数据库持久连接</A
>一节。
</P
></BLOCKQUOTE
></DIV
><DIV
CLASS="warning"
><P
></P
><TABLE
CLASS="warning"
BORDER="1"
WIDTH="100%"
><TR
><TD
ALIGN="CENTER"
><B
>警告</B
></TD
></TR
><TR
><TD
ALIGN="LEFT"
><P
> 使用持久连接需要调整一些
Apache 和 MySQL
的配置以使不会超出 MySQL 所允许的连接数目。
</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="function.mysql-num-rows.html"
ACCESSKEY="P"
>上一页</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>起始页</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="function.mysql-ping.html"
ACCESSKEY="N"
>下一页</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>mysql_num_rows</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ref.mysql.html"
ACCESSKEY="U"
>上一级</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>mysql_ping</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
