php 한글 메뉴얼 도움말 검색 사이트 MySQL 서버에 지속 접속 열기 [function.mysql-pconnect]

설명

resource mysql_pconnect ([ string $server [, string $username [, string $password [, int $client_flags ]]]] )

MySQL 서버로 지속적인 접속을 생성한다.

mysql_pconnect()는 mysql_connect()와 두 가지의 차이점을 제외하고 거의 동일하다.

첫 번째로, 접속할 때 동일한 호스트, 사용자명, 비밀번호로 이미 열려진 (지속적인) 링크를 찾으려 시도한다. 만약 찾으면 새 접속을 여는 대신에 찾은 접속을 반환할 것이다.

두 번째로, SQL 서버로의 접속은 스크립트 실행이 종료될 때 종료되지 않는다. 대신, 접속 링크는 나중에사용되도록 남을 것이다(mysql_close()는 mysql_pconnect()에 의해 열려진 접속을 종료하지 않을 것이다).

그러므로, 이 접속 형태를 지속적이라고 부른다.

인수

server

MySQL 서버명을 입력하며, 포트번호가 포함될 수 있다. 예) "hostname:port" 또는, 로컬호스트를 위해 로컬 소켓 경로가 될 수도 있다. 예) ":/path/to/socket"

PHP 지시어 mysql.default_host가 지정되지 않는다면, 기본값은 'localhost:3306'이다.

username

사용자명. 기본값은 서버 프로세스가 소유하고 있는 사용자명이다.

password

비밀번호. 기본값은 빈 비밀번호이다.

client_flags

client_flags는 다음의 상수를 조합하여 사용할 수 있습니다: 128 (LOAD DATA LOCAL 다루기 활성화), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE, MYSQL_CLIENT_INTERACTIVE.

반환값

접속 성공시 MySQL 지속적 접속 식별자를 반환하고, 실패시에는 FALSE를 반환한다.

변경점

버전	설명
4.3.0	`client_flags`가 추가되었다.
3.0.10	`server`에 ":/path/to/socket" 를 사용할 수 있게 되었다.
3.0.0	`server`에 ":port" 를 사용 가능하게 되었다.

주의

Note:
PHP 모듈 버전을사용할 경우에만 지속적 접속이 정상적으로 동작한다. 더 많은 정보는 지속적 데이터베이스 접속을 참조하라.

Warning

지속적 접속을 사용하는 것은 MySQL이 허용하는 접속수를 초과하지 않기 위해 Apache와 MySQL 설정의 일부분 튜닝이 필요하다.

Note:
함수 이름 앞에 @를 이용하여 접속 실패 에러 메시지를 출력되지 않도록 할 수 있다.

참고

mysql_connect() - MySQL 서버에 접속
지속적 데이터베이스 접속