php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

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 Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
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

Pull Requests

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-2025 The PHP Group
All rights reserved. 		Last updated: Tue Jul 15 20:01:35 2025 UTC