. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Http\RequestHandlers; use Fisharebest\Webtrees\Auth; use Fisharebest\Webtrees\Contracts\UserInterface; use Fisharebest\Webtrees\Exceptions\HttpAccessDeniedException; use Fisharebest\Webtrees\Exceptions\HttpNotFoundException; use Fisharebest\Webtrees\Services\ModuleService; use Psr\Http\Message\ResponseInterface; use Psr\Http\Message\ServerRequestInterface; use Psr\Http\Server\RequestHandlerInterface; use function call_user_func; use function method_exists; use function str_contains; use function strtolower; /** * Controller for module actions. */ class ModuleAction implements RequestHandlerInterface { /** @var ModuleService */ private $module_service; /** * @param ModuleService $module_service */ public function __construct(ModuleService $module_service) { $this->module_service = $module_service; } /** * Perform an HTTP action for one of the modules. * * @param ServerRequestInterface $request * * @return ResponseInterface */ public function handle(ServerRequestInterface $request): ResponseInterface { $module_name = $request->getAttribute('module'); $action = $request->getAttribute('action'); $user = $request->getAttribute('user'); assert($user instanceof UserInterface); // Check that the module is enabled. // The module itself will need to check any tree-level access, // which may be different for each component (tab, menu, etc.) of the module. $module = $this->module_service->findByName($module_name); if ($module === null) { throw new HttpNotFoundException('Module ' . $module_name . ' does not exist'); } // We'll call a function such as Module::getFooBarAction() $verb = strtolower($request->getMethod()); $method = $verb . $action . 'Action'; // Actions with "Admin" in the name are for administrators only. if (str_contains($action, 'Admin') && !Auth::isAdmin($user)) { throw new HttpAccessDeniedException('Admin only action'); } if (!method_exists($module, $method)) { throw new HttpNotFoundException('Method ' . $method . '() not found in ' . $module_name); } return call_user_func([$module, $method], $request); } }