mysql_pconnect
(PHP 4, PHP 5, PECL mysql:1.0)
mysql_pconnect — MySQL 서버로 영속적으로 접속
설명
MySQL 서버로 영속적인 접속을 생성한다.
mysql_pconnect()는 mysql_connect()와 두 가지의 차이점을 제외하고 거의 동일하다.
첫 번째로, 접속할 때 동일한 호스트, 사용자명, 비밀번호로 이미 열려진 (영속적인) 링크를 찾으려 시도한다. 만약 찾으면 새 접속을 여는 대신에 찾은 접속을 반환할 것이다.
두 번째로, SQL 서버로의 접속은 스크립트 실행이 종료될 때 종료되지 않는다. 대신, 접속 링크는 나중에사용되도록 남을 것이다(mysql_close()는 mysql_pconnect()에 의해 열려진 접속을 종료하지 않을 것이다).
그러므로, 이 접속 형태를 영속적(persistent)이라고 부른다.
매개변수
- server
-
MySQL 서버명을 입력하며, 포트번호가 포함될 수 있다. 예) "hostname:port" 또는, 로컬호스트를 위해 로컬 소켓 경로가 될 수도 있다. 예) ":/path/to/socket"
PHP 지시자 mysql.default_host가 지정되지 않는다면, 기본값은 'localhost:3306'이다.
- username
-
사용자명. 기본값은 서버 프로세스가 소유하고 있는 사용자명이다.
- password
-
비밀번호. 기본값은 빈 비밀번호이다.
- client_flags
-
client_flags 는 다음의 상수를 조합하여 사용할 수 있다: 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 모듈 버전을사용할 경우에만 영속적 접속이 정상적으로 동작한다. 더 많은 정보는 영속적 데이터베이스 접속을 참조하라.
영속적 접속을 사용하는 것은 MySQL이 허용하는 접속수를 초과하지 않기 위해 Apache와 MySQL 설정의 일부분 튜닝이 필요하다.
Note: 함수 이름 앞에 @를 이용하여 접속 실패 에러 메시지를 출력되지 않도록 할 수 있다.