php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #75564 Unclear what "failure" is in Memcached::addServer()
Submitted: 2017-11-23 18:29 UTC Modified: 2019-01-02 00:56 UTC
From: teo8976 at gmail dot com Assigned:
Status: Open Package: memcache (PECL)
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
You can add a comment by following this link or if you reported this bug, you can edit this bug over here.
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: teo8976 at gmail dot com
New email:
PHP Version: OS:

 

 [2017-11-23 18:29 UTC] teo8976 at gmail dot com
Description:
------------
---
From manual page: http://www.php.net/memcache.addserver
---

"Returns TRUE on success or FALSE on failure."

That might seem self-explaining, but it is not, because of this:

"When using this method [...] the network connection is not established until actually needed. Thus there is no overhead in adding a large number of servers to the pool, even though they might not all be used."

So, if the connection is not established when calling addServer(), it is unclear what exactly might "fail" and cause this method to return false.
That should be explained.


Patches

Add a Patch

Pull Requests

Add a Pull Request

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2019-01-02 00:56 UTC] girgias@php.net
-Package: Documentation problem +Package: memcache
 
PHP Copyright © 2001-2019 The PHP Group
All rights reserved.
Last updated: Wed Oct 23 15:01:31 2019 UTC