Skip to content

Commit 915b322

Browse files
committed
Document some 5.8 breaking changes
1 parent 86274b9 commit 915b322

File tree

1 file changed

+43
-1
lines changed

1 file changed

+43
-1
lines changed

upgrade.md

Lines changed: 43 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,14 @@ The `bootstrapPath`, `configPath`, `databasePath`, `environmentPath`, `resourceP
3939

4040
In the very unlikely event you are implementing this interface, you should add these methods to your implementation.
4141

42+
### Cache
43+
44+
#### The `Repository` and `Store` Contracts
45+
46+
**Likelihood Of Impact: Very Low**
47+
48+
In order to be fully compliant with `PSR-16` the return values of the `put` and `forever` methods of the `Illuminate/Contracts/Cache/Repository` contract and the return values of the `put`, `putMany` and `forever` methods of the `Illuminate/Contracts/Cache/Store` contract [have been changed](https://github.com/laravel/framework/pull/26726) from `void` to `bool`.
49+
4250
### Collections
4351

4452
#### The `firstWhere` Method
@@ -57,6 +65,14 @@ The `firstWhere` method signature [has changed](https://github.com/laravel/frame
5765
*/
5866
public function firstWhere($key, $operator = null, $value = null);
5967

68+
### Config
69+
70+
#### `ArrayAccess` Contract Added To The `Repository` Contract
71+
72+
**Likelihood Of Impact: Very Low**
73+
74+
[The `Illuminate\Contracts\Config\Repository` contract](https://github.com/laravel/framework/pull/26747) now extends the `ArrayAccess` contract. If you are implementing the `Repository` interface, your implementation should now also satisfy the `ArrayAccess` contract.
75+
6076
### Console
6177

6278
#### The `Kernel` Contract
@@ -123,6 +139,8 @@ The `originalIsEquivalent` method of the `Illuminate\Database\Eloquent\Concerns\
123139

124140
#### The `fire` Method
125141

142+
**Likelihood Of Impact: Low**
143+
126144
The `fire` method (which was deprecated in Laravel 5.4) of the `Illuminate/Events/Dispatcher` class [has been removed](https://github.com/laravel/framework/pull/26392).
127145
You should use the `dispatch` method instead.
128146

@@ -189,6 +207,12 @@ The `transform` method of the `Illuminate\Foundation\Http\Middleware\TransformsR
189207

190208
The `previous` method [has been added to the `Illuminate\Contracts\Routing\UrlGenerator` contract](https://github.com/laravel/framework/pull/25616). If you are implementing this interface, you should add this method to your implementation.
191209

210+
#### The `cachedSchema` Property Of `Illuminate/Routing/UrlGenerator`
211+
212+
**Likelihood Of Impact: Very Low**
213+
214+
The `$cachedSchema` property name (which has been deprecated in Laravel `5.7`) of `Illuminate/Routing/UrlGenerator` [has been changed to](https://github.com/laravel/framework/pull/26728) `$cachedScheme`.
215+
192216
### Sessions
193217

194218
#### The `StartSession` Middleware
@@ -214,6 +238,24 @@ The `validated` method [was added to the `Illuminate\Contracts\Validation\Valida
214238

215239
If you are implementing this interface, you should add this method to your implementation.
216240

241+
#### The `ValidatesAttributes` Trait
242+
243+
**Likelihood Of Impact: Very Low**
244+
245+
The `parseTable`, `getQueryColumn` and `requireParameterCount` methods of the `Illuminate\Validation\Concerns\ValidatesAttributes` trait have been changed from `protected` to `public`.
246+
247+
#### The `DatabasePresenceVerifier` Class
248+
249+
**Likelihood Of Impact: Very Low**
250+
251+
The `table` method of the `Illuminate\Validation\DatabasePresenceVerifier` class has been changed from `protected` to `public`.
252+
253+
#### The `Validator` Class
254+
255+
**Likelihood Of Impact: Very Low**
256+
257+
The `getPresenceVerifierFor` method of the `Illuminate\Validation\Validator` class [has been changed](https://github.com/laravel/framework/pull/26717) from `protected` to `public`.
258+
217259
#### Email Validation
218260

219261
**Likelihood Of Impact: Very Low**
@@ -222,7 +264,7 @@ The email validation rule now checks if the email is [RFC5630](https://tools.iet
222264

223265
Therefore, when using Laravel 5.8, emails that were previously incorrectly considered invalid will now be considered valid (e.g `hej@bär.se`). Generally, this should be considered a bug fix; however, it is listed as a breaking change out of caution. [Please let us know if you encounter any issues surrounding this change](https://github.com/laravel/framework/pull/26503).
224266

225-
### Notifcations
267+
### Notifications
226268

227269
#### Nexmo / Slack Notification Channels
228270

0 commit comments

Comments
 (0)