Installation

• Get Emvicy
• Initialize Emvicy
• Requirements

Get Emvicy

make sure that your machine has PHP >=8.0 installed (see Requirements).

Installation :: preferred method 🗸

clone the 1.x repository branch - this way you have the possibility to perform patch-level updates that are available for this branch (requires git to be installed).

command

git clone --branch 1.x https://github.com/Emvicy/Emvicy.git Emvicy_1.x;

🛈 the repository url for this version is: https://github.com/Emvicy/Emvicy/tree/1.x

see complete installation video

Installation :: alternative methods

• get Emvicy 1.x branch head: 📥 https://github.com/Emvicy/Emvicy/archive/refs/heads/1.x.zip
• get the latest stable Emvicy Release of Emvicy (🛈 latest stable Releases may be relate on other branches than 1.x)
  • Go to download page: https://github.com/Emvicy/Emvicy/releases/latest

Initialize Emvicy

cd into the root folder of Emvicy and run emvicy

cd Emvicy_1.x/; 
php emvicy

• A new Environment config file /.env will be created automatically containing MVC_ENV=develop (see /1.x/configuration#Environment).
• The Auto-Installer begins to install all necessary files. (In case of errors, a text will prompt up showing details about what went wrong). This may take a moment.

Example output

setup checking
• MVC_ENV is: develop
• User/Group from /public/index.php: admin1(1000) / admin1(1000)
• Installing required Main Application libraries via composer in Background with PID 84623. Please wait.
.......Installation completed.

After that, start Emvicy's local development server.

php emvicy serve

Example output

admin1@erazer:/tmp/foo/Emvicy_1.x$ php emvicy serve
/opt/lampp_8.2.0/bin/php-8.2.0 -S 127.0.0.1:1969 -t ./public/
--------------------------------------------------------------------------------
[Sat Dec  2 11:09:12 2023] PHP 8.2.0 Development Server (http://127.0.0.1:1969) started

Now you can call your application in your web browser at http://127.0.0.1:1969.

You should see this Frontend

Requirements

Operating System

• Linux
• binaries available: sed, find, grep, mv, xargs, rm, ps

PHP

• Version: >=8.2

Also you need some PHP-Extensions installed and PHP-functions enabled as listed below.

Required PHP Extensions

Core
ctype
curl
date
dom
fileinfo
filter
iconv
json
mbstring
Phar
posix
Reflection
session
SimpleXML
standard
SPL
zip

Required PHP Functions

mb_strlen
iconv