Fix misleading configuration option name in error message #12498

kayw-geek · 2025-08-14T06:01:54Z

Problem

The current error message displays incorrect configuration option name when terminal doesn't support hyperlinks:

To resolve ambiguity in classes not under your control you can ignore them by path using exclude-files-from-classmap

The hyperlink anchor text exclude-files-from-classmap is actually pointing to the documentation section #exclude-files-from-classmaps, but the actual configuration option documented there is exclude-from-classmap.

Impact

When users' terminals don't support hyperlinks, they see exclude-files-from-classmap as plain text and mistakenly believe this is the correct configuration option. This leads to invalid composer.json configurations that don't work.

Solution

Update the error message to show the correct configuration option name exclude-from-classmap instead of using the documentation anchor as the link text.

Before

$this->io->writeError('<info>To resolve ambiguity in classes not under your control you can ignore them by path using <href='.OutputFormatter::escape('https://getcomposer.org/doc/04-schema.md#exclude-files-from-classmaps').'>exclude-files-from-classmap</>');

After

$this->io->writeError('<info>To resolve ambiguity in classes not under your control you can ignore them by path using <href='.OutputFormatter::escape('https://getcomposer.org/doc/04-schema.md#exclude-files-from-classmaps').'>exclude-from-classmap</>');

This ensures users see the correct configuration option name regardless of their terminal's hyperlink support.

Fixes composer#12225

…y default Fixes composer#12222

…agnose command, refs composer#12196

…rading to warning, fixes composer#12196

Fixes composer#12090

… fix If the installer script linked from [this page]([https://getcomposer.org/doc/faqs/how-to-install-composer-programmatically.md](https://getcomposer.org/doc/faqs/how-to-install-composer-programmatically.md)) is run using PHP 8, it generates the following deprecation notice. ``` Deprecated: Function openssl_free_key() is deprecated since 8.0, as OpenSSLAsymmetricKey objects are freed automatically in Standard input code on line 982 ``` This issue was [fixed in the installer script]([composer/getcomposer.org#159](composer/getcomposer.org#159)), but the documentation was not updated to link to the version of it that includes the fix.

This will simplify secure installation of composer in GitHub Actions to two calls to `gh` cli with no need to manually import any PGP signing keys: gh release --repo composer/composer download --pattern composer.phar gh attestation verify --repo composer/composer composer.phar Given that the current PGP signing key is stored as a GitHub Action secret, this type of attestation is no less secure than the existing PGP signing.

Glad that I added some tests as this meant I found a bug in the PR I pulled previously (composer#12257). The `thanks_dev` key expects a username in the format `u/gh/USERNAME`, but the call to `basename()` was stripping the `u/gh/` part off. If the use of `basename()` is preferred here, the alternative would be to add `u/gh/` to the default URL prefix for thanks.dev. Let me know if you me to change that.

Fixes composer#12259 Closes composer#12275

Closes composer#12227

…ser#12253

composer#12353) Fixes composer#12335

…ing output too much with deprecation notices (composer#12360)

…nstallation, fixes composer#12225 (composer#12361)

…ser#12367) Fixes composer#12364

* Add a CI job running with a 32bits build of PHP * Move to a run that only happens on main branch --------- Co-authored-by: Jordi Boggiano <j.boggiano@seld.be>

composer#12383) * Do not output script being run when running via composer <script-name> Fixes composer#12375 * Fix global test expectations

private-packagist · 2025-08-14T06:01:59Z

composer.lock

Package changes

Package	Operation	From	To	About
composer/ca-bundle	downgrade	1.5.7	1.5.6	diff
composer/spdx-licenses	downgrade	1.5.9	1.5.8	diff
justinrainbow/json-schema	downgrade	6.4.2	6.4.1	diff
symfony/polyfill-ctype	downgrade	v1.32.0	v1.31.0	diff
symfony/polyfill-intl-grapheme	downgrade	v1.32.0	v1.31.0	diff
symfony/polyfill-intl-normalizer	downgrade	v1.32.0	v1.31.0	diff
symfony/polyfill-mbstring	downgrade	v1.32.0	v1.31.0	diff
symfony/polyfill-php73	downgrade	v1.32.0	v1.31.0	diff
symfony/polyfill-php80	downgrade	v1.32.0	v1.31.0	diff
symfony/polyfill-php81	downgrade	v1.32.0	v1.31.0	diff

Dev Package changes

Package	Operation	From	To	About
phpstan/phpstan	downgrade	1.12.27	1.12.23	diff
symfony/phpunit-bridge	downgrade	v7.3.0	v7.2.0	diff

Settings · Docs · Powered by Private Packagist

Seldaek and others added 30 commits July 16, 2025 16:53

Avoid duplicate errors in the output, fixes composer#12214

321dd91

Update logic

11d9057

Fixed InstalledVersions returning duplicates in some instances

27006ad

Fixes composer#12225

Fix create-project when passed with a path repo to disable symlinks b…

9f80999

…y default Fixes composer#12222

Update deps

d0cf75c

Avoid returning failing status code if the composer audit fails in di…

f60e21c

…agnose command, refs composer#12196

Hide publish errors entirely with --no-check-publish instead of downg…

9f87d41

…rading to warning, fixes composer#12196

Fix tests

e5483ff

Update changelog

f5a4835

Release 2.8.4

4e6198c

Reverting release version changes

5d290d4

Discard unsupported FUNDING.yml URL values

3af59e4

Make use of Phar::running() to get the current phar path

21dfaa2

Fix new phpstan error

94c0b3e

explicitly state UTC

3d855b4

Update deps

d796594

Fix unstable order of psr-0 and psr-4 rules

c3825b0

Fixes composer#12090

Allow redirect responses to output warnings/infos

d51631b

Allow using short form URLs like foo.com if they are very simple

6851e1f

Fix URL to GitLab personal access tokens

ed1b48d

Update issue templates

dbf0619

Delete .github/ISSUE_TEMPLATE.md

c8d9b9d

Fix command name parsing to take into account global input options

349cee8

Fixes composer#12259 Closes composer#12275

Adding explicit message to why-not if package is already installed

f3a0dfe

Closes composer#12227

Update BaseDependencyCommand.php

4f635a1

Adjusting the test

aec4749

Suppress require-dev hint when requiring things globally, fixes compo…

d4ab77f

…ser#12253

ictbeheer and others added 28 commits July 16, 2025 16:54

Add COMPOSER_MAX_PARALLEL_PROCESSES (composer#12356)

eb9ddf0

Update deps

b731ecf

Update composer-schema.json add path repository options (composer#12321)

448062a

Fix handling of replace together with the --with temporary constraints (

6efc93c

composer#12353) Fixes composer#12335

Fix error handler to bypass some new php 8.5 warnings and avoid spamm…

8770e1c

…ing output too much with deprecation notices (composer#12360)

Fix InstalledVersions showing duplicates at Composer runtime during i…

91b2c42

…nstallation, fixes composer#12225 (composer#12361)

Update changelog

56b2295

Release 2.8.7

4dee59a

Reverting release version changes

450b01e

Fix release workflow

1d762ed

Fix support for various version schemes in the composer schema (compo…

8e3be10

…ser#12367) Fixes composer#12364

Add a CI job running with a 32bits build of PHP (composer#12366)

7f70ef2

* Add a CI job running with a 32bits build of PHP * Move to a run that only happens on main branch --------- Co-authored-by: Jordi Boggiano <j.boggiano@seld.be>

Bump deps, fixes composer#12365

f22a16a

Fix some issues running tests on 32bit

755789b

Fix issue formatting rdkafka on 32bit

8f5073d

Fix some more 32bit tests

6b1e4c1

Fix tests

7ff67c0

Update changelog

1a361fa

Release 2.8.8

263634e

Reverting release version changes

a1be34c

Skip tests that cannot work as root due to permission checks

7b8b8bd

ensure that version suffixes are case-insensitive (composer#12376)

b2078b1

Don't run bump after update with --lock (composer#12371)

6b338cd

Tweak error message to include the package name, refs composer#12369

e99cec9

Update more exception messages, refs composer#12369

3108ffd

Fix ZipDownloaderTest expectations

8ea3e36

Do not output script being run when running via composer <script-name> (

bb6049d

composer#12383) * Do not output script being run when running via composer <script-name> Fixes composer#12375 * Fix global test expectations

Fix ambiguous linked text for exclude-from-classmap

b3fec80

kayw-geek closed this Aug 14, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Fix misleading configuration option name in error message #12498

Fix misleading configuration option name in error message #12498

Uh oh!

kayw-geek commented Aug 14, 2025

Uh oh!

private-packagist bot commented Aug 14, 2025

Uh oh!

Uh oh!

Uh oh!

Fix misleading configuration option name in error message #12498

Fix misleading configuration option name in error message #12498

Uh oh!

Conversation

kayw-geek commented Aug 14, 2025

Problem

Impact

Solution

Before

After

Uh oh!

private-packagist bot commented Aug 14, 2025

composer.lock

Package changes

Dev Package changes

Uh oh!

Uh oh!