?HAMA

Edit File Size: 2.81 KB

//home/nshryvcy/radiantskinclinics.org/wp-content/plugins/woocommerce/packages/email-editor/src/exceptions.php

Text Base64

<?php declare(strict_types = 1);

// phpcs:ignoreFile PSR1.Classes.ClassDeclaration
namespace Automattic\WooCommerce\EmailEditor;

/**
 * Provides information for converting exceptions to HTTP responses.
 */
interface HttpAwareException {
  public function getHttpStatusCode(): int;
}

/**
 * Frames all exceptions ("$e instanceof Automattic\WooCommerce\EmailEditor\Exception").
 */
abstract class Exception extends \Exception {
  /** @var string[] */
  private $errors = [];

final public function __construct(string $message = '', int $code = 0, ?\Throwable $previous = null) {
    parent::__construct($message, $code, $previous);
  }

/** @return static */
  public static function create(?\Throwable $previous = null) {
    return new static('', 0, $previous);
  }

/** @return static */
  public function withMessage(string $message) {
    $this->message = $message;
    return $this;
  }

/** @return static */
  public function withCode(int $code) {
    $this->code = $code;
    return $this;
  }

/**
   * @param string[] $errors
   * @return static
   */
  public function withErrors(array $errors) {
    $this->errors = $errors;
    return $this;
  }

/** @return static */
  public function withError(string $id, string $error) {
    $this->errors[$id] = $error;
    return $this;
  }

/**
   * @return string[]
   */
  public function getErrors(): array {
    return $this->errors;
  }
}

/**
 * USE: Generic runtime error. When possible, use a more specific exception instead.
 * API: 500 Server Error (not HTTP-aware)
 */
class RuntimeException extends Exception {}

/**
 * USE: When wrong data VALUE is received.
 * API: 400 Bad Request
 */
class UnexpectedValueException extends RuntimeException implements HttpAwareException {
  public function getHttpStatusCode(): int {
    return 400;
  }
}

/**
 * USE: When an action is forbidden for given actor (although generally valid).
 * API: 403 Forbidden
 */
class AccessDeniedException extends UnexpectedValueException implements HttpAwareException {
  public function getHttpStatusCode(): int {
    return 403;
  }
}

/**
 * USE: When the main resource we're interested in doesn't exist.
 * API: 404 Not Found
 */
class NotFoundException extends UnexpectedValueException implements HttpAwareException {
  public function getHttpStatusCode(): int {
    return 404;
  }
}

/**
 * USE: When the main action produces conflict (i.e. duplicate key).
 * API: 409 Conflict
 */
class ConflictException extends UnexpectedValueException implements HttpAwareException {
  public function getHttpStatusCode(): int {
    return 409;
  }
}

/**
 * USE: An application state that should not occur. Can be subclassed for feature-specific exceptions.
 * API: 500 Server Error (not HTTP-aware)
 */
class InvalidStateException extends RuntimeException {}

class NewsletterProcessingException extends Exception {}

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
Engine DIR	-	drwxr-xr-x	2026-05-29 02:43:21	Edit Download recursive recursive
Integrations DIR	-	drwxr-xr-x	2026-05-29 02:43:21	Edit Download recursive recursive
Validator DIR	-	drwxr-xr-x	2026-05-29 02:43:21	Edit Download recursive recursive
class-bootstrap.php	2.84 KB	lrw-r--r--	2026-05-05 14:26:50	Edit Download recursive recursive
class-container.php	2.31 KB	lrw-r--r--	2025-11-24 23:10:10	Edit Download recursive recursive
class-email-css-inliner.php	2.76 KB	lrw-r--r--	2025-11-24 23:10:10	Edit Download recursive recursive
class-email-editor-container.php	8.73 KB	lrw-r--r--	2026-03-30 17:12:24	Edit Download recursive recursive
class-package.php	732 B	lrw-r--r--	2025-06-23 19:46:28	Edit Download recursive recursive
exceptions.php	2.81 KB	lrw-r--r--	2025-06-23 19:46:28	Edit Download recursive recursive

Directory Contents