Update exceptions list
authorMatthias Schmidt <gravatronics@live.com>
Tue, 12 Jan 2021 10:50:24 +0000 (11:50 +0100)
committerMatthias Schmidt <gravatronics@live.com>
Tue, 12 Jan 2021 10:50:24 +0000 (11:50 +0100)
Close #116

docs/php/exceptions.md

index 6508fcf601afe982a4fb2915d5d34f825132dab3..db0e68d0fbb0f1666664cfdf46119b6bc05f41e2 100644 (file)
@@ -10,13 +10,15 @@ The [Standard PHP Library (SPL)](https://secure.php.net/manual/en/book.spl.php)
 !!! warning "Do not use `wcf\system\exception\SystemException` anymore, use specific exception classes!"
 
 The following table contains a list of custom exceptions that are commonly used.
+All of the exceptions are found in the `wcf\system\exception` namespace.
 
-| exception | (examples) when to use |
+| Class name | (examples) when to use |
 |-----------|------------------------|
-| `wcf\system\exception\IllegalLinkException` | access to a page that belongs to a non-existing object, executing actions on specific non-existing objects (is shown as http 404 error to the user) |
-| `wcf\system\exception\ImplementationException` | a class does not implement an expected interface |
-| `wcf\system\exception\InvalidObjectTypeException` | object type is not of an expected object type definition |
-| `wcf\system\exception\InvalidSecurityTokenException` | given security token does not match the security token of the active user's session |
-| `wcf\system\exception\ParentClassException` | a class does not extend an expected (parent) class |
-| `wcf\system\exception\PermissionDeniedException` | page access without permission, action execution without permission (is shown as http 403 error to the user) |
-| `wcf\system\exception\UserInputException` | user input does not pass validation |
+| `IllegalLinkException` | access to a page that belongs to a non-existing object, executing actions on specific non-existing objects (is shown as http 404 error to the user) |
+| `ImplementationException` | a class does not implement an expected interface |
+| `InvalidObjectArgument` | <span class="label label-info">5.4+</span> API method support generic objects but specific implementation requires objects of specific (sub)class and different object is given |
+| `InvalidObjectTypeException` | object type is not of an expected object type definition |
+| `InvalidSecurityTokenException` | given security token does not match the security token of the active user's session |
+| `ParentClassException` | a class does not extend an expected (parent) class |
+| `PermissionDeniedException` | page access without permission, action execution without permission (is shown as http 403 error to the user) |
+| `UserInputException` | user input does not pass validation |