PHP Semantic Exception

php_semantic_exception.php

<?php

namespace Application;

$fileName = '/not-writable';

// Human-only readable exceptions
// throw new \RuntimeException("{$fileName} is not writable.");

// Semantic exceptions
throw new FileNotWritableException($fileName);

class FileNotWritableException extends RuntimeException
{
    public function __construct(
        public readonly string $fileName
    )
    {
        // You can build the properties you want to log here.
        parent::__construct();
    }
}

/**
 * Base exception
 */
class RuntimeException extends \RuntimeException
{
    public function __construct()
    {
        $message = '';
        foreach ($this as $key => $value) { // @phpstan-ignore-line
            if (in_array($key, ['code', 'message', 'file', 'line'])) {
                continue;
            }

            $message .= "{$key}: {$value} ";
        }

        parent::__construct($message);
    }
}

// Pros
// 
// * Minimizes caller code
// * Ensures exception identity
// * Can reach the code from a specific exception in the IDE
// * Generate messages to ensure compatibility