Sockets socket_write
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_write — 소켓에 쓰기
설명
socket_write(Socket $socket
, string $data
, ?int $length
= null
): int|false
socket_write() 함수는 주어진 data
에서 socket
에 씁니다.
매개변수
socket
data
- 쓸 버퍼입니다.
length
- 선택적 매개변수
length
는 소켓에 기록되는 대체 바이트 길이를 지정할 수 있습니다. 이 길이가 버퍼 길이보다 크면 버퍼 길이로 자동으로 잘립니다.
반환 값
소켓에 성공적으로 기록된 바이트 수를 반환하거나 실패 시 false
를 반환합니다. 오류 코드는 socket_last_error()로 검색할 수 있습니다. 이 코드는 오류에 대한 텍스트 설명을 얻기 위해 socket_strerror()에 전달될 수 있습니다.
메모: socket_write()가 0을 반환하는 것은 완벽하게 유효합니다. 이는 바이트가 기록되지 않았음을 의미합니다. === 연산자를 사용하여 오류가 발생한 경우 false
를 확인하십시오.
변경 로그
버전 | 설명 |
---|---|
8.0.0 | socket 은 이제 Socket 인스턴스입니다. 이전에는 리소스였습니다. |
8.0.0 | length 는 이제 nullable입니다. |
메모
메모: socket_write()는 반드시 주어진 버퍼에서 모든 바이트를 쓰는 것은 아닙니다. 네트워크 버퍼 등에 따라 버퍼가 더 크지만 1바이트라도 일정량의 데이터만 기록되는 것은 유효합니다. 실수로 나머지 데이터를 전송하는 것을 잊지 않도록 주의해야 합니다.
기타
- socket_accept() - 소켓에서 연결을 수락합니다.
- socket_bind() - 소켓에 이름을 바인드
- socket_connect() - 소켓에서 연결을 시작합니다.
- socket_listen() - 소켓에서 연결을 수신합니다.
- socket_read() - 소켓에서 최대 길이 바이트를 읽습니다.
- socket_strerror() - 소켓 오류를 설명하는 문자열 반환