Merge pull request pterodactyl#1148 from pterodactyl/feature/doc-block-improvements

@throws docblock improvements

Author: DaneEveritt

app/Console/Commands/Environment/EmailSettingsCommand.php

@@ -59,6 +59,7 @@ public function __construct(ConfigRepository $config)
 
     /**
      * Handle command execution.
+     * @throws \Pterodactyl\Exceptions\PterodactylException
      */
     public function handle()
     {

app/Http/Controllers/Admin/ApiController.php

@@ -65,6 +65,7 @@ public function index(Request $request): View
      * Render view allowing an admin to create a new application API key.
      *
      * @return \Illuminate\View\View
+     * @throws \ReflectionException
      */
     public function create(): View
     {

app/Http/Controllers/Admin/LocationController.php

@@ -103,7 +103,6 @@ public function view($id)
      * @return \Illuminate\Http\RedirectResponse
      *
      * @throws \Throwable
-     * @throws \Watson\Validating\ValidationException
      */
     public function create(LocationFormRequest $request)
     {
@@ -121,7 +120,6 @@ public function create(LocationFormRequest $request)
      * @return \Illuminate\Http\RedirectResponse
      *
      * @throws \Throwable
-     * @throws \Watson\Validating\ValidationException
      */
     public function update(LocationFormRequest $request, Location $location)
     {

app/Http/Controllers/Admin/Nests/EggVariableController.php

@@ -90,10 +90,11 @@ public function view(int $egg): View
      * Handle a request to create a new Egg variable.
      *
      * @param \Pterodactyl\Http\Requests\Admin\Egg\EggVariableFormRequest $request
-     * @param \Pterodactyl\Models\Egg                                     $egg
+     * @param \Pterodactyl\Models\Egg $egg
      *
      * @return \Illuminate\Http\RedirectResponse
      * @throws \Pterodactyl\Exceptions\Model\DataValidationException
+     * @throws \Pterodactyl\Exceptions\Service\Egg\Variable\BadValidationRuleException
      * @throws \Pterodactyl\Exceptions\Service\Egg\Variable\ReservedVariableNameException
      */
     public function store(EggVariableFormRequest $request, Egg $egg): RedirectResponse

app/Http/Controllers/Admin/ServersController.php

@@ -462,6 +462,7 @@ public function reinstallServer(Server $server)
      *
      * @param \Pterodactyl\Models\Server $server
      * @return \Illuminate\Http\RedirectResponse
+     * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException
      */
     public function rebuildContainer(Server $server)
     {
@@ -536,11 +537,12 @@ public function delete(Request $request, Server $server)
     /**
      * Update the startup command as well as variables.
      *
-     * @param \Illuminate\Http\Request   $request
+     * @param \Illuminate\Http\Request $request
      * @param \Pterodactyl\Models\Server $server
      * @return \Illuminate\Http\RedirectResponse
      *
-     * @throws \Pterodactyl\Exceptions\DisplayException
+     * @throws \Illuminate\Validation\ValidationException
+     * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException
      * @throws \Pterodactyl\Exceptions\Model\DataValidationException
      * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
      */

app/Http/Controllers/Admin/Settings/AdvancedController.php

@@ -76,6 +76,8 @@ public function index(): View
     /**
      * @param \Pterodactyl\Http\Requests\Admin\Settings\AdvancedSettingsFormRequest $request
      * @return \Illuminate\Http\RedirectResponse
+     * @throws \Pterodactyl\Exceptions\Model\DataValidationException
+     * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
      */
     public function update(AdvancedSettingsFormRequest $request): RedirectResponse
     {

app/Http/Controllers/Admin/Settings/IndexController.php

@@ -74,6 +74,8 @@ public function index(): View
      *
      * @param \Pterodactyl\Http\Requests\Admin\Settings\BaseSettingsFormRequest $request
      * @return \Illuminate\Http\RedirectResponse
+     * @throws \Pterodactyl\Exceptions\Model\DataValidationException
+     * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
      */
     public function update(BaseSettingsFormRequest $request): RedirectResponse
     {

app/Http/Controllers/Admin/Settings/MailController.php

@@ -83,7 +83,9 @@ public function index(): View
      * @param \Pterodactyl\Http\Requests\Admin\Settings\MailSettingsFormRequest $request
      * @return \Illuminate\Http\RedirectResponse
      *
-     * @throws \Pterodactyl\Exceptions\DisplayException
+     * @throws DisplayException
+     * @throws \Pterodactyl\Exceptions\Model\DataValidationException
+     * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException
      */
     public function update(MailSettingsFormRequest $request): RedirectResponse
     {

app/Http/Requests/Admin/Api/StoreApplicationApiKeyRequest.php

@@ -10,6 +10,8 @@ class StoreApplicationApiKeyRequest extends AdminFormRequest
 {
     /**
      * @return array
+     * @throws \ReflectionException
+     * @throws \ReflectionException
      */
     public function rules()
     {

app/Models/EggVariable.php

@@ -82,6 +82,7 @@ class EggVariable extends Model implements CleansAttributes, ValidableContract
     ];
 
     /**
+     * @param $value
      * @return bool
      */
     public function getRequiredAttribute($value)