-
Notifications
You must be signed in to change notification settings - Fork 56
Add documention on http client pool #134
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
Maybe we could add a paragraph about the different use cases between HttpClientPool and the BachClient? |
b35bbeb
to
038eafe
Compare
Using this kind of client is useful is some use cases : | ||
|
||
- When using a cluster (like a Elasticsearch service with multiple master nodes) | ||
- When you want to use fallback servers with the combination of the ``RetryPlugin`` (see :doc:`/plugins/retry`) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lets move the reason why you need this to the top of this section. before reading a code example, readers want to know why they should care or if its relevant for them.
I don't see how they are related ? |
d586710
to
69930d3
Compare
and this looks good to me as well! |
|
||
Clients added to the pool are decorated with the ``HttpClientPoolItem`` class unless they already are an instance of this class. | ||
|
||
The pool item class lets the pool be aware of the number of requests currently being processed by that client. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Merge this paragraph with the paragraph above. We are still talking about the pool item class.
Good. I just had some minor comments. |
69930d3
to
c48aa85
Compare
cheers joel! |
Doc for php-http/client-common#25