PHPackages                             horde/exception - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. horde/exception

ActiveLibrary[Framework](/categories/framework)

horde/exception
===============

Exception handler library

v3.0.1(1w ago)119.5k—9.2%720LGPL-2.1-onlyPHPPHP ^7.4 || ^8CI failing

Since Jul 31Pushed 1mo ago6 watchersCompare

[ Source](https://github.com/horde/Exception)[ Packagist](https://packagist.org/packages/horde/exception)[ Docs](https://www.horde.org/libraries/Horde_Exception)[ RSS](/packages/horde-exception/feed)WikiDiscussions FRAMEWORK\_6\_0 Synced 2d ago

READMEChangelog (7)Dependencies (7)Versions (21)Used By (20)

Horde Exception
===============

[](#horde-exception)

Exception handling library for the [Horde Project](https://www.horde.org/).

Provides a set of exception base classes that integrate with the Horde framework. All exceptions implement `HordeThrowable` (details support) and `LogThrowable` (log-level tracking), and extend PHP's SPL exception hierarchy for proper semantic categorisation.

Installation
------------

[](#installation)

```
composer require horde/exception
```

Quick Start
-----------

[](#quick-start)

```
use Horde\Exception\HordeRuntimeException;
use Horde\Exception\HordeThrowable;

// Throw a typed exception
throw new HordeRuntimeException('Connection failed', 0, $previous);

// Catch any Horde exception via the interface
try {
    // ...
} catch (HordeThrowable $e) {
    echo $e->getMessage();
    echo $e->getDetails();
}
```

Choosing an Exception Base Class
--------------------------------

[](#choosing-an-exception-base-class)

Error typeBase classRuntime / I/O failure`HordeRuntimeException`Invalid argument from caller`HordeInvalidArgumentException`Programmer logic error`HordeLogicException`Domain rule violation`HordeDomainException`Resource not found`NotFound`Permission denied`PermissionDenied`Generic / uncategorised`HordeException`Component exceptions should extend the SPL-based class that best fits (e.g. `class CacheException extends HordeRuntimeException {}`).

See [doc/USAGE.md](doc/USAGE.md) for the full use-case table, guidance on `Wrapped` vs standard exceptions, and component exception patterns.

Documentation
-------------

[](#documentation)

- **[doc/USAGE.md](doc/USAGE.md)** — Choosing the right base class, the `Wrapped` pitfall, creating component exceptions
- **[doc/UPGRADING.md](doc/UPGRADING.md)** — Migrating from PSR-0 to PSR-4, class mapping table, breaking changes

License
-------

[](#license)

LGPL-2.1-only. See [LICENSE](LICENSE) for details.

###  Health Score

61

—

FairBetter than 98% of packages

Maintenance94

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community44

Growing community involvement

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 67.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~266 days

Recently: every ~24 days

Total

16

Last Release

9d ago

Major Versions

2.0.8 → 3.0.0alpha12021-02-24

PHP version history (5 changes)2.0.6PHP >=5.3.0,<=6.0.0alpha1

2.0.7PHP >=5.3.0,<=8.0.0alpha1

3.0.0alpha1PHP ^7

v3.0.0alpha4PHP ^7 || ^8

v3.0.0alpha5PHP ^7.4 || ^8

### Community

Maintainers

![](https://www.gravatar.com/avatar/c943a083635c28520599075eaea7ede2d743b7697b76e84d6bdc37e52cc8249b?d=identicon)[yunosh](/maintainers/yunosh)

![](https://www.gravatar.com/avatar/c931cd02664859360478593450d6c473a05bb12b209dfacfc534cd13257cc7ef?d=identicon)[ralflang](/maintainers/ralflang)

![](https://www.gravatar.com/avatar/e4f6c6771993db2ed500959b42353f6cf6a2ca0406d9617f7ae680f4504faa4a?d=identicon)[horde](/maintainers/horde)

![](https://www.gravatar.com/avatar/a7767adb66b45f2f05bcd44d49bc4e67efacd9ce05b161ce2d481d5dd6af025c?d=identicon)[mrubinsk](/maintainers/mrubinsk)

![](https://www.gravatar.com/avatar/816e2b926f25f8cd2939054c7a7173011b4303d690e25ab61bf33cf8c7cf71ae?d=identicon)[tdannhauer](/maintainers/tdannhauer)

---

Top Contributors

[![yunosh](https://avatars.githubusercontent.com/u/379318?v=4)](https://github.com/yunosh "yunosh (178 commits)")[![ralflang](https://avatars.githubusercontent.com/u/646976?v=4)](https://github.com/ralflang "ralflang (43 commits)")[![wrobel](https://avatars.githubusercontent.com/u/10232?v=4)](https://github.com/wrobel "wrobel (18 commits)")[![slusarz](https://avatars.githubusercontent.com/u/381003?v=4)](https://github.com/slusarz "slusarz (10 commits)")[![mrubinsk](https://avatars.githubusercontent.com/u/66822?v=4)](https://github.com/mrubinsk "mrubinsk (8 commits)")[![renan](https://avatars.githubusercontent.com/u/28046?v=4)](https://github.com/renan "renan (3 commits)")[![thomasjfox](https://avatars.githubusercontent.com/u/1146758?v=4)](https://github.com/thomasjfox "thomasjfox (1 commits)")[![TDannhauer](https://avatars.githubusercontent.com/u/6716033?v=4)](https://github.com/TDannhauer "TDannhauer (1 commits)")

---

Tags

frameworksplpear\_error

### Embed Badge

![Health badge](/badges/horde-exception/health.svg)

```
[![Health](https://phpackages.com/badges/horde-exception/health.svg)](https://phpackages.com/packages/horde-exception)
```

###  Alternatives

[hemp/presenter

Easy Model Presenters in Laravel

247616.4k1](/packages/hemp-presenter)[pestphp/pest-plugin-stressless

Stressless plugin for Pest

681.0M18](/packages/pestphp-pest-plugin-stressless)[wpstarter/framework

The WpStarter Framework - Laravel Framework for WordPress

1610.2k5](/packages/wpstarter-framework)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)