majdghithan/agent-skills / skills/laravel-upgrade
laravel-upgrade
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.3 KB |
| references/10-to-11.md | markdown | 2.2 KB |
| references/11-to-12.md | markdown | 2.0 KB |
| references/12-to-13.md | markdown | 1.6 KB |
| references/8-to-9.md | markdown | 2.1 KB |
| references/9-to-10.md | markdown | 1.8 KB |
| references/legacy-5-to-7.md | markdown | 1.6 KB |
references/8-to-9.md
View on GitHub# Laravel 8 -> 9
**PHP floor: 8.0** (bump and deploy PHP 8.0 under Laravel 8 first, confirm green, then upgrade).
Laravel 9 was the big dependency jump. Most of the pain is not Laravel code, it is the libraries under it moving major versions at once.
## The runtime bites (not loud in the rename list)
- **Swift Mailer is gone, replaced by Symfony Mailer.** This is the one that surprises people. If you passed Swift-specific options, used `Swift_Message` directly, or leaned on a mail plugin built for Swift, it breaks. Custom transports and message tweaks need rewriting against Symfony Mailer. Plain `Mail::to()->send()` is fine.
- **Flysystem 3 fails writes SILENTLY differently.** Two behavior changes bite: cached adapters were removed (delete that config), and a failed write no longer throws, write operations now overwrite existing files and a failure returns false instead of raising. Code that assumed an exception on failure will sail past a broken upload. Check every `Storage::put` you relied on throwing.
- **Symfony 6 return types.** `getSession()` now returns a `SessionInterface` or throws when there is no session, rather than returning null. Any code that null-checked the session needs a look.
## The nice new thing (optional, do not rush it)
Laravel 9 added single-method accessors/mutators via `Illuminate\Database\Eloquent\Casts\Attribute` (type-hint the return). The old `getFooAttribute` / `setFooAttribute` still work, so this is a refactor you can do later, not part of the upgrade. Do not convert them all during the version bump, that mixes two changes.
## Also
- Implicit route binding now works with Enums (feature, not a break).
- Carbon stays on 2.x here, the Carbon 3 forcing comes at 12.
## Checklist
- [ ] PHP 8.0 deployed and green under Laravel 8 first
- [ ] Custom mail transports/messages ported to Symfony Mailer
- [ ] Removed Flysystem cached-adapter config; audited writes that assumed an exception on failure
- [ ] `composer update` conflicts resolved (bump lagging packages together)
- [ ] Suite green, mail + file-upload flows exercised on staging
Official rename list: `laravel.com/docs/9.x/upgrade`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |