Add comprehensive PHP 8 compatibility support and documentation

[Copilot]

This PR addresses PHP 8 compatibility issues in the Go! AOP Framework by providing comprehensive documentation, testing, and tooling for PHP 8+ support.

Changes Made

📚 Documentation

• Added UPGRADE-PHP8.md - Comprehensive PHP 8 migration guide covering:
  • Feature support status for PHP 8.0, 8.1, and 8.2
  • Known issues and workarounds
  • Migration instructions from older versions
• Updated README.md - Added PHP 8.2+ requirement and link to upgrade guide
• Updated CHANGELOG.md - Documented PHP 8 compatibility work and known issues

🧪 Testing

• Added tests/Go/Functional/PHP8CompatibilityTest.php - Comprehensive test suite covering:
  • getConstants() method with PHP 8 filter parameter
  • PHP 8+ syntax parsing (union types, attributes, named parameters, etc.)
  • Data-driven tests for all major PHP 8 features

🛠️ Tooling

• Added bin/check-php8-compatibility - Interactive compatibility checker that:
  • Verifies PHP version requirements
  • Tests parser-reflection functionality
  • Validates PHP 8 syntax parsing capabilities
  • Checks core framework classes

Key Finding

The framework is largely PHP 8 compatible, but there's a specific issue in the goaop/parser-reflection dependency where getConstants(?int $filter = null) accepts the PHP 8 filter parameter but doesn't properly implement the filtering logic:

// This currently returns ALL constants instead of just public ones
$constants = $parserReflectionClass->getConstants(ReflectionClassConstant::IS_PUBLIC);

This issue is now documented with workarounds provided in the upgrade guide.

Testing

Run the new compatibility checker:

php bin/check-php8-compatibility

Expected output shows framework working correctly with PHP 8+ while documenting the known getConstants() filtering issue.

Fixes #466.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/adlawson/php-vfs/zipball/e955034419d6a8f92c9a8ea2e626eeed96b41095
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/cache/zipball/1ca8f21980e770095a31456042471a57bc4c68fb
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/collections/zipball/2eb07e5953eed811ce1b309a7478a3b236f2273d
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/common/zipball/d9ea4a54ca2586db781f0265d36bea731ac66ec5
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/dbal/zipball/4a4e2eed3134036ee36a147ee0dac037dfa17868
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/deprecations/zipball/459c2f5dd3d6a4633d3b5f46ee2b1c40f57d3f38
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/event-manager/zipball/b680156fa328f1dfd874fd48c7026c41570b9c6e
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/inflector/zipball/5817d0659c5b50c9b950feb9af7b9668e2c436bc
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/instantiator/zipball/c6222283fa3f4ac679f8b9ced9a4e23f163e80d0
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/lexer/zipball/31ad66abc0fc9e1a1f2d9bc6a42668d2fbbcd6dd
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/orm/zipball/6307b4fa7d7e3845a756106977e3b48907622098
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/doctrine/persistence/zipball/0ea965320cec355dba75031c1b23d4c78362e3ff
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/goaop/dissect/zipball/5d4aeb87ee4aaf20fb3fbf08aa3e0b17bba37e09
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/Rps1nh /usr/bin/composer install --no-dev --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/goaop/parser-reflection/zipball/9c9bee019c76398f396ed673b6d7602b92a74a55
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/Rps1nh /usr/bin/composer install --no-dev --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/laminas/laminas-code/zipball/1793e78dad4108b594084d05d1fb818b85b110af
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/Rps1nh /usr/bin/composer install --no-dev --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/nikic/PHP-Parser/zipball/ae59794362fe85e051a58ad36b289443f57be7a9
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/Rps1nh /usr/bin/composer install --no-dev --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/php-fig/cache/zipball/aa5030cfa5405eccfdcb1083ce040c2cb8d253bf
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/php-fig/container/zipball/c71ecc56dfe541dbd90c5360474fbc405f8d5963
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/php-fig/log/zipball/d49695b909c3b7628b6289db5479a1c204601f11
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/console/zipball/9e27aecde8f506ba0fd1d9989620c04a87697101
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/finder/zipball/ec2344cf77a48253bbca6939aa3d2477773ea63d
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/Rps1nh /usr/bin/composer install --no-dev --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/vyYHKc /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/polyfill-php80/zipball/0cc9dd0f17f61d8131e7df6b84bd344899fe2608
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/polyfill-php84/zipball/000df7860439609837bbe28670b0be15783b7fbf
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/service-contracts/zipball/f021b05a130d35510bd6b25fe9053c2a8a15d5d4
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)
• https://api.github.com/repos/symfony/string/zipball/f3570b8c61ca887a9e2938e85cb6458515d2b125
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/HOwoRl /usr/bin/composer install --no-interaction --ignore-platform-reqs (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/AgG0fr /usr/bin/composer install --ignore-platform-reqs --no-interaction --prefer-dist (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to my firewall allow list

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[scrutinizer-notifier]

A new inspection was created.