Skip to content

majdghithan/agent-skills / skills/laravel-upgrade

laravel-upgrade

Verified

FileKindSize
SKILL.mdskill md6.3 KB
references/10-to-11.mdmarkdown2.2 KB
references/11-to-12.mdmarkdown2.0 KB
references/12-to-13.mdmarkdown1.6 KB
references/8-to-9.mdmarkdown2.1 KB
references/9-to-10.mdmarkdown1.8 KB
references/legacy-5-to-7.mdmarkdown1.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`.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall