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: 2021-03-25 16:49 UTC
From: teo8976 at gmail dot com Assigned: cmb (profile)
Status: Closed Package: memcache (PECL)
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Add Comment Developer Edit
Anyone can comment on a bug. Have a simpler test case? Does it work for you on a different platform? Let us know!
Just going to say 'Me too!'? Don't clutter the database with that please !
Your email address:
MUST BE VALID
Solve the problem:
44 - 20 = ?
Subscribe to this entry?

 
 [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
 [2021-03-25 16:49 UTC] cmb@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: cmb
 [2021-03-25 16:49 UTC] cmb@php.net
The official bug tracker for PECL/memcache is now at
<https://github.com/websupport-sk/pecl-memcache/issues>.

So, if this is still an issue with either of the current memcache
versions (4 or 8), please file an issue there.
 
PHP Copyright © 2001-2021 The PHP Group
All rights reserved.
Last updated: Thu Jul 29 02:01:22 2021 UTC