为何Composer无法更新指定包？求指导升级Voyager至1.3版本

架构老林

2026-5-14

How to Upgrade Voyager from 1.2 to 1.3 Successfully

Hey there, let's get your Voyager upgrade sorted out! The issue with your current approach is that the --lock flag you used doesn't actually install the updated package—it only modifies the composer.lock file without pulling in new versions. Here's a step-by-step guide to upgrade just the tcg/voyager package to 1.3.x:

Verify your composer.json configuration
First, make sure your composer.json has the correct version constraint for Voyager:
```
"tcg/voyager": "1.3.*"
```
Double-check there are no other conflicting version constraints or packages that might block the upgrade.
Run the proper update command
To update only Voyager (and its necessary dependencies), execute this command without the --lock flag:
```
composer update tcg/voyager --with-dependencies
```
The --with-dependencies flag ensures any packages Voyager relies on are also updated to compatible versions, preventing version conflicts that could halt the upgrade.
Clear Composer's cache if issues persist
Sometimes Composer caches outdated version metadata, which can prevent it from detecting the latest 1.3.x releases. Clear the cache with:
```
composer clear-cache
```
Then re-run the update command above.
Resolve version conflicts (if any)
If the upgrade still fails, Composer will output detailed conflict messages. Review these messages to identify if other packages depend on an older version of Voyager or its dependencies. You may need to adjust those packages' version constraints temporarily, or refer to Voyager's 1.3 upgrade notes to check for any required dependency changes.