Skip to content

Commit b0724ba

Browse files
fabpotfabpot
committed
minor #54533 Proofread UPGRADE guide (wouterj)
This PR was merged into the 7.1 branch. Discussion ---------- Proofread UPGRADE guide | Q | A | ------------- | --- | Branch? | 7.1 | Bug fix? | no | New feature? | no | Deprecations? | no | Issues | - | License | MIT Feature-freeze is upon us, so here is a new proofread of the UPGRADE guide. It seems like we didn't introduce many deprecations this time. I've scanned all CHANGELOG files to find missing items. Commits ------- 3f7c344 Proofread UPGRADE guide
2 parents 508f316 + 3f7c344 commit b0724ba

File tree

3 files changed

+86
-3
lines changed

3 files changed

+86
-3
lines changed

‎UPGRADE-7.1.md

+84-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,38 @@
11
UPGRADE FROM 7.0 to 7.1
22
=======================
33

4+
Symfony 7.1 is a minor release. According to the Symfony release process, there should be no significant
5+
backward compatibility breaks. Minor backward compatibility breaks are prefixed in this document with
6+
`[BC BREAK]`, make sure your code is compatible with these entries before upgrading.
7+
Read more about this in the [Symfony documentation](https://symfony.com/doc/7.1/setup/upgrade_minor.html).
8+
9+
If you're upgrading from a version below 7.0, follow the [7.0 upgrade guide](UPGRADE-7.0.md) first.
10+
11+
Table of Contents
12+
-----------------
13+
14+
Bundles
15+
16+
* [FrameworkBundle](#FrameworkBundle)
17+
* [SecurityBundle](#SecurityBundle)
18+
* [TwigBundle](#TwigBundle)
19+
20+
Bridges
21+
22+
* [DoctrineBridge](#DoctrineBridge)
23+
24+
Components
25+
26+
* [AssetMapper](#AssetMapper)
27+
* [Cache](#Cache)
28+
* [DependencyInjection](#DependencyInjection)
29+
* [ExpressionLanguage](#ExpressionLanguage)
30+
* [Form](#Form)
31+
* [Intl](#Intl)
32+
* [PropertyInfo](#PropertyInfo)
33+
* [Translation](#Translation)
34+
* [Workflow](#Workflow)
35+
436
AssetMapper
537
-----------
638

@@ -9,7 +41,7 @@ AssetMapper
941
Cache
1042
-----
1143

12-
* Deprecate `CouchbaseBucketAdapter`, use `CouchbaseCollectionAdapter` instead
44+
* Deprecate `CouchbaseBucketAdapter`, use `CouchbaseCollectionAdapter` with Couchbase 3 instead
1345

1446
DependencyInjection
1547
-------------------
@@ -27,14 +59,65 @@ ExpressionLanguage
2759
* Deprecate passing `null` as the allowed variable names to `ExpressionLanguage::lint()` and `Parser::lint()`,
2860
pass the `IGNORE_UNKNOWN_VARIABLES` flag instead to ignore unknown variables during linting
2961

62+
Form
63+
----
64+
65+
* Deprecate not configuring the `default_protocol` option of the `UrlType`, it will default to `null` in 8.0 (the current default is `'http'`)
66+
3067
FrameworkBundle
3168
---------------
3269

3370
* Mark classes `ConfigBuilderCacheWarmer`, `Router`, `SerializerCacheWarmer`, `TranslationsCacheWarmer`, `Translator` and `ValidatorCacheWarmer` as `final`
71+
* Deprecate the `router.cache_dir` config option, the Router will always use the `kernel.build_dir` parameter
72+
73+
Intl
74+
----
75+
76+
* [BC BREAK] Extracted `EmojiTransliterator` to a separate `symfony/emoji` component, the new FQCN is `Symfony\Component\Emoji\EmojiTransliterator`.
77+
You must install the `symfony/emoji` component if you're using the old `EmojiTransliterator` class in the Intl component.
78+
79+
Mailer
80+
------
81+
82+
* Postmark's "406 - Inactive recipient" API error code now results in a `PostmarkDeliveryEvent` instead of throwing a `HttpTransportException`
3483

3584
PropertyInfo
3685
------------
3786

87+
* Deprecate the `Type` class, use `Symfony\Component\TypeInfo\Type` class of `symfony/type-info` component instead
88+
89+
*Before*
90+
```php
91+
use Symfony\Component\PropertyInfo\Type;
92+
93+
// bool
94+
$boolType = new Type(LegacyType::BUILTIN_TYPE_BOOL);
95+
// bool|null
96+
$nullableType = new Type(LegacyType::BUILTIN_TYPE_BOOL, nullable: true);
97+
// array<int, string|null>
98+
$arrayType = new Type(Type::BUILTIN_TYPE_ARRAY, false, null, true, new Type(Type::BUILTIN_TYPE_INT), new Type(Type::BUILTIN_TYPE_STRING, true));
99+
100+
$arrayType->getBuiltinType(); // returns "array"
101+
$arrayType->getCollectionKeyTypes(); // returns an array with an "int" Type instance
102+
$arrayType->getCollectionValueTypes()[0]->isNullable(); // returns true
103+
```
104+
105+
*After*
106+
```php
107+
use Symfony\Component\TypeInfo\Type;
108+
109+
// bool
110+
$boolType = Type::bool();
111+
// bool|null
112+
$nullableType = Type::nullable(Type::bool());
113+
// array<int, string|null>
114+
$arrayType = Type::array(Type::nullable(Type::string()), Type::int());
115+
116+
(string) $arrayType->getBaseType(); // returns "array"
117+
$arrayType->getCollectionKeyType(); // returns an "int" Type instance
118+
$arrayType->getCollectionValueType()->isNullable(); // returns true
119+
```
120+
38121
* Deprecate `PropertyTypeExtractorInterface::getTypes()`, use `PropertyTypeExtractorInterface::getType()` instead
39122

40123
HttpKernel

‎src/Symfony/Component/Clock/CHANGELOG.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ CHANGELOG
44
7.1
55
---
66

7-
* Add `DatePoint::get/setMicrosecond()`
7+
* Add `DatePoint::getMicrosecond()` and `DatePoint::setMicrosecond()`
88

99
6.4
1010
---

‎src/Symfony/Component/Form/CHANGELOG.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ CHANGELOG
55
---
66

77
* Add option `separator` to `ChoiceType` to use a custom separator after preferred choices (use the new `separator_html` option to display the separator text as HTML)
8-
* Deprecate not configuring the `default_protocol` option of the `UrlType`, it will default to `null` in 8.0
8+
* Deprecate not configuring the `default_protocol` option of the `UrlType`, it will default to `null` in 8.0 (the current default is `'http'`)
99
* Add a `keep_as_list` option to `CollectionType`
1010
* Add a new `model_type` option to `MoneyType`, to be able to cast the transformed value to `integer`
1111

0 commit comments

Comments
 (0)