Stream socket client error 0

stream_socket_client

(PHP 5, PHP 7, PHP

stream_socket_client — Открыть соединение с интернет-сокетом или с доменным сокетом Unix

Описание

Начинает соединение потока или датаграммы с удалённым сокетом, указанным параметром address . Тип создаваемого сокета определяется по транспорту, указанному с использованием стандартного форматирования URL: transport://target . Для интернет-сокетов, (AF_INET) таких, как TCP и UDP, часть target параметра address должна состоять из имени хоста или IP-адреса, за которым следует двоеточие и номер порта. Для доменных сокетов Unix, часть target должна указывать на файл сокета в файловой системе.

По умолчанию поток будет открыт в блокирующем режиме. Вы можете переключить его в неблокирующий режим, используя функцию stream_set_blocking() .

Список параметров

Адрес удалённого сокета для соединения.

Будет присвоен номер системной ошибки, если соединение не удалось установить.

Будет присвоено сообщение о системной ошибке, если соединение не удалось установить.

Число секунд, в течение которых должно произойти время ожидания системного вызова connect() . По умолчанию используется значение default_socket_timeout.

Замечание: Этот параметр применяется только если не происходит попытка асинхронного соединения.

Чтобы указать время ожидания для чтения/записи данных через сокет, используйте функцию stream_set_timeout() , так как параметр timeout применяется только при создании соединения через сокет.

Поле битовой маски, которое может принимать значение любой комбинации флагов соединения. В настоящее время набор флагов соединения ограничен следующими значениями STREAM_CLIENT_CONNECT (по умолчанию), STREAM_CLIENT_ASYNC_CONNECT и STREAM_CLIENT_PERSISTENT .

Действующий ресурс контекста, созданный при помощи функции stream_context_create() .

Возвращаемые значения

В случае успешного выполнения возвращается ресурс потока, который может быть использован с другими файловыми функциями (такими, как fgets() , fgetss() , fwrite() , fclose() , и feof() ), в случае возникновения ошибки возвращается false .

Ошибки

В случае неудачного вызова функции аргументы error_code и error_message будут заполнены системной ошибкой, которая произошла при системном вызове connect() . Если значение, возвращённое в аргументе error_code равно 0 и функция возвратила значение false , это означает, что ошибка произошла до вызова connect() . Это произошло скорее всего из-за проблемы инициализации сокета. Примите во внимание, что аргументы error_code и error_message всегда будут передаваться по ссылке.

Список изменений

Версия	Описание
8.0.0	timeout и context теперь допускают значение null.

Примеры

Пример #1 Пример использования stream_socket_client()

Пример #2 Использование UDP-соединения

Получения дня и времени от UDP-сервиса «daytime» (порт 13) на localhost.

Примечания

UDP-сокеты иногда могут открываться без ошибки, даже если удалённый хост недоступен. Ошибка станет заметной только когда вы будете читать или писать данные из/в сокет. Причина этого в том, что UDP — это протокол без соединения, что означает, что операционная система не пытается установить соединение с сокетом до тех пор, пока ей в действительности не нужно отправить или получить данные.

Замечание: При указании числового адреса IPv6 (например, fe80::1 ) вы должны заключать его в квадратные скобки. Например, tcp://[fe80::1]:80 .

В зависимости от окружения, Unix-домены или произвольное время ожидания соединения могут быть недоступны. Список доступных транспортов может быть получен используя функцию stream_get_transports() . Смотрите список встроенных транспортов на странице Список поддерживаемых транспортных протоколов.

Смотрите также

• stream_socket_server() — Создаёт интернет-сокет или доменный сокет Unix
• stream_set_blocking() — Установить блокирующий/неблокирующий режим в потоке
• stream_set_timeout() — Установить значение времени ожидания для потока
• stream_select() — Запускает эквивалент системного вызова select() на заданных массивах потоков со временем ожидания, указанным параметрами seconds и microseconds
• fgets() — Читает строку из файла
• fgetss() — Читает строку из файла и удаляет HTML-теги
• fwrite() — Бинарно-безопасная запись в файл
• fclose() — Закрывает открытый дескриптор файла
• feof() — Проверяет, достигнут ли конец файла
• Функции cURL

User Contributed Notes 6 notes

For those wanting to use stream_socket_client() to connect to a local UNIX socket who can’t find documentation on how to do it, here’s a (rough) example:

= stream_socket_client ( ‘unix:///full/path/to/my/socket.sock’ , $errno , $errstr );

fwrite ( $sock , ‘SOME COMMAND’ . «rn» );

echo fread ( $sock , 4096 ). «n» ;

The remote_socket argument, in its end (well. after the port), can also contain a «/» followed by a unique identifier. This is especially useful if you want to create multiple persistent connections to the same transport://host:port combo.

Example:
= stream_socket_client ( ‘tcp://mysql.example.com:3306/root’ , $errorno , $errorstr , $timeout , STREAM_CLIENT_CONNECT | STREAM_CLIENT_PERSISTENT );
?>

Note that while (p)fsockopen() follows a similar scheme, it doesn’t have this particular feature.

# Some may find it useful to know that your caCert
# must be in pem format, and that PHP seems to like
# your key, cert, and cacert pem’s to be concatenated
# in a single file (I suffered various «unknown chain»
# errors, otherwise)
#
# So, (linux users), concat your components as follows:
# (where current working dir is dir where
# cert components are stored)
#
# cat key.pem >certchain.pem
# cat cert.pem >>certchain.pem
# cat cacert.pem >>certchain.pem
#
# Then, the php.
##################################

= ‘host.domain.tld’ ;
$port = 1234 ;
$timeout = 10 ;

$cert = ‘/path/to/your/certchain/certchain.pem’ ;
$context = stream_context_create (array( ‘ssl’ =>array( ‘local_cert’ => $cert ,
)));

if ( $fp = stream_socket_client ( ‘ssl://’ . $host . ‘:’ . $port , $errno , $errstr , 30 ,
STREAM_CLIENT_CONNECT , $context )) <
fwrite ( $fp , «n» );
echo fread ( $fp , 8192 );
fclose ( $fp );
> else <
echo «ERROR: $errno — $errstr
n» ;
>

If you only need to check a stream for data, you can use stream_get_content and strtr function. stream_get_content
reads the remainder of a stream into a string.
= gethostbyname ( ‘www.example.com’ );

$client = stream_socket_client ( «tcp:// $addr :80» , $errno , $errorMessage );

if( $client === false ) <
throw new UnexpectedValueException ( «Failed to connect: $errorMessage » );
>

fwrite ( $client , «GET / HTTP/1.0rnhost: ‘www.example.com’rnAccept: */*rnrn» );

$variable = stream_get_content ( $client );

if( strstr ( $variable , ‘data your looking for’ ))
echo «The data you are looking for is here» ;
else
echo «data not found» ;

I came here since fsockopen() does not support any SSL certificate checking in PHP5.

while curl is nice, I use stream_socket_client() to make XML-RPC POST requests via HTTPS and since I have not found any PHP code around that does this, I’ll attach an example that also includes HTTP-Digest Auth (eg. trac’s WikiRPCInterface2):

#################################################
# $host: hostname ; eg ‘example.org’
# $path: request’ eg ‘/index.php?id=123’
# $data_to_send : data to POST after the HTTP header.
#
# if $opts is an empty array() a standard HTTP to port 80 request is performed.
#
# set auth[‘type’]=’basic’ to use plain-text auth,
# digest-auth will be handled automatically if $auth[‘username’] is set and a 401
# status is encountered. — use auth[‘type’]=’nodigest’ to override.
#
##
function httpPost ( $host , $path , $data_to_send ,
$opts =array( ‘cert’ => «» , ‘headers’ => 0 , ‘transport’ => ‘ssl’ , ‘port’ => 443 ),
$auth =array( ‘username’ => «» , ‘password’ => «» , ‘type’ => «» )
) <
$transport = » ; $port = 80 ;
if (!empty( $opts [ ‘transport’ ])) $transport = $opts [ ‘transport’ ];
if (!empty( $opts [ ‘port’ ])) $port = $opts [ ‘port’ ];
$remote = $transport . ‘://’ . $host . ‘:’ . $port ;

$context = stream_context_create ();
$result = stream_context_set_option ( $context , ‘ssl’ , ‘verify_host’ , true );
if (!empty( $opts [ ‘cert’ ])) <
$result = stream_context_set_option ( $context , ‘ssl’ , ‘cafile’ , $opts [ ‘cert’ ]);
$result = stream_context_set_option ( $context , ‘ssl’ , ‘verify_peer’ , true );
> else <
$result = stream_context_set_option ( $context , ‘ssl’ , ‘allow_self_signed’ , true );
>
$fp = stream_socket_client ( $remote , $err , $errstr , 60 , STREAM_CLIENT_CONNECT , $context );

if (! $fp ) <
trigger_error ( ‘httpPost error: ‘ . $errstr );
return NULL ;
>

$req = » ;
$req .= «POST $path HTTP/1.1rn» ;
$req .= «Host: $host rn» ;
if ( $auth [ ‘type’ ]== ‘basic’ && !empty( $auth [ ‘username’ ])) <
$req .= «Authorization: Basic » ;
$req .= base64_encode ( $auth [ ‘username’ ]. ‘:’ . $auth [ ‘password’ ]). «rn» ;
>
elseif ( $auth [ ‘type’ ]== ‘digest’ && !empty( $auth [ ‘username’ ])) <
$req .= ‘Authorization: Digest ‘ ;
foreach ( $auth as $k => $v ) <
if (empty( $k ) || empty( $v )) continue;
if ( $k == ‘password’ ) continue;
$req .= $k . ‘=»‘ . $v . ‘», ‘ ;
>
$req .= «rn» ;
>
$req .= «Content-type: text/xmlrn» ;
$req .= ‘Content-length: ‘ . strlen ( $data_to_send ) . «rn» ;
$req .= «Connection: closernrn» ;

fputs ( $fp , $req );
fputs ( $fp , $data_to_send );

if ( 1 != preg_match ( «/^HTTP/[0-9.]* ([0-9]<3>) ([^rn]*)/» , $res , $matches )) <
trigger_error ( ‘httpPost: invalid HTTP reply.’ );
return NULL ;
>

if ( $matches [ 1 ] != ‘200’ ) <
trigger_error ( ‘httpPost: HTTP error: ‘ . $matches [ 1 ]. ‘ ‘ . $matches [ 2 ]);
return NULL ;
>

if (! $opts [ ‘headers’ ]) <
$res = preg_replace ( «/^.*rnrn/Us» , » , $res );
>
return $res ;
>
?>

Источник

stream_socket_client

stream_socket_client — Открыть соединение с интернет-сокетом или с доменным сокетом Unix

Описание

Начинает соединение потока или датаграммы с удалённым сокетом, указанным параметром remote_socket . Тип создаваемого сокета определяется по транспорту, указанному с использованием стандартного форматирования URL: transport://target. Для интернет-сокетов, (AF_INET) таких, как TCP и UDP, часть target параметра remote_socket должна состоять из имени хоста или IP-адреса, за которым следует двоеточие и номер порта. Для доменных сокетов Unix, часть target должна указывать на файл сокета в файловой системе.

По умолчанию поток будет открыт в блокирующем режиме. Вы можете переключить его в неблокирующий режим, используя функцию stream_set_blocking() .

Список параметров

Адрес удалённого сокета для соединения.

Будет присвоен номер системной ошибки, если соединение не удалось установить.

Будет присвоено сообщение о системной ошибке, если соединение не удалось установить.

Число секунд, в течение которых должен произойти тайм-аут системного вызова connect().

Замечание: Этот параметр применяется только если не происходит попытка асинхронного соединения.

Чтобы указать тайм-аут для чтения/записи данных через сокет, используйте функцию stream_set_timeout() , так как параметр timeout применяется только при создании соединения через сокет.

Поле битовой маски, которое может принимать значение любой комбинации флагов соединения. В настоящее время набор флагов соединения ограничен следующими значениями STREAM_CLIENT_CONNECT (по умолчанию), STREAM_CLIENT_ASYNC_CONNECT и STREAM_CLIENT_PERSISTENT .

Действующий ресурс контекста, созданный при помощи функции stream_context_create() .

Возвращаемые значения

В случае успешного выполнения возвращается ресурс потока, который может быть использован с другими файловыми функциями (такими, как fgets() , fgetss() , fwrite() , fclose() , и feof() ), в случае возникновения ошибки возвращается FALSE .

Ошибки

В случае неудачного вызова функции аргументы errno и errstr будут заполнены системной ошибкой, которая произошла при системном вызове connect(). Если значение, возвращённое в аргументе errno равно и функция возвратила значение FALSE , это означает, что ошибка произошла до вызова connect(). Это произошло скорее всего из-за проблемы инициализации сокета. Примите во внимание, что аргументы errno и errstr всегда будут передаваться по ссылке.

Примеры

Пример #1 Пример использования stream_socket_client()

Пример #2 Использование UDP-соединения

Получения дня и времени от UDP-сервиса «daytime» (порт 13) на localhost.

Примечания

UDP-сокеты иногда могут открываться без ошибки, даже если удалённый хост недоступен. Ошибка станет заметной только когда вы будете читать или писать данные из/в сокет. Причина этого в том, что UDP — это протокол без соединения, что означает, что операционная система не пытается установить соединение с сокетом до тех пор, пока ей в действительности не нужно отправить или получить данные.

Замечание: При указании числового адреса IPv6 (например, fe80::1) вы должны заключать его в квадратные скобки. Например, tcp://[fe80::1]:80.

В зависимости от окружения, Unix-домены или произвольный таймаут соединения могут быть недоступны. Список доступных транспортов может быть получен используя функцию stream_get_transports() . Смотрите список встроенных транспортов на странице Список поддерживаемых транспортных протоколов.

Смотрите также

• stream_socket_server() — Создаёт интернет-сокет или доменный сокет Unix
• stream_set_blocking() — Установить блокирующий/неблокирующий режим в потоке
• stream_set_timeout() — Установить значение тайм-аута для потока
• stream_select() — Запускает эквивалент системного вызова select() на заданных массивах потоков с таймаутом, указанным параметрами tv_sec и tv_usec
• fgets() — Читает строку из файла
• fgetss() — Читает строку из файла и удаляет HTML-теги
• fwrite() — Бинарно-безопасная запись в файл
• fclose() — Закрывает открытый дескриптор файла
• feof() — Проверяет, достигнут ли конец файла
• Функции cURL

Источник

Вернуться к: Функции для работы с потоками

Today I had a weird one.

The PHP function named stream_socket_client(), used to create a socket to communicate with another computer over a network, may return $errno = 0 and $errstr = «».

The PHP reference actually mentions the problem:

On failure the errno and errstr arguments will be populated with the actual system level error that occurred in the system-level connect() call. If the value returned in errno is 0 and the function returned FALSE, it is an indication that the error occurred before the connect() call. This is most likely due to a problem initializing the socket. Note that the errno and errstr arguments will always be passed by reference.

As we can see, they say clearly that the function may return false without setting the error number or message. This is generally because an initialization failed. They just don’t tell you what failed… and no error in the error logs either. Nothing.

So this is a difficult one to debug since you could have all sorts of reasons why that call fails the initialization.

Maybe you have an invalid $context parameter.

It could be that you need to specify where the SSL certificate are found on your computer (really that should be automatic…)

Or in my case, it was the protocol used that was not supported on the platform where PHP eFax was installed. That platform (RedHat EL7) did not understand the «tls://» protocol. Instead, it wanted to see «ssl://». Oh well! Talk about walking in the fog.

Some people also reported having problems because a certificate was missing.

Either way, if you have such an error, you’ll have to test everything… until it works. Since there is no real feedback, you won’t be able to do much else. Someone mentioned the possibility to use a trace and see where the error occurs, but I have not tested that. (I’m not too sure how you can do that and I don’t see how that could work since the stream function is in C, not a PHP class.)

As mentioned in a comment, you may also want to check your firewall. Obviously, if you block the port or IP address, it won’t work as expected. The nc tool may help you to verify that you can connect to whatever you are trying to connect to.

If you ran in the same situation and found yet a different solution to fix the problem, please comment below with your solution to help others with this one! Thank you.

 

PHP 5, PHP 7, PHP 8

stream_socket_client — Open Internet or Unix domain socket connection

stream_socket_client(
     string$address,
     [interror_code = null],
     [stringerror_message = null],
     [float|null$timeout = null],
     [int$flags = STREAM_CLIENT_CONNECT],
     [resource|null$context = null]
): resource|false

Parameters

Return Values

On success a stream resource is returned which may
be used together with the other file functions (such as
fgets, fgetss,
fwrite, fclose, and
feof), false on failure.

Exceptions and Errors

On failure the error_code and
error_message arguments will be populated with the actual
system level error that occurred in the system-level
connect() call. If the value returned in
error_code is 0 and the
function returned false, it is an indication that the error
occurred before the connect() call. This is
most likely due to a problem initializing the socket. Note that
the error_code and
error_message arguments will always be passed by
reference.

Notes

Changelog

Related Functions

Example of stream_socket_client

Show all examples
for stream_socket_client