feat: add CLI version display with -V option (#1780)

[WangYihang]

Description

• Add new Version class with Git-based semantic versioning support
• Implement -V/--show-version CLI option to display current version
• Support dev and dirty version suffixes for non-release builds
• Add comprehensive unit tests for version resolution logic
• Include composer/semver dependency for semantic version handling

Example

➜  swagger-php git:(feature/cli-version-support) git tag 5.1.5                                 
➜  swagger-php git:(feature/cli-version-support) ./bin/openapi  -V
{"version":"5.1.5","commit":"411315f3"}

Details

The version output format is JSON:

• {"version": "X.Y.Z", "commit": "abcd1234"}
• {"version": "X.Y.Z-dev", "commit": "efgh5678"}
• {"version": "X.Y.Z-dev-dirty", "commit": "ijkl9012"}

Version resolution follows these rules:

• Uses latest Git tag if current commit is tagged
• Appends -dev suffix for untagged commits (with patch increment)
• Appends -dirty suffix for uncommitted changes
• Falls back to 0.0.1-dev when no tags exist

[DerManoMann]

Hmm, admittedly I didn't think too much about how this would work, but adding two new dependencies feels definitely likey overkill to me.

Makes me wonder - is composer show so much worse?

[WangYihang]

Ah, my mistake. I should have first checked if a Composer command could handle this. Running composer global show provided the packages I needed to see:

$ composer global show
Changed current directory to /tmp
nikic/php-parser              5.6.0  A PHP parser written in PHP
psr/log                       3.0.2  Common interface for logging libraries
symfony/deprecation-contracts 3.6.0  A generic function and convention to trigger deprecation notices
symfony/finder                7.3.0  Finds files and directories via an intuitive fluent interface
symfony/polyfill-ctype        1.32.0 Symfony polyfill for ctype functions
symfony/yaml                  7.3.1  Loads and dumps YAML files
zircote/swagger-php           5.1.4  Generate interactive documentation for your RESTful API using PHP attributes (preferred) or PHPDoc annotations

Apologies for the noise. I am closing this pull request and issue now.

[DerManoMann]

No problem - glad you took it lightly. One of the best written issue/PR I've seen for a while.
Thanks for your initiative.