Document GET_EXTENDED flag. Add/rename other missing/misnamed constants. (#335)

memcached-api.php

@@ -10,13 +10,13 @@ class Memcached {
 	 */
 
 	const OPT_HASH;
-	
-	const OPT_HASH_DEFAULT;
+
+	const HASH_DEFAULT;
 
 	const HASH_MD5;
 
 	const HASH_CRC;
-	
+
 	const HASH_FNV1_64;
 
 	const HASH_FNV1A_64;
@@ -34,12 +34,16 @@ class Memcached {
 	const DISTRIBUTION_MODULA;
 
 	const DISTRIBUTION_CONSISTENT;
-	
+
 	const DISTRIBUTION_VIRTUAL_BUCKET;
 
-	const LIBKETAMA_COMPATIBLE;
+	const OPT_LIBKETAMA_COMPATIBLE;
 
-	const OPT_BUFFER_REQUESTS;
+	const OPT_LIBKETAMA_HASH;
+
+	const OPT_TCP_KEEPALIVE;
+
+	const OPT_BUFFER_WRITES;
 
 	const OPT_BINARY_PROTOCOL;
 
@@ -57,9 +61,9 @@ class Memcached {
 
 	const OPT_DEAD_TIMEOUT;
 
-	const OPT_SND_TIMEOUT;
+	const OPT_SEND_TIMEOUT;
 
-	const OPT_RCV_TIMEOUT;
+	const OPT_RECV_TIMEOUT;
 
 	const OPT_POLL_TIMEOUT;
 
@@ -71,22 +75,34 @@ class Memcached {
 
 	const OPT_AUTO_EJECT_HOSTS;
 
-	const OPT_NUMBER_OF_REPLICAS;
-
 	const OPT_NOREPLY;
 
 	const OPT_VERIFY_KEY;
-	
+
+	const OPT_USE_UDP;
+
+	const OPT_NUMBER_OF_REPLICAS;
+
 	const OPT_RANDOMIZE_REPLICA_READS;
 
+	const OPT_REMOVE_FAILED_SERVERS;
 
 	/**
-	 * Class parameters
+	 * Supported serializers
 	 */
 	const HAVE_JSON;
 
 	const HAVE_IGBINARY;
 
+	const HAVE_MSGPACK;
+
+	/**
+	 * Feature support
+	 */
+	const HAVE_SESSION;
+
+	const HAVE_SASL;
+
 	/**
 	 * Class options.
 	 */
@@ -107,18 +123,24 @@ class Memcached {
 
 	const SERIALIZER_JSON_ARRAY;
 
+	const SERIALIZER_MSGPACK;
+
 	/**
 	 * Compression types
 	 */
-	const COMPRESSION_TYPE_FASTLZ;
+	const COMPRESSION_FASTLZ;
 
-	const COMPRESSION_TYPE_ZLIB;
+	const COMPRESSION_ZLIB;
 
 	/**
-	 * Flags
+	 * Flags for get and getMulti operations.
 	 */
+	// Whether to preserve key order in the result
 	const GET_PRESERVE_ORDER;
 
+	// Whether to fetch CAS token as well (use "gets").
+	const GET_EXTENDED;
+
 	/**
 	 * Return values
 	 */
@@ -186,9 +208,57 @@ class Memcached {
 
 	const RES_CONNECTION_SOCKET_CREATE_FAILURE;
 
+	const RES_E2BIG;
+
+	const RES_KEY_TOO_BIG;
+
+	const RES_SERVER_TEMPORARILY_DISABLED;
+
+	const RES_SERVER_MEMORY_ALLOCATION_FAILURE;
+
+	const RES_AUTH_PROBLEM;
+
+	const RES_AUTH_FAILURE;
+
+	const RES_AUTH_CONTINUE;
+
+    /** Server callbacks, if compiled with --memcached-protocol */
+	const ON_CONNECT;
+	const ON_ADD;
+	const ON_APPEND;
+	const ON_DECREMENT;
+	const ON_DELETE;
+	const ON_FLUSH;
+	const ON_GET;
+	const ON_INCREMENT;
+	const ON_NOOP;
+	const ON_PREPEND;
+	const ON_QUIT;
+	const ON_REPLACE;
+	const ON_SET;
+	const ON_STAT;
+	const ON_VERSION;
+    /** Constants used when compiled with --memcached-protocol */
+	const RESPONSE_SUCCESS;
+	const RESPONSE_KEY_ENOENT;
+	const RESPONSE_KEY_EEXISTS;
+	const RESPONSE_E2BIG;
+	const RESPONSE_EINVAL;
+	const RESPONSE_NOT_STORED;
+	const RESPONSE_DELTA_BADVAL;
+	const RESPONSE_NOT_MY_VBUCKET;
+	const RESPONSE_AUTH_ERROR;
+	const RESPONSE_AUTH_CONTINUE;
+	const RESPONSE_UNKNOWN_COMMAND;
+	const RESPONSE_ENOMEM;
+	const RESPONSE_NOT_SUPPORTED;
+	const RESPONSE_EINTERNAL;
+	const RESPONSE_EBUSY;
+	const RESPONSE_ETMPFAIL;
+
 
 	public function __construct( $persistent_id = '', $on_new_object_cb = null ) {}
-	
+
 	public function get( $key, callable $cache_cb = null, $flags = 0) {}
 
 	public function getByKey( $server_key, $key, callable $cache_cb = null, $flags = 0 ) {}
@@ -202,7 +272,7 @@ class Memcached {
 	public function getDelayedByKey( $server_key, array $keys, $with_cas = null, $value_cb = null ) {}
 
 	public function fetch( ) {}
-	
+
 	public function fetchAll( ) {}
 
 	public function set( $key, $value, $expiration = 0, $udf_flags = 0 ) {}
@@ -250,7 +320,7 @@ class Memcached {
 	public function decrement( $key, $offset = 1, $initial_value = 0, $expiry = 0) {}
 
 	public function getOption( $option ) {}
-	
+
 	public function setOption( $option, $value ) {}
 
 	public function setOptions( array $options ) {}
@@ -280,7 +350,7 @@ class Memcached {
 	public function getStats( $type = null ) {}
 
 	public function getAllKeys( ) {}
-	
+
 	public function getVersion( ) {}
 
 	public function getResultCode( ) {}