fix(config): replace composer_version 1 option with 2.2 (LTS), fixes #8084 (#8126)

jonesrussell · stasadev · web-flow · commit 34255f387926 · 2026-02-13T11:39:19.000-07:00
Co-authored-by: Stanislav Zhuk &lt;stasadev@gmail.com&gt;
diff --git a/cmd/ddev/cmd/autocompletion_test.go b/cmd/ddev/cmd/autocompletion_test.go
@@ -245,7 +245,7 @@ func TestAutocompletionForConfigCmd(t *testing.T) {
 		"--project-tld":                 {nodeps.DdevDefaultTLD},
 		"--use-dns-when-possible":       {"true", "false"},
 		"--disable-settings-management": {"true", "false"},
-		"--composer-version":            {"2", "2.2", "1", "stable", "preview", "snapshot"},
+		"--composer-version":            {"2", "2.2", "stable", "preview", "snapshot"},
 		"--bind-all-interfaces":         {"true", "false"},
 		"--database":                    nodeps.GetValidDatabaseVersions(),
 		"--nodejs-version":              {nodeps.NodeJSDefault, "auto", "engine"},
diff --git a/cmd/ddev/cmd/config.go b/cmd/ddev/cmd/config.go
@@ -300,8 +300,8 @@ func init() {
 	ConfigCommand.Flags().Bool("disable-settings-management", false, "Prevent DDEV from creating or updating CMS settings files")
 	_ = ConfigCommand.RegisterFlagCompletionFunc("disable-settings-management", configCompletionFunc([]string{"true", "false"}))
 
-	ConfigCommand.Flags().String("composer-version", nodeps.ComposerDefault, `Specify override for Composer version in web container. This may be "", "1", "2", "2.2", "stable", "preview", "snapshot" or a specific version`)
-	_ = ConfigCommand.RegisterFlagCompletionFunc("composer-version", configCompletionFunc([]string{"2", "2.2", "1", "stable", "preview", "snapshot"}))
+	ConfigCommand.Flags().String("composer-version", nodeps.ComposerDefault, `Specify override for Composer version in web container. This may be "", "2", "2.2", "stable", "preview", "snapshot" or a specific version`)
+	_ = ConfigCommand.RegisterFlagCompletionFunc("composer-version", configCompletionFunc([]string{"2", "2.2", "stable", "preview", "snapshot"}))
 
 	ConfigCommand.Flags().Bool("auto", false, `Automatically run config without prompting`)
 	ConfigCommand.Flags().Bool("bind-all-interfaces", false, `Bind host ports on all interfaces, not only on the localhost network interface`)
diff --git a/docs/content/users/configuration/config.md b/docs/content/users/configuration/config.md
@@ -92,7 +92,7 @@ Composer version for the web container and the [`ddev composer`](../usage/comman
 
 | Type | Default | Usage
 | -- | -- | --
-| :octicons-file-directory-16: project | `2` | Can be `2`, `1`, or empty (`""`) for latest major version at container build time.<br><br>Can also be the LTS version `2.2` (there's no other `2.x` LTS), an explicit version like `2.9.3`, or a keyword like `stable`, `preview` or `snapshot`. See [Composer documentation](https://getcomposer.org/doc/03-cli.md#self-update-selfupdate).
+| :octicons-file-directory-16: project | `2` | Can be `2` or empty (`""`) for latest major version at container build time.<br><br>Can also be the LTS version `2.2` (there's no other `2.x` LTS), an explicit version like `2.9.3`, or a keyword like `stable`, `preview` or `snapshot`. See [Composer documentation](https://getcomposer.org/doc/03-cli.md#self-update-selfupdate).
 
 !!!warning "Composer version is cached at container build time"
     DDEV installs Composer at container build time and caches it. If you use a non-specific version like `2`, `2.2`, `""` (empty), or `stable`, DDEV installs the latest available version in that range at build time.
diff --git a/docs/content/users/usage/commands.md b/docs/content/users/usage/commands.md
@@ -372,7 +372,7 @@ Flags:
 * `--bind-all-interfaces`: Bind host ports on all interfaces, not only on the localhost network interface.
 * `--composer-root`: The relative path, from the project root, to the directory containing `composer.json`. (This is where all Composer-related commands are executed.)
 * `--composer-root-default`: Unset a `web` service Composer root directory override, the same as `--composer-root=""`.
-* `--composer-version`: Specify override for Composer version in the web container. This may be `""`, `"1"`, `"2"`, `"2.2"`, `"stable"`, `"preview"`, `"snapshot"`, or a specific version.
+* `--composer-version`: Specify override for Composer version in the web container. This may be `""`, `"2"`, `"2.2"`, `"stable"`, `"preview"`, `"snapshot"`, or a specific version.
 * `--corepack-enable`: Whether to run `corepack enable` on Node.js configuration.
 * `--database`: Specify the database `type:version` to use (see [default](../configuration/config.md#database)).
 * `--db-working-dir`: Override the default working directory for the `db` service.
diff --git a/pkg/ddevapp/composer_test.go b/pkg/ddevapp/composer_test.go
@@ -126,13 +126,22 @@ func TestComposerVersion(t *testing.T) {
 	assert.NoError(err)
 	assert.True(strings.HasPrefix(stdout, "Composer 2") || strings.HasPrefix(stdout, "Composer version 2"), "Composer version not the expected Composer 2: %v", stdout)
 
-	// Make sure it does the right thing with 1.x
+	// With version "1" we should get Composer v2.2 LTS
+	// See https://blog.packagist.com/shutting-down-packagist-org-support-for-composer-1-x/
 	app.ComposerVersion = "1"
 	err = app.Restart()
 	require.NoError(t, err)
 	stdout, _, err = app.Exec(&ddevapp.ExecOpts{Cmd: "composer --version"})
 	assert.NoError(err)
-	assert.Contains(stdout, "Composer version 1")
+	assert.Contains(stdout, "Composer version 2.2")
+
+	// With version "1.10.25" we should also get Composer v2.2 LTS.
+	app.ComposerVersion = "1.10.25"
+	err = app.Restart()
+	require.NoError(t, err)
+	stdout, _, err = app.Exec(&ddevapp.ExecOpts{Cmd: "composer --version"})
+	assert.NoError(err)
+	assert.Contains(stdout, "Composer version 2.2")
 
 	// With version "2" we should be back to latest v2
 	app.ComposerVersion = "2"
diff --git a/pkg/ddevapp/config.go b/pkg/ddevapp/config.go
@@ -29,6 +29,9 @@ import (
 // Regexp pattern to determine if a hostname is valid per RFC 1123.
 var hostRegex = regexp.MustCompile(`^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\-]*[A-Za-z0-9])$`)
 
+// Regexp pattern to match Composer v1 versions: "1" or "1.x.y"
+var composerV1Regex = regexp.MustCompile(`^1(\.\d+\.\d+)?$`)
+
 // RunValidateConfig controls whether to run ValidateConfig() function.
 // In some cases we don't actually need to check the config, e.g. when deleting the project.
 // It is enabled by default.
@@ -262,6 +265,11 @@ func (app *DdevApp) WriteConfig() error {
 		appcopy.Type = nodeps.AppTypePHP
 	}
 
+	if composerV1Regex.MatchString(appcopy.ComposerVersion) {
+		appcopy.ComposerVersion = "2.2"
+		util.WarningOnce(`Project '%s' now uses Composer v2.2 LTS. Composer v1 is no longer supported by Packagist, see https://blog.packagist.com/shutting-down-packagist-org-support-for-composer-1-x/`, app.Name)
+	}
+
 	// We now want to reserve the port we're writing for HostDBPort and HostWebserverPort and so they don't
 	// accidentally get used for other projects.
 	err := app.UpdateGlobalProjectList()
@@ -854,7 +862,11 @@ func (app *DdevApp) CheckCustomConfig() {
 
 // CheckDeprecations warns the user if anything in use is deprecated.
 func (app *DdevApp) CheckDeprecations() {
-
+	if composerV1Regex.MatchString(app.ComposerVersion) {
+		app.ComposerVersion = "2.2"
+		util.WarningOnce(`Project '%s' now uses Composer v2.2 LTS. Composer v1 is no longer supported by Packagist, see https://blog.packagist.com/shutting-down-packagist-org-support-for-composer-1-x/
+Run 'ddev config --auto' to remove this Composer warning.`, app.Name)
+	}
 }
 
 // FixObsolete removes files that may be obsolete, etc.
@@ -1456,7 +1468,7 @@ RUN (timeout %d apt-get update || true) && DEBIAN_FRONTEND=noninteractive apt-ge
 		}
 
 		// Major and minor versions have to be provided as option so add '--' prefix.
-		// E.g. a major version can be 1 or 2, a minor version 2.2 or 2.1 etc.
+		// E.g. a major version can be 2, a minor version 2.2 or 2.1 etc.
 		if strings.Count(composerVersion, ".") < 2 {
 			composerSelfUpdateArg = "--" + composerSelfUpdateArg
 		}
diff --git a/pkg/ddevapp/config_test.go b/pkg/ddevapp/config_test.go
@@ -1327,7 +1327,7 @@ func TestComposerVersionConfig(t *testing.T) {
 		assert.NoError(err)
 	})
 
-	for _, testVersion := range []string{"2", "2.2", "2.5.5", "1", "stable", "preview", "snapshot"} {
+	for _, testVersion := range []string{"2", "2.2", "2.5.5", "stable", "preview", "snapshot"} {
 		app.ComposerVersion = testVersion
 		err = app.Start()
 		assert.NoError(err)
diff --git a/pkg/ddevapp/templates.go b/pkg/ddevapp/templates.go
@@ -69,7 +69,7 @@ const ConfigInstructions = `
 # commands are executed.
 
 # composer_version: "2"
-# You can set it to "" or "2" (default) for Composer v2 or "1" for Composer v1
+# You can set it to "" or "2" (default) for Composer v2
 # to use the latest major version available at the time your container is built.
 # It is also possible to use each other Composer version channel. This includes:
 #   - 2.2 (latest Composer LTS version)
