This is a PHP app that generates HTML forms from YAML descriptions.
It can save and/or email the submitted data.
This is the default behavior of the app. The goal is to gather user-specific data. The initial submissions may be incomplete and can be updated at a later time without the need for additional authentication mechanisms or databases.
Each form is accessed via a direct link, which contains the form ID (form directory).
If the save button is disabled in form configuration, no data is persisted. Each submission is completely independent of each other. Multiple users can safely access the same form.
All forms are served from subdirectories of data/.
Create a config.yaml file in a <data-subdirectory>. The form will be available at: https://your.server/<data-subdirectory>
When the user submits the form, all input values are saved in the form directory as values.yaml If the user clicked on send and all the inputs are valid, an email is sent to configured addresses.
The reference details all available options. A demo form is provided as EXAMPLE directory.
- PHP 8.2
- mail server
- The YAML files are not validated. You will see no warnings if your configuration cannot be translated into an HTML form.
End users can simply download the current release formserver.zip.
Unzip the file and point your PHP enabled webserver to the public directory. For Apache a rewrite configuration is provided in a .htaccess file. Users of other webservers may need to setup URL rewriting manually.
You may need to adjust existing form configuration files to accommodate the following changes:
- Field names may no longer include
-. This was a recommemded word separator in previous versions. Now all mathematical symbols are not allowed in field names, as it will break conditional visibility logic. tablestylefieldsets are no longer supported. Use the new table element instead.cloneproperty of fields is no longer supported. Use the new clone container to wrap cloneable fields.
Long forms can now be split into tabbed pages.
Clone the repository, install dependencies and build:
composer install
npm install
npm run buildYou can test run on the built-in PHP server
composer start