Add release notes about session protocol,get and getMulti changing (#271)

And update the memcached-api.php file for the branch.

Author: TysonAndre

memcached-api.php

@@ -189,13 +189,13 @@ class Memcached {
 
 	public function __construct( $persistent_id = '', $on_new_object_cb = null ) {}
 
-	public function get( $key, $cache_cb = null, &$cas_token = null, &$udf_flags = null ) {}
+	public function get( $key, callable $cache_cb = null, $flags = 0) {}
 
-	public function getByKey( $server_key, $key, $cache_cb = null, &$cas_token = null, &$udf_flags = null ) {}
+	public function getByKey( $server_key, $key, callable $cache_cb = null, $flags = 0 ) {}
 
-	public function getMulti( array $keys, &$cas_tokens = null, $flags = 0, &$udf_flags = null ) {}
+	public function getMulti( array $keys, $flags = 0) {}
 
-	public function getMultiByKey( $server_key, array $keys, &$cas_tokens = null, $flags = 0, &$udf_flags = null ) {}
+	public function getMultiByKey( $server_key, array $keys, $flags = 0) {}
 
 	public function getDelayed( array $keys, $with_cas = null, $value_cb = null ) {}
 

package.xml

@@ -38,8 +38,9 @@ libmemcached. Please note that this is a beta release and reporting any issues w
 before we move closer to releasing stable version.
 
 API
- * get commands do not take cas or user flags parameters.
- * get and getMulti commands take Memcached::GET_EXTENDED flag to retrieve user flags and cas tokens
+ * The method signature of get, getByKey, getMulti, and getMultiByKey changed.
+ * get* and getMulti* commands no longer take cas or user flags parameters.
+ * get* and getMulti* commands now take the Memcached::GET_EXTENDED flag to retrieve user flags and cas tokens.
  * Fixes getStats command to return all stats from all servers
  * Fixes allKeys command behaviour
  * Fixes error where cache callback for get command was not setting expiration time properly
@@ -48,6 +49,7 @@ API
  * CAS tokens are returned as integers and they overflow to strings as needed
 
 Session handler
+ * The session memcached protocol config name was changed, and the default protocol was changed from text to binary protocol. If your memcached setup does not support the binary protocol(e.g. if using twemproxy), then set memcached.sess_binary_protocol = Off. (Previously called memcached.sess_binary)
  * Session lock algorithm updated (new ini-values memcached.sess_lock_wait_min, memcached.sess_lock_wait_max and memcached.sess_lock_retries)
  * Session extension uses PHP allocators (still some work to do on the rest of the extension)
  * Ini-values take effect during session_start or session_regenerate_id