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
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If this is not your bug, you can add a comment by following this link.
If this is your bug, but 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

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-2024 The PHP Group
All rights reserved.
Last updated: Fri Apr 19 14:01:30 2024 UTC