fhooe / normform
NormForm is a simple template application for PHP form processing.
Installs: 1 963
Dependents: 1
Suggesters: 0
Security: 0
Stars: 2
Watchers: 5
Forks: 2
Open Issues: 0
Requires
- php: >=7.1
- twig/twig: ^3.0
This package is auto-updated.
Last update: 2023-01-02 10:29:11 UTC
README
NormFom is a simple template application for PHP form processing developed for PHP classes in the program Media Technology and Design at the University of Applied Sciences Upper Austria. It is primarily designed for educational purposes (learning object oriented PHP, form processing and templating languages). Use it for "public" applications at your own risk.
NormForm is designed as a single-page form validation and processing system, meaning that once the form is submitted, the page calls itself again and the process starts anew. It provides an abstract class (AbstractNormForm) which implements a standard form display-validate-business logic process along with classes for form parameter management and display.
Installation
The recommended way to use NormForm in your project is through Composer:
composer require fhooe/normform
Alternatively, you can use the NormForm Skeleton project that gives you a fully working example built upon NormForm (including a template file and CSS):
composer create-project fhooe/normform-skeleton path/to/install
Composer will then create a project in the path/to/install directory.
Basic Usage
To use NormForm create a class that inherits from AbstractNormForm and implement the required abstract methods isValid() (used for form validation) and business() (for business logic, once the form has been successfully submitted). Then create an instance of your new class and call the normForm() method to initiate the process (preferrably in a separate file such as index.php).
Contributing
If you'd like to contribute, please refer to CONTRIBUTING for details.
License
NormForm is licensed under the MIT license. See LICENSE for more information.