Memcached Memcached::addServer
(PECL memcached >= 0.1.0)
Memcached::addServer — 서버 풀에 서버 추가
설명
public Memcached::addServer(string $host
, int $port
, int $weight
= 0): bool
Memcached::addServer()는 지정된 서버를 서버 풀에 추가합니다. 현재 서버에 대한 연결이 설정되지 않았지만 일관된 키 배포 옵션(Memcached::DISTRIBUTION_CONSISTENT
또는 Memcached::OPT_LIBKETAMA_COMPATIBLE
을 통해)을 사용하는 경우 일부 내부 데이터 구조를 업데이트해야 합니다. 따라서 여러 서버를 추가해야 하는 경우 업데이트가 한 번만 발생하므로 Memcached::addServers()를 사용하는 것이 좋습니다.
중복 검사가 수행되지 않기 때문에 동일한 서버가 서버 풀에 여러 번 나타날 수 있습니다. 이것은 바람직하지 않습니다. 대신 weight
옵션을 사용하여 이 서버의 선택 가중치를 높이십시오.
매개변수
host
- Memcache 서버의 호스트 이름입니다. 호스트 이름이 잘못된 경우 데이터 관련 작업은
Memcached::RES_HOST_LOOKUP_FAILURE
결과 코드를 설정합니다. 버전 2.0.0b1부터 이 매개변수는 유닉스 소켓 파일 경로 ex./path/to/memcached.sock
에서 UNIX 도메인 소켓을 사용하려면 이 경우port
도0
으로 설정해야 합니다. port
- Memcache가 실행 중인 포트입니다. 일반적으로
11211
입니다. 버전 2.0.0b1부터 UNIX 도메인 소켓을 사용할 때 이 매개변수를0
으로 설정합니다. weight
- 풀에 있는 모든 서버의 총 무게에 대한 서버의 무게입니다. 이것은 작업을 위해 서버가 선택될 확률을 제어합니다. 이는 일관된 배포 옵션에서만 사용되며 일반적으로 해당 서버의 memcache에 사용 가능한 메모리 양에 해당합니다.
반환 값
성공하면 true
를, 실패하면 false
를 반환합니다.
Examples
예제 #1 Memcached::addServer() 예제
<?php
$m = new Memcached();
/* Add 2 servers, so that the second one
is twice as likely to be selected. */
$m->addServer('mem1.domain.com', 11211, 33);
$m->addServer('mem2.domain.com', 11211, 67);
?>
기타
- Memcached::addServers() - 서버 풀에 여러 서버 추가
- Memcached::resetServerList() - 서버 목록에서 모든 서버를 지웁니다.