I/O exceptions refactoring

[thekid]

Part 1 of #363, resolving the name collision with PHP's Io\IoException class introduced as part of https://wiki.php.net/rfc/poll_api#exception_hierarchy in php/php-src#19572

Implementation status

• Rename IOException -> OperationFailed
• Rename FileNotFoundException -> NotFound
• Rename OperationNotSupportedException -> NotSupported
• Rename OperationTimedOutException -> TimedOut
• Adjust all code throwing and catching these inside xp-framework/core
• Deprecate old classes (and schedule for removal in upcoming major release)
• Provide class aliases for BC (for PHP < 8.6)

Effects on userland code

When using PHP < 8.6, nothing will change for existing code: Raising and catching io.IOException will use the class alias:

$ XP_RT=8.5 xp -w 'new \io\IOException("Test")'
Exception io.OperationFailed (Test)
  at <main>::include() [line 163 of Code.class.php]
  at xp.runtime.Code::run(array[1]) [line 30 of Dump.class.php]
  at xp.runtime.Dump::main(array[1]) [line 389 of class-main.php]

For PHP 8.6, the native class will be thrown (and caught). For direct uses, this will continue to work, but using it for its base class character will break code as follows:

use io\IOException;
use peer\SocketException;

try {
  throw new SocketException('...');
} catch (IOException $e) {
  // This will not longer be run, as SocketException doesn't inherit PHP's exception!
}

The path forward

This means libraries should start migrating to the new class hierarchy based in io.OperationFailed now. This will create quite a bit of library releases; quite a few of which will also need to drop support for older XP core releases.

• To further BC, we should backport this to XP11 and create a new release in this series
• First, we will check - and if necessary - adapt XP compiler, reflection and testing libraries
• This will be followed by all other libraries in xp-forge, xp-lang and xp-framework. Although technically many will incur BC breaks, we will use feature releases in order not to create an update hell for users

[thekid]

Backported to XP11 and released in https://github.com/xp-framework/core/releases/tag/v11.11.0

[thekid]

Released in https://github.com/xp-framework/core/releases/tag/v12.11.0