설명
resource fsockopen ( string $hostname [, int $port = -1 [, int &$errno [, string &$errstr [, float $timeout = ini_get("default_socket_timeout") ]]]] )
hostname 로 지정한 자원에 대한 소켓 연결을 시작합니다.
지원되는 소켓 트랜스포트의 명단에 기술되어 있듯이, PHP는 Internet도메인 또는 Unix도메인을 지원합니다. 지원되는 트랜스 포트의 목록은stream_get_transports() 을 사용하고 취득할 수도 있습니다.
소켓은 기본적으로 블록 모드에서 열립니다. socket_set_blocking() 를 사용하여 비블록 모드로 바꿀 수 있습니다.
stream_socket_client() 함수도 이와 비슷하지만 보다 풍부한 옵션을 갖고 있어 비블록 접속을 하거나 스트리밍 컨텍스트를 제공하거나 하는 기능이 있습니다.
파라미터
hostname
OpenSSL지원이 설치되어 있는 경우 hostname 앞 또ssl:// 는 tls:// 를 부가함으로써 TCP/IP 경유에서 원격 호스트에 접속할 때 SSL또는 TLS클라이언트 접속을 사용할 수 있습니다.
port
포토 번호. unix:// 처럼 포트를 사용하지 않는 트랜스포트의 경우는 -1 그래서 무시하고 스킵 시킬 수 있습니다.
errno
지정한 경우 시스템 콜connect() 에서 발생한 에러의 에러 번호가 저장됩니다.
errno 는0 것에 함수가 FALSE 를 돌려줄 경우connect() 를 호출하기 전에 오류를 발생한 것을 나타냅니다. 이 경우, 어쩌면 소켓의 초기화에 원인이 있습니다.
errstr
에러 메시지를 나타내는 문자열.
timeout
접속 시간 아웃 초수.
주의:
소켓 경유에서 데이터를 읽는 때의 타임을 설정해야 할 경우, fsockopen() 파timeout 라미터는 소켓에 접속하는 동안에만 적용되기 때문에 socket_set_timeout() 를 사용하세요.
반환 값
fsockopen()는 파일 포인터를 갚겠습니다. 이 파일 포인터는 (fgets(), fgetss(), fputs(), fclose(), feof() 같은) 다른 파일 함수로 사용 가능합니다. 실패했을 경우FALSE 를 갚겠습니다.
에러/예외
hostname 가 유효한 도메인이 아닌 경우는 E_WARNING 를 슬로합니다.
환경에 따라서는 Unix도메인 또는 옵션 접속 타임 아웃이 이용할 수 없는 것도 있습니다.
경고
UDP소켓은 리모트 호스트와의 접속이 확립되지 않더라도, 오류를 발생하지 않고 오픈된 것처럼 보이는 일이 가끔 있답니다. 이 오류는 그 소켓에서 데이터를 읽고 쓸 때에만 드러납니다. 이 원인은 UDP가"커넥션 리스"의 프로토콜로, 실제로 데이터를 송수신할 필요가 생길 때까지 운영 체계가 소켓용 링크를 확립하려고 하지 않기 때문입니다.
주의: 수치로 IPv6주소를 지정할 때에는 (예fe80::1)주소를 네모난 괄호로 묶지 않으면 안 됩니다. 예를 들어 tcp://[fe80::1]:80.