Add missing @throws in phpDocs

Author: Dominik Schmelz

src/Controller/Controller.php

@@ -881,6 +881,7 @@ public function paginate($object = null, array $settings = [])
      *
      * @param string $action The action to check.
      * @return bool Whether or not the method is accessible from a URL.
+     * @throws ReflectionException
      */
     public function isAction($action)
     {

src/Core/ObjectRegistry.php

@@ -70,6 +70,7 @@ abstract class ObjectRegistry implements Countable, IteratorAggregate
      * @param string $objectName The name/class of the object to load.
      * @param array $config Additional settings to use when loading the object.
      * @return mixed
+     * @throws \Exception
      */
     public function load($objectName, $config = [])
     {
@@ -337,6 +338,7 @@ public function set($objectName, $object)
      *
      * @param string $objectName The name of the object to remove from the registry.
      * @return $this
+     * @throws \Exception
      */
     public function unload($objectName)
     {

src/Core/Retry/CommandRetry.php

@@ -56,6 +56,7 @@ public function __construct(RetryStrategyInterface $strategy, $retries = 1)
      *
      * @param callable $action The callable action to execute with a retry strategy
      * @return mixed The return value of the passed action callable
+     * @throws Exception
      */
     public function run(callable $action)
     {

src/Database/Connection.php

@@ -268,6 +268,7 @@ public function isConnected()
      *
      * @param string|\Cake\Database\Query $sql The SQL to convert into a prepared statement.
      * @return \Cake\Database\StatementInterface
+     * @throws Exception
      */
     public function prepare($sql)
     {
@@ -290,6 +291,7 @@ public function prepare($sql)
      * @param array $params list or associative array of params to be interpolated in $query as values
      * @param array $types list or associative array of types to be used for casting values in query
      * @return \Cake\Database\StatementInterface executed statement
+     * @throws Exception
      */
     public function execute($query, array $params = [], array $types = [])
     {
@@ -325,6 +327,7 @@ public function compileQuery(Query $query, ValueBinder $generator)
      *
      * @param \Cake\Database\Query $query The query to be executed
      * @return \Cake\Database\StatementInterface executed statement
+     * @throws Exception
      */
     public function run(Query $query)
     {
@@ -342,6 +345,7 @@ public function run(Query $query)
      *
      * @param string $sql The SQL query to execute.
      * @return \Cake\Database\StatementInterface
+     * @throws Exception
      */
     public function query($sql)
     {
@@ -421,6 +425,7 @@ public function schemaCollection(SchemaCollection $collection = null)
      * @param array $data values to be inserted
      * @param array $types list of associative array containing the types to be used for casting
      * @return \Cake\Database\StatementInterface
+     * @throws Exception
      */
     public function insert($table, array $data, array $types = [])
     {
@@ -442,6 +447,7 @@ public function insert($table, array $data, array $types = [])
      * @param array $conditions conditions to be set for update statement
      * @param array $types list of associative array containing the types to be used for casting
      * @return \Cake\Database\StatementInterface
+     * @throws Exception
      */
     public function update($table, array $data, array $conditions = [], $types = [])
     {
@@ -460,6 +466,7 @@ public function update($table, array $data, array $conditions = [], $types = [])
      * @param array $conditions conditions to be set for delete statement
      * @param array $types list of associative array containing the types to be used for casting
      * @return \Cake\Database\StatementInterface
+     * @throws Exception
      */
     public function delete($table, $conditions = [], $types = [])
     {
@@ -474,6 +481,7 @@ public function delete($table, $conditions = [], $types = [])
      * Starts a new transaction.
      *
      * @return void
+     * @throws Exception
      */
     public function begin()
     {
@@ -676,6 +684,7 @@ public function rollbackSavepoint($name)
      * Run driver specific SQL to disable foreign key checks.
      *
      * @return void
+     * @throws Exception
      */
     public function disableForeignKeys()
     {
@@ -688,6 +697,7 @@ public function disableForeignKeys()
      * Run driver specific SQL to enable foreign key checks.
      *
      * @return void
+     * @throws Exception
      */
     public function enableForeignKeys()
     {

src/Error/BaseErrorHandler.php

@@ -162,6 +162,7 @@ public function handleError($code, $description, $file = null, $line = null, $co
      *
      * @param \Exception|\Error $exception The exception to handle
      * @return void
+     * @throws Exception
      */
     public function wrapAndHandleException($exception)
     {
@@ -210,6 +211,7 @@ protected function _stop($code)
      * @param string $file File on which error occurred
      * @param int $line Line that triggered the error
      * @return bool
+     * @throws Exception
      */
     public function handleFatalError($code, $description, $file, $line)
     {

src/Error/Middleware/ErrorHandlerMiddleware.php

@@ -110,6 +110,7 @@ public function __invoke($request, $response, $next)
      * @param \Psr\Http\Message\ServerRequestInterface $request The request.
      * @param \Psr\Http\Message\ResponseInterface $response The response.
      * @return \Psr\Http\Message\ResponseInterface A response
+     * @throws Exception
      */
     public function handleException($exception, $request, $response)
     {

src/Http/ControllerFactory.php

@@ -30,6 +30,7 @@ class ControllerFactory
      * @param \Cake\Http\ServerRequest $request The request to build a controller for.
      * @param \Cake\Http\Response $response The response to use.
      * @return \Cake\Controller\Controller
+     * @throws \ReflectionException
      */
     public function create(ServerRequest $request, Response $response)
     {

src/Http/Cookie/CookieCollection.php

@@ -248,6 +248,7 @@ public function addToRequest(RequestInterface $request, array $extraCookies = []
      * @param string $host The host to match.
      * @param string $path The path to match
      * @return array An array of cookie name/value pairs
+     * @throws \Exception
      */
     protected function findMatchingCookies($scheme, $host, $path)
     {
@@ -334,6 +335,7 @@ protected function setRequestDefaults(array $cookies, $host, $path)
      *
      * @param array $values List of Set-Cookie Header values.
      * @return \Cake\Http\Cookie\Cookie[] An array of cookie objects
+     * @throws \Exception
      */
     protected static function parseSetCookieHeader($values)
     {
@@ -396,6 +398,7 @@ protected static function parseSetCookieHeader($values)
      * @param string $host The host to check for expired cookies on.
      * @param string $path The path to check for expired cookies on.
      * @return void
+     * @throws \Exception
      */
     protected function removeExpiredCookies($host, $path)
     {

src/I18n/Formatter/IcuFormatter.php

@@ -33,6 +33,8 @@ class IcuFormatter implements FormatterInterface
      * @param string|array $message The message to be translated
      * @param array $vars The list of values to interpolate in the message
      * @return string The formatted message
+     * @throws CannotFormat
+     * @throws CannotInstantiateFormatter
      */
     public function format($locale, $message, array $vars)
     {

src/I18n/I18n.php

@@ -195,6 +195,7 @@ public static function setTranslator($name, callable $loader, $locale = null)
      * @param string $name The domain of the translation messages.
      * @param string|null $locale The locale for the translator.
      * @return \Aura\Intl\TranslatorInterface The configured translator.
+     * @throws \Aura\Intl\Exception
      */
     public static function getTranslator($name = 'default', $locale = null)
     {