# ivyforms/0.8/backend/src/Services/Form/FormService.php

The Innovative Form Builder – IvyForms, version 0.8. 231 lines.

- Page: https://pluginprobe.com/plugins/ivyforms/0.8/code/backend/src/Services/Form/FormService.php
- Raw: https://pluginprobe.com/plugins/ivyforms/0.8/raw/backend/src/Services/Form/FormService.php
- Modified: 2026-01-13T11:11:38+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/ivyforms/0.8/code/backend/src/Services/Form/FormService.php#L10-L20`.

```php
<?php

namespace IvyForms\Services\Form;

// phpcs:disable PSR1.Files.SideEffects
if (!defined('ABSPATH')) {
    exit; // Exit if accessed directly
}

use IvyForms\Common\Exceptions\NotFoundException;
use IvyForms\Common\Exceptions\QueryExecutionException;
use IvyForms\Common\Exceptions\ValidationException;
use IvyForms\Entity\Form\Form;
use IvyForms\Factory\Form\FormFactory;
use IvyForms\Repository\Form\FormRepositoryInterface;
use IvyForms\Services\Translations\BackendStrings;

/**
 * Class FormService
 *
 * @package IvyForms\Services\Form
 *
 * @SuppressWarnings(PHPMD)
 */
class FormService
{
    private FormRepositoryInterface $formRepository;

    // Constructor injection for the FormRepository via PHP-DI
    public function __construct(FormRepositoryInterface $formRepository)
    {
        $this->formRepository = $formRepository;
    }

    /**
     * Get all forms from the repository.
     *
     * @return mixed[]|null
     */
    public function getAllForms(): ?array
    {
        return $this->formRepository->getAll();
    }

    /**
     * Create a new form.
     *
     * @param Form $formData
     *
     * @return int Form ID
     */
    public function createForm(Form $formData): int
    {
        // Create form via repository and return new form ID
        return $this->formRepository->add($formData);
    }

    /**
     * Get a specific form by its ID.
     *
     * @param int $formId
     *
     * @return object FormEntity
     *
     * @throws NotFoundException If the form is not found
     */
    public function getFormById(int $formId): object
    {
        $form = $this->formRepository->getById($formId);

        if (!$form) {
            throw new NotFoundException(
                BackendStrings::getExceptionStrings()['form_not_found']
            );
        }

        return $form;
    }

    /**
     * Update an existing form.
     *
     * @param int $formId
     * @param Form $formData
     *
     * @return bool
     *
     */
    public function updateForm(int $formId, Form $formData): bool
    {
        // Validate form data before updating

        return $this->formRepository->update($formId, $formData);
    }

    /**
     * Update form from params and return tuple [formId, form]
     *
     * @param array<string,mixed> $params
     * @return array{0:int,1:Form}
     * @throws QueryExecutionException|ValidationException
     */
    public function updateFormOrFail(array $params): array
    {
        $form = FormFactory::create($params);
        $formId = $form->getId();
        $this->updateForm($formId, $form);
        if (!$form->getId()) {
            throw new QueryExecutionException(BackendStrings::getAllFormsStrings()['failed_to_update_form'] . '.');
        }
        return [$formId, $form];
    }

    /**
     * Update the starred field of a form.
     *
     * @param int $formId
     * @param mixed $value
     *
     * @return bool
     */
    public function updateFormStarred(int $formId, $value): bool
    {
        return $this->formRepository->updateFormStarred($formId, $value);
    }

    /**
     * Update the published status of a form.
     *
     * @param int $formId
     * @param mixed $value
     *
     * @return bool
     */
    public function updateFormStatus(int $formId, $value): bool
    {
        return $this->formRepository->updateFormStatus($formId, $value);
    }

    /**
     * Delete a form by its ID.
     *
     * @param int $formId
     *
     * @return int
     */
    public function deleteForm(int $formId): int
    {
        return $this->formRepository->delete($formId);
    }

    /**
     * Delete multiple forms by their IDs.
     *
     * @param array<int> $formIds
     *
     * @return int Number of deleted forms
     */
    public function deleteForms(array $formIds): int
    {
        return $this->formRepository->deleteMany($formIds);
    }

    /**
     * Duplicate a form by its ID.
     *
     * @param int $formId
     *
     * @return int New form ID
     *
     * @throws NotFoundException|ValidationException
     * @throws QueryExecutionException
     */
    public function duplicateForm(int $formId): int
    {
        // Retrieve the original form
        $originalForm = $this->getFormById($formId);

        // Duplicate the form's parameters, excluding the ID
        $newFormData = $originalForm->toArray();
        unset($newFormData['id']);
        $newFormData['name'] .= ' (Copy)';
        $newFormId = $this->createForm(FormFactory::create($newFormData));

        if (!$newFormId) {
            throw new QueryExecutionException(BackendStrings::getAllFormsStrings()['failed_to_duplicate_form']);
        }

        return $newFormId;
    }

    /**
     * Check if a form exists by its ID.
     *
     * @param int $formId
     *
     * @return bool
     */
    public function formExists(int $formId): bool
    {
        return $this->formRepository->exists($formId);
    }

    /**
     * Search for forms based on parameters.
     *
     * @param array<string, mixed> $params
     *
     * @return array<mixed>
     */
    public function searchForms(array $params): array
    {
        return $this->formRepository->search($params);
    }

    /**
     * Get the count of form filters.
     *
     * @param bool $shouldGetCount
     *
     * @return array<mixed>
     */
    public function getFilterCount(bool $shouldGetCount): array
    {
        if ($shouldGetCount) {
            return $this->formRepository->getFilterCount();
        }
        return [];
    }
}

```