Handle php version mismatch error.

[thavaahariharangit]

What are you trying to accomplish?

I am trying to resolve an issue in this workflow: GitHub Actions Run.

Issue:

Currently, the workflow encounters an error but still shows as successful. And shows below logs: (It is not user friendly)

updater | 2025/02/27 15:41:31 ERROR <job_971685177> Your requirements could not be resolved to an installable set of packages.
  Problem 1
    - Root composer.json requires league/csv >= 9.7, == 9.21.0 -> satisfiable by league/csv[9.21.0].
    - league/csv 9.21.0 requires php ^8.1.2 -> your php version (8.1; overridden via config.platform, actual: 8.2.27) does not satisfy that requirement.
updater | 2025/02/27 15:41:31 ERROR <job_971685[177](https://github.com/dsp-testing/league-csv-sample/actions/runs/13570217169/job/37933001194#step:3:179)> /home/dependabot/common/lib/dependabot/shared_helpers.rb:200:in `run_helper_subprocess'
2025/02/27 15:41:31 ERROR <job_971685177> /home/dependabot/dependabot-updater/vendor/ruby/3.3.0/gems/sorbet-runtime-0.5.11577/lib/types/private/methods/call_validation.rb:270:in `bind_call'
updater | 2025/02/27 15:41:31 ERROR <job_971685177> /home/dependabot/dependabot-updater/vendor/ruby/3.3.0/gems/sorbet-runtime-0.5.11577/lib/types/private/methods/call_validation.rb:270:in `validate_call'
2025/02/27 15:41:31 ERROR <job_971685177> /home/dependabot/dependabot-updater/vendor/ruby/3.3.0/gems/sorbet-runtime-0.5.11577/lib/types/private/methods/_methods.rb:277:in `block in _on_method_added'
2025/02/27 15:41:31 ERROR <job_971685177> /home/dependabot/composer/lib/dependabot/composer/update_checker/version_resolver.rb:144:in `block in run_update_checker'
2025/02/27 15:41:31 ERROR <job_971685177> /home/dependabot/common/lib/dependabot/shared_helpers.rb:299:in `with_git_configured'

Solution Provided

1. Improved Error Messaging

• The logs will no longer display the full stack trace.
• Instead, they will show a clear and structured error message, such as:

2025/03/12 07:21:12 INFO Handled error whilst updating league/csv: tool_version_not_supported {:"tool-name"=>"PHP", :"detected-version"=>"8.1", :"supported-versions"=>"^8.1.2"}

2. Failing the Workflow on Errors

• The workflow will now properly fail when an error occurs.
• The error summary will be structured as:

Dependabot encountered '1' error(s) during execution, please check the logs for more details.
+-----------------------------------------+
|      Dependencies failed to update      |
+------------+----------------------------+
| league/csv | tool_version_not_supported |
+------------+----------------------------+

This ensures that errors are more readable and that the workflow status correctly reflects failure when dependencies cannot be updated.

Anything you want to highlight for special attention from reviewers?

N/A

How will you know you've accomplished your goal?

Checklist

• I have run the complete test suite to ensure all tests and linters pass.
• I have thoroughly tested my code changes to ensure they work as expected, including adding additional tests for new functionality.
• I have written clear and descriptive commit messages.
• I have provided a detailed description of the changes in the pull request, including the problem it addresses, how it fixes the problem, and any relevant details about the implementation.
• I have ensured that the code is well-documented and easy to understand.

[kbukum1]

LGTM