Merge branch '6.8' into 'master'

ezecosystem · Feb 9, 2017 · 1bdad65 · 1bdad65
2 parents f89c03b + 7f2cea2
commit 1bdad65
Show file tree

Hide file tree

Showing 33 changed files with 81 additions and 0 deletions.
diff --git a/doc/bc/changes-6.8.md b/doc/bc/changes-6.8.md
@@ -0,0 +1,13 @@
+# Backwards compatibility changes
+
+Changes affecting version compatibility with former or future versions.
+
+## Changes
+
+## Deprecations
+
+* Most HTTP cache related elements from the kernel are deprecated in favour of the ezsystems/ezplatform-http-cache package
+
+  This mostly includes the contents of the eZ/Publish/Core/MVC/Symfony/Cache/Http directory.
+  Nothing is removed from this version and deprecation messages will not be logged.
+  When installed and enabled, the newly introduced package will replace the services from the kernel with its own.
diff --git a/eZ/Bundle/EzPublishCoreBundle/Cache/Http/VarnishProxyClientFactory.php b/eZ/Bundle/EzPublishCoreBundle/Cache/Http/VarnishProxyClientFactory.php
@@ -13,6 +13,8 @@
 
 /**
  * Factory for Varnish proxy client.
+ *
+ * @deprecated since 6.8. Use the VarnishProxyClientFactory from the platform-http-cache package.
  */
 class VarnishProxyClientFactory
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/GatewayCachePurger.php b/eZ/Publish/Core/MVC/Symfony/Cache/GatewayCachePurger.php
@@ -10,6 +10,8 @@
 
 /**
  * Interface for gateway cache purgers, i.e. Http cache purgers.
+ *
+ * @deprecated Since 6.8, use PurgeClientInterface directly.
  */
 interface GatewayCachePurger
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/ContentPurger.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/ContentPurger.php
@@ -12,6 +12,8 @@
  * Interface allowing for HttpCache stores to purge specific content.
  * When purging content by locationId, purgeByRequest() would receive a Request object with X-Location-Id or X-Group-Location-Id headers
  * indicating which locations to purge.
+ *
+ * @deprecates since 6.8. The interface should not be necessary anymore.
  */
 interface ContentPurger extends RequestAwarePurger
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/EventListener/AssignedLocationsListener.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/EventListener/AssignedLocationsListener.php
@@ -15,6 +15,8 @@
 
 /**
  * Adds content's assigned locations to the cache-clear list.
+ *
+ * @deprecated since 6.8. Smart cache is replaced by http-cache multi-tagging from the platform-http-cache package.
  */
 class AssignedLocationsListener implements EventSubscriberInterface
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/EventListener/ParentLocationsListener.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/EventListener/ParentLocationsListener.php
@@ -16,6 +16,8 @@
 /**
  * Adds parent locations to the Http cache clear list, for given content.
  * Will consider direct parent for all content's locations.
+ *
+ * @deprecated since 6.8. Smart cache is replaced by http-cache multi-tagging from the platform-http-cache package.
  */
 class ParentLocationsListener implements EventSubscriberInterface
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/EventListener/RelatedLocationsListener.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/EventListener/RelatedLocationsListener.php
@@ -16,6 +16,8 @@
 /**
  * Adds locations from related content to the Http cache clear list, for given content.
  * Both relation and reverse relation are taken into account.
+ *
+ * @deprecated since 6.8. Smart cache is replaced by http-cache multi-tagging from the platform-http-cache package.
  */
 class RelatedLocationsListener implements EventSubscriberInterface
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/FOSPurgeClient.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/FOSPurgeClient.php
@@ -16,6 +16,8 @@
  *
  * Only support BAN requests on purpose, to be able to invalidate cache for a
  * collection of Location/Content objects.
+ *
+ * @deprecated since 6.8. Use FOSPurgeClient from the PlatformHttpCache package.
  */
 class FOSPurgeClient implements PurgeClientInterface
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/InstantCachePurger.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/InstantCachePurger.php
@@ -15,6 +15,11 @@
 use eZ\Publish\Core\MVC\Symfony\MVCEvents;
 use Symfony\Component\EventDispatcher\EventDispatcherInterface;
 
+/**
+ * Class InstantCachePurger.
+ *
+ * @deprecated since 6.8 will be removed in 7.0, use PurgeClient directly.
+ */
 class InstantCachePurger implements GatewayCachePurger
 {
     /**

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/LocalPurgeClient.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/LocalPurgeClient.php
@@ -14,6 +14,8 @@
 /**
  * LocalPurgeClient emulates an Http PURGE request received by the cache store.
  * Handy for mono-server.
+ *
+ * @deprecated since 6.8. Use LocalPurgeClient from the platform-http-cache package.
  */
 class LocalPurgeClient implements PurgeClientInterface
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/LocationAwareStore.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/LocationAwareStore.php
@@ -16,6 +16,8 @@
 
 /**
  * LocationAwareStore implements all the logic for storing cache metadata regarding locations.
+ *
+ * @deprecated since 6.8. Replaced by TagAwareStore from the http-cache multi-tagging package.
  */
 class LocationAwareStore extends Store implements ContentPurger
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/RequestAwarePurger.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/RequestAwarePurger.php
@@ -12,6 +12,8 @@
 
 /**
  * Interface allowing implementor (cache Store) to purge Http cache from a request object.
+ *
+ * @deprecated since 6.8. Use RequestAwarePurger from the platform-http-cache package.
  */
 interface RequestAwarePurger
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/AssignSectionSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/AssignSectionSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling AssignSectionSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class AssignSectionSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/AssignUserToUserGroupSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/AssignUserToUserGroupSlot.php
@@ -14,6 +14,8 @@
  * A slot handling AssignUserToUserGroupSignal.
  *
  * @todo This might be incomplete: what about the user's own http cache (user hash) ?
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class AssignUserToUserGroupSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/CopyContentSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/CopyContentSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling CopyContentSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class CopyContentSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/CreateLocationSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/CreateLocationSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling CreateLocationSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class CreateLocationSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/DeleteContentSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/DeleteContentSlot.php
@@ -14,6 +14,8 @@
  * A slot handling DeleteContentSignal.
  *
  * @todo Change to clear precise cache items on content deletion (implies changes to how this signal is used and emitted).
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class DeleteContentSlot extends PurgeAllHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/DeleteLocationSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/DeleteLocationSlot.php
@@ -13,6 +13,8 @@
 
 /**
  * A slot handling DeleteLocationSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class DeleteLocationSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/DeleteVersionSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/DeleteVersionSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling DeleteVersionSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class DeleteVersionSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/HideLocationSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/HideLocationSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling HideLocationSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class HideLocationSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/HttpCacheSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/HttpCacheSlot.php
@@ -14,6 +14,8 @@
 
 /**
  * A abstract legacy slot covering common functions needed for legacy slots.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 abstract class HttpCacheSlot extends Slot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/MoveSubtreeSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/MoveSubtreeSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling MoveSubtreeSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class MoveSubtreeSlot extends PurgeAllHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/PublishVersionSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/PublishVersionSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling PublishVersionSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class PublishVersionSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/PurgeForContentHttpCacheSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/PurgeForContentHttpCacheSlot.php
@@ -15,6 +15,8 @@
  *
  * Will by default use the contentId property of the signal object, as it is the most common. Override the
  * extractContentId() method in your own signal to use a different property.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 abstract class PurgeForContentHttpCacheSlot extends HttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/RecoverSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/RecoverSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling RecoverSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class RecoverSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/SetContentStateSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/SetContentStateSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling SetContentStateSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class SetContentStateSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/SwapLocationSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/SwapLocationSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling SwapLocationSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class SwapLocationSlot extends HttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/TrashSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/TrashSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling TrashSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class TrashSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UnassignUserFromUserGroupSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UnassignUserFromUserGroupSlot.php
@@ -17,6 +17,8 @@
  * Is this right ? Does it require a full wipe of the cache ? Very unlikely.
  * The User's Content's HTTP cache must be cleared, yes.
  * And the user must be logged out, or its user hash cleared (not sure we can without clearing for all users)
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class UnassignUserFromUserGroupSlot extends PurgeAllHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UnhideLocationSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UnhideLocationSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling UnhideLocationSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class UnhideLocationSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UpdateLocationSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UpdateLocationSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling UpdateLocationSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class UpdateLocationSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UpdateUserSlot.php b/eZ/Publish/Core/MVC/Symfony/Cache/Http/SignalSlot/UpdateUserSlot.php
@@ -12,6 +12,8 @@
 
 /**
  * A slot handling UpdateUserSignal.
+ *
+ * @deprecated since 6.8. The platform-http-cache package defines slots for http-cache multi-tagging.
  */
 class UpdateUserSlot extends PurgeForContentHttpCacheSlot
 {

diff --git a/eZ/Publish/Core/MVC/Symfony/Cache/PurgeClientInterface.php b/eZ/Publish/Core/MVC/Symfony/Cache/PurgeClientInterface.php
@@ -8,6 +8,9 @@
  */
 namespace eZ\Publish\Core\MVC\Symfony\Cache;
 
+/**
+ * @deprecated since 6.8. Use PurgeClientInterface from the platform-http-cache package.
+ */
 interface PurgeClientInterface
 {
     /**