annotate vendor/doctrine/common/UPGRADE_TO_2_2 @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 4c8ae668cc8c
children
rev   line source
Chris@0 1 This document details all the possible changes that you should investigate when
Chris@0 2 updating your project from Doctrine Common 2.1 to 2.2:
Chris@0 3
Chris@0 4 ## Annotation Changes
Chris@0 5
Chris@0 6 - AnnotationReader::setIgnoreNotImportedAnnotations has been removed, you need to
Chris@0 7 add ignore annotation names which are supposed to be ignored via
Chris@0 8 AnnotationReader::addGlobalIgnoredName
Chris@0 9
Chris@0 10 - AnnotationReader::setAutoloadAnnotations was deprecated by the AnnotationRegistry
Chris@0 11 in 2.1 and has been removed in 2.2
Chris@0 12
Chris@0 13 - AnnotationReader::setEnableParsePhpImports was added to ease transition to the new
Chris@0 14 annotation mechanism in 2.1 and is removed in 2.2
Chris@0 15
Chris@0 16 - AnnotationReader::isParsePhpImportsEnabled is removed (see above)
Chris@0 17
Chris@0 18 - AnnotationReader::setDefaultAnnotationNamespace was deprecated in favor of explicit
Chris@0 19 configuration in 2.1 and will be removed in 2.2 (for isolated projects where you
Chris@0 20 have full-control over _all_ available annotations, we offer a dedicated reader
Chris@0 21 class ``SimpleAnnotationReader``)
Chris@0 22
Chris@0 23 - AnnotationReader::setAnnotationCreationFunction was deprecated in 2.1 and will be
Chris@0 24 removed in 2.2. We only offer two creation mechanisms which cannot be changed
Chris@0 25 anymore to allow the same reader instance to work with all annotations regardless
Chris@0 26 of which library they are coming from.
Chris@0 27
Chris@0 28 - AnnotationReader::setAnnotationNamespaceAlias was deprecated in 2.1 and will be
Chris@0 29 removed in 2.2 (see setDefaultAnnotationNamespace)
Chris@0 30
Chris@0 31 - If you use a class as annotation which has not the @Annotation marker in it's
Chris@0 32 class block, we will now throw an exception instead of silently ignoring it. You
Chris@0 33 can however still achieve the previous behavior using the @IgnoreAnnotation, or
Chris@0 34 AnnotationReader::addGlobalIgnoredName (the exception message will contain detailed
Chris@0 35 instructions when you run into this problem).
Chris@0 36
Chris@0 37 ## Cache Changes
Chris@0 38
Chris@0 39 - Renamed old AbstractCache to CacheProvider
Chris@0 40
Chris@0 41 - Dropped the support to the following functions of all cache providers:
Chris@0 42
Chris@0 43 - CacheProvider::deleteByWildcard
Chris@0 44
Chris@0 45 - CacheProvider::deleteByRegEx
Chris@0 46
Chris@0 47 - CacheProvider::deleteByPrefix
Chris@0 48
Chris@0 49 - CacheProvider::deleteBySuffix
Chris@0 50
Chris@0 51 - CacheProvider::deleteAll will not remove ALL entries, it will only mark them as invalid
Chris@0 52
Chris@0 53 - CacheProvider::flushAll will remove ALL entries, namespaced or not
Chris@0 54
Chris@0 55 - Added support to MemcachedCache
Chris@0 56
Chris@0 57 - Added support to WincacheCache
Chris@0 58
Chris@0 59 ## ClassLoader Changes
Chris@0 60
Chris@0 61 - ClassLoader::fileExistsInIncludePath() no longer exists. Use the native stream_resolve_include_path() PHP function