Send out a given mail via a web form. A running live-demo is deployed at https://mailform.aiki-it.de
Allows sending mails to a configured and given mail address.
Project requires at least PHP 7.3 in order to run with PHPUnit 9.x.
Depending on your installation you may need to install a more recent PHP version, as I had to do on Ubuntu 18.0.4 LTS: https://tecadmin.net/install-php-7-on-ubuntu/
- Upgrade to PHP 7.4
sudo apt-get install -y php7.4
- Additional modules:
sudo apt-get install -y php7.4-xml php7.4-mbstring php7.4-mysql php7.4-intl php7.4-sqlite3 php-xdebug sqlite3
$ brew install php@7.4
In case you have older versions of PHP installed follow this cleanup procedure: https://medium.com/@romaninsh/install-php-7-2-xdebug-on-macos-high-sierra-with-homebrew-july-2018-d7968fe7e8b8
If you have multiple PHP versions and need to switch per project you may need this:
$ brew install brew-php-switcher
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '48e3236262b34d30969dca3c37281b3b4bbe3221bda826ac6a9a62d6444cdb0dcd0615698a5cbe587c3f0fe57a54d8f5') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
Above example was performed with version 1.8.4.
$ ./composer.phar init
tbd: https://getcomposer.org/doc/01-basic-usage.md#introduction
following https://blog.nikolaposa.in.rs/2017/01/16/on-structuring-php-projects/
bin/ # command-line executables
config/ # configuration files
public/ # web server files, assets
resources/ # other resource files
src/ # PHP source code
templates/ # view and layout files
tests/ # test code
https://phpunit.de/getting-started/phpunit-9.html
$ composer require --dev phpunit/phpunit ^9 (needs a modern PHP)
In order to integrate PHPMailer you may want to run:
$ composer require phpmailer/phpmailer
The mail form web template is based on Html5UP ReadOnly which is available under Creative Commons Attribution 3.0 Unported
The used favicon House is taken from FreeFavicon.
This application can be configured if used in you own context. Please copy the given template mailform-config.php.template to mailform-config.php in the config-directory.
With a more recent Docker setup you may simply run:
$ docker-compose up
If you see something like:
Recreating mailform_php-apache_1 ... done
Attaching to mailform_php-apache_1
....
you are ready to visit http://localhost:8888 to see the application up and running.
In case you need to tweak PHP settings: http://localhost:8888/phpinfo.php might be of use - please remove this file in production deployments!
In order to run the dockerized version on Ubuntu you may follow this installation instruction (please do not forget the postinstallation steps to be able to run as non-root).
- https://docs.docker.com/install/linux/docker-ce/ubuntu/ - preferred way on Ubuntu 18.04 as newer versions are supported
- https://linuxconfig.org/how-to-create-a-docker-based-lamp-stack-using-docker-compose-on-ubuntu-18-04-bionic-beaver-linux
- https://hub.docker.com/_/php
HINT! Even if you enable mail sending this will not work from within the container - you need to deploy the application first :-)