php-http / socket-client

Socket HTTP Client

Socket Client for PHP HTTP

The socket client use the stream extension from PHP, which is integrated into the core.

Features

• TCP Socket Domain (tcp://hostname:port)
• UNIX Socket Domain (unix:///path/to/socket.sock)
• TLS / SSL Encyrption
• Client Certificate (only for php > 5.6)

Installation and Usage

Read the documentation at http://docs.php-http.org/en/latest/clients/socket-client.html

Testing

First launch the http server:

$ ./vendor/bin/http_test_server > /dev/null 2>&1 &

Then generate ssh certificates:

$ composer gen-ssl

Note: If you are running this on macOS and get the following error: "Error opening CA Private Key privkey.pem", check this file.

Now run the test suite:

$ composer test

Contributing

Please see our contributing guide.

Security

If you discover any security related issues, please contact us at [email protected].

License

The MIT License (MIT). Please see License File for more information.

socket-client's Issues

Allow nullable MessageFactory

Have the same thing as the Guzzle5 Adapter

Stream::__toString() must not thrown an exception

From @shaneiseminger

Method Http\Client\Socket\Stream::__toString() must not throw an exception

When using this library with happyr/linkedin-api-client, I'm getting the above fatal error. Just needs a try/catch block in __toString(). Happy to submit a pull request.

(Originally posted here: php-http/documentation#135)

Invalid StreamInterface::read implementation

When I call Http\Client\Socket\Stream::read($length) method with a $length value greater than the stream size, an StreamException is thrown with the message "Cannot read more than %s"(also a sprintf call is missed here).

But the StreamInterface::read documentation describes that it can returns fewer than $length bytes, so the Http\Client\Socket\Stream::read must return the remaining stream content up to $length bytes instead of throwing an exception.

Init of socket-adapter

It is possible to init the repository so i can work on a fork ?

I have already do some stuff here : https://github.com/joelwurtz/socket-adapter-temp but would be better for review if we have a WIP PR

Edit : Nevermind this issue, i didn't see the response on the other project ^^ (damn you browser cache ^^)

Root Namespace

Actually the root namespace is Http\Socket

Should this be renamed to Http\Client\Socket ?
Also SocketHttpClient can be renamed to SocketClient ?

Timeout exceeded cause php fatal/throwable error

This commit have been broken behavior when request timeout exceeded. When this code evaluated, we'll get fatal/throwable error like this:

Wrong parameters for Http\Client\Socket\Exception\TimeoutException([string $message [, long $code [, Throwable $previous = NULL]]]) (uncaught exception) at /vendor/php-http/socket-client/src/ResponseReader.php line 51 while running console command 
#0 /vendor/php-http/socket-client/src/ResponseReader.php(51): Exception->__construct('Error while rea...', Object(GuzzleHttp\Psr7\Request))

This error happens cause current TimeoutException extendw default php \RuntimeException, although previous NetworkException use RuntimeException, which has different controller and arguments (second argument is request object)

Incorrect 2nd parameter for exceptions

Wrong parameters for Http\Client\Socket\Exception\TimeoutException([string $message [, long $code [, Throwable $previous = NULL]]])" {"exception":"[object] (Error(code: 0): Wrong parameters for Http\\Client\\Socket\\Exception\\TimeoutException([string $message [, long $code [, Throwable $previous = NULL]]]) at php-http/socket-client/src/ResponseReader.php:51

I found a problem in the 2nd parameter for thrown exception. There passing RequestInterface object and not exception code.

Fix broken master

The master build is currently broken.

https://travis-ci.org/php-http/socket-client/builds/153827605

"Too many open files" error triggered after sending 1000 requests.

Hello,

I tried to use the socket-client to upload some data on a server. I've a basic implementation which create a client and inside a foreach loop, I make the upload requests using the Guzzle PSR7 message factory.

foreach ($iterator as $splfileinfo) {
    $response = $this->httpClient()->sendRequest(
        $request = $this->requestFactory()->createRequest(
            'POST',
            $sendUrl,
            $headers,
            $splFileInfo->openFile('r')
        )
    );
}

After 1007 successful requests, I got the Too many open files error and it seems that's the number of opened socket by the client. Is it normal that the socket connexion is never closed after the request is successfully sent (maybe I miss something 😄) ?

NetworkException usage is too ambiguous

NetworkException is used in many places without any specific exception codes. This leaves downstream user code that handles the exceptions in a position where they are must do exception message parsing if they want granular exception handling. These exceptions should have codes or even better be named exceptions that extend NetworkException.

Not installable with a Symfony 6 project

PHP version: 8.0+

Description
This library requires symfony/options-resolver on version 5.* or below, but Symfony 6.0 has been released 1 month ago.

How to reproduce
Use this library with a project build on Symfony 6.0

Possible Solution
Update composer.json to support also symfony/options-resolver with the version 6.0

Move documentation to documentation

Eventually (when the current docs is updated with httplug content) documentation should go right into the official docs.

Keep a changelog

Support PSR-18

This will drop PHP5 and force us to release a new major version.

Socket adapter Init

Apart from some dependencies issues, the socket client is nearly done (we can always add thing, but it is ok for a first version IMO)

It's available here: https://github.com/joelwurtz/socket-adapter-temp

How do you want to proceed for review ? merging it here ?

Change the name to socket client

This is not really an adapter, but a client.

WDYT @joelwurtz ?

Remove repositories from composer.json

Add PHP 8 support

Description
PHP 8.0.0 has been launched for a month already, PHP 8.0.1-RC1 is already tagged and the library still does not support it.

Example
It is not really a feature by itself, but it's about supporting the latest language version.

Additional context
I'm working on a PR for this :)

HTTP2 Support

I believe there is now enough support in php and libraries to do that "easily"

• Negotiate protocols with alpn_protocols option of tls context (added in php 7.0)
• Headers compression by using https://github.com/amphp/hpack

Biggest problem is on the API, as a request can receive multiple reponses, it will certainly need a decorator around a PSR7 Response (A specific stream implementation) / decorator)

Tag New Release?

apologies, i was looking at releases wrong.

How to do a POST request using this socket-client library ?

All the examples in test are only for GET method. When I tried doing a POST request without any data it succeeded, but if I add data in form of String or PHP array, it throws a NetworkException exception saying, 'Cannot read the response'

Fatal Compile Error: Declaration of Http\Client\Socket\Stream::close() must be compatible

Fatal Compile Error: Declaration of Http\Client\Socket\Stream::close()
must be compatible with Psr\Http\Message\StreamInterface::close(): void

$ composer show php-http/socket-client | grep version
versions : * 2.1.1
$ composer show psr/http-message | grep version
versions : * 2.0

Tag version 2.0.0

Description
PSR-18 support has been added two years ago in #38, but there is no tag for version 2.0.0 (stable) - only for 2.0.0-beta1

It would be nice if the package got an official stable 2.0.0 release with PSR-18 support.