CHANGELOG 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. v0.6.1 (2010-xx-xx)
  2. * Minor internal improvements and clean ups.
  3. * Predis\MultiExecBlock and Predis\PubSubContext will throw an exception
  4. when trying to create their instances when using a profile that does
  5. not support the required Redis commands.
  6. * Various improvements to Predis\MultiExecBlock:
  7. - fixes and more consistent behaviour across various usage cases.
  8. - support for WATCH and UNWATCH when using the current development
  9. profile (Redis v2.2) and aborted transactions.
  10. * New method signature for Predis\Client::multiExec(). Now it is able to
  11. accept an array of options for the underlying Predis\MultiExecBlock, but
  12. it is still backwards compatible with previous releases of Predis.
  13. v0.6.0 (2010-05-24)
  14. * Switched to the new multi-bulk request protocol for all of the commands
  15. in the Redis 1.2 and Redis 2.0 profiles. Inline and bulk requests are now
  16. deprecated as they will be removed in future releases of Redis.
  17. * The default server profile is "2.0" (targeting Redis 2.0.x). If you are
  18. using older versions of Redis, it is highly recommended that you specify
  19. which server profile the client should use (e.g. "1.2" when connecting
  20. to instances of Redis 1.2.x).
  21. * Support for Redis 1.0 is now optional and it is provided by requiring
  22. 'Predis_Compatibility.php' before creating an instance of Predis\Client.
  23. * New commands added to the Redis 2.0 profile since Predis 0.5.1:
  24. - Strings: SETEX, APPEND, SUBSTR
  25. - ZSets : ZCOUNT, ZRANK, ZUNIONSTORE, ZINTERSTORE, ZREMBYRANK, ZREVRANK
  26. - Hashes : HSET, HSETNX, HMSET, HINCRBY, HGET, HMGET, HDEL, HEXISTS,
  27. HLEN, HKEYS, HVALS, HGETALL
  28. - PubSub : PUBLISH, SUBSCRIBE, UNSUBSCRIBE
  29. - Misc. : DISCARD, CONFIG
  30. * Introduced client-level options with the new Predis\ClientOptions class.
  31. Options can be passed to Predis\Client::__construct in its second argument
  32. as an array or an instance of Predis\ClientOptions. For brevity's sake and
  33. compatibility with older versions, the constructor of Predis\Client still
  34. accepts an instance of Predis\RedisServerProfile in its second argument.
  35. The currently supported client options are:
  36. - profile [default: "2.0" as of Predis 0.6.0]
  37. specifies which server profile to use when connecting to Redis. This
  38. option accepts an instance of Predis\RedisServerProfile or a string
  39. that indicates the target version.
  40. - key_distribution [default: Predis\Distribution\HashRing]
  41. specifies which key distribution strategy to use to distribute keys
  42. among the servers that compose a cluster. This option accepts an
  43. instance of Predis\Distribution\IDistributionStrategy so that users
  44. can implement their own key distribution strategy. Optionally, the new
  45. Predis\Distribution\KetamaPureRing class also provides a pure-PHP
  46. implementation of the same algorithm used by libketama.
  47. - throw_on_error [default: TRUE]
  48. server errors can optionally be handled "silently": instead of throwing
  49. an exception, the client returns an error response type.
  50. - iterable_multibulk [EXPERIMENTAL - default: FALSE]
  51. in addition to the classic way of fetching a whole multibulk reply
  52. into an array, the client can now optionally stream a multibulk reply
  53. down to the user code by using PHP iterators. It is just a little bit
  54. slower, but it can save a lot of memory in certain scenarios.
  55. * New parameters for connections:
  56. - alias [default: not set]
  57. every connection can now be identified by an alias that is useful to
  58. get a certain connection when connected to a cluster of Redis servers.
  59. - weight [default: not set]
  60. allows the client to balance the keys asymmetrically across multiple
  61. servers. This might be useful when you have servers with different
  62. amounts of memory and you want to distribute the load of your keys
  63. accordingly.
  64. - connection_async [default: FALSE]
  65. estabilish connections to servers in a non-blocking way, so that the
  66. client is not blocked while the underlying resource performs the actual
  67. connection.
  68. - connection_persistent [default: FALSE]
  69. the underlying connection resource is left open when a script ends its
  70. lifecycle. Persistent connections can lead to unpredictable or strange
  71. behaviours, so they should be used with extreme care.
  72. * Introduced the Predis\Pipeline\IPipelineExecutor interface. Classes that
  73. implements this interface are used internally by the Predis\CommandPipeline
  74. class to change the behaviour of the pipeline when writing/reading commands
  75. from one or multiple servers. Here is the list of the default executors:
  76. - Predis\Pipeline\StandardExecutor
  77. Exceptions generated by server errors might be thrown depending on the
  78. options passed to the client (see "throw_on_error"). Instead, protocol
  79. or network errors always throw exceptions. This is the default executor
  80. for single and clustered connections and shares the same behaviour of
  81. Predis 0.5.x.
  82. - Predis\Pipeline\SafeExecutor
  83. Exceptions generated by server, protocol or network errors are not
  84. thrown, instead they are returned in the response array as instances of
  85. ResponseError or CommunicationException.
  86. - Predis\Pipeline\SafeClusterExecutor
  87. This executor shares the same behaviour of Predis\Pipeline\SafeExecutor
  88. but it is geared towards clustered connections.
  89. * Support for PUBSUB is handled by the new Predis\PubSubContext class, which
  90. could also be used to build a callback dispatcher for PUBSUB scenarios.
  91. * When connected to a cluster of connections, it is now possible to get a
  92. new Predis\Client instance for a single connection of the cluster by
  93. passing its alias/index to the new Predis\Client::getClientFor() method.
  94. * CommandPipeline and MultiExecBlock return their instances when invoking
  95. commands, thus allowing method chaining in pipelines and multi-exec blocks.
  96. * MultiExecBlock instances can handle the new DISCARD command.
  97. * Connections now support float values for the connection_timeout parameter
  98. to express timeouts with a microsecond resolution.
  99. * FIX: TCP connections now respect the read/write timeout parameter when
  100. reading the payload of server responses. Previously, stream_get_contents()
  101. was being used internally to read data from a connection but it looks like
  102. PHP does not honour the specified timeout for socket streams when inside
  103. this function.
  104. * FIX: The GET parameter for the SORT command now accepts also multiple key
  105. patterns by passing an array of strings. (ISSUE #1).
  106. * FIX: Replies to the DEL command return the number of elements deleted by
  107. the server and not 0 or 1 interpreted as a boolean response. (ISSUE #4).
  108. v0.5.1 (2010-01-23)
  109. * RPOPLPUSH has been changed from bulk command to inline command in Redis
  110. 1.2.1, so ListPopLastPushHead now extends InlineCommand. The old RPOPLPUSH
  111. behavior is still available via the ListPopLastPushHeadBulk class so that
  112. you can override the server profile if you need the old (and uncorrect)
  113. behaviour when connecting to a Redis 1.2.0 instance.
  114. * Added missing support for BGREWRITEAOF for Redis >= 1.2.0
  115. * Implemented a factory method for the RedisServerProfile class to ease the
  116. creation of new server profile instances based on a version string.
  117. v0.5.0 (2010-01-09)
  118. * First versioned release of Predis