Setup Instructions



ZN Framework is a structure that can be set up almost without any setting. However, depending on operating system differences, developers working locally may need to make some apache settings after installing packages like lampp , xampp .

 

# Section Headings


# Requirements
# Installation Steps

# Installation with Composer

# Original Edition
# Full Pack Edition
# Single Edition
# Custom Edition

# Authorization Configurations

# Server Configurations

# Apache
# Nginx 

# Troubleshooting

 

# Requirements


1 - PHP should beat leastversion 7.0.0 .
2 - Apache AllowOverride value None instead of Allow  must be set and mod_rewrite feature must be turned on.
3 - MB String plugin must be installed.

 

# Installation Steps - Fullpack Edition


1 - Click here to download the ZN Framework.
2 - Download the zip file to the root directory of your host.
3 - Type the directory path where you've exported your files to address bar.

Example: localhost/zn/

 

# Composer Installation


Below, there are 4 different distributions you can download for use. Before executing install with Composer, you need to have Composer installed on your server. If it's not installed, follow this link to install it..

Original Edition

It is the original version of ZN Framework. This version also installs other packages.

Setup

composer create-project znframework/znframework

update

composer update

Fullpack Edition

This version is the entire library of ZN Framework, Powerpack and Devtoolspackages. Update operation instead of composer Devtools and Console application.

Setup

↓ Download

update

Update in this version Devtoolsapplication. Devtools `is updated from the following menu.

URL: yoursite.com/Devtools/system/info

Single Edition

This version has the directory structure of any project that belongs to the Projects/ directory in the original version of ZN Framework . If there are not more than one project under the same roof, it may be preferable to use this version due to the simpler directory structure.

Setup

composer create-project znframework/single-edition

update

composer update

Custom Edition

It is the version that allows you to create your own code frame. In this version you design the directory structure by yourself. A version of Single Edition is a customizable version.

Setup

composer create-project znframework/custom-edition

Update

composer update

 

# Authority Configurations


Authorization problems may be encountered in some operating systems because the ZN Framework automatically uses file writing operations. The following shows which settings can be made for which operating system.

Linux

Some local files and directories need to be authorized in the ZN Framework because of local authority problems after installation. For simplicity, you only need to run the following command one time.

sudo chmod -R 777 /var/www/html/{project-directory}

 

# Server Configurations


Below are the configuration contents available for both apache and nginx.

Apache

Usually for Apache /etc/apache/sites-available/000-default.conf The contents of the configuration file located in the path should be as follows.

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html

    <Directory /var/www/html>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Nginx

Usually for Nginx /Etc/nginx/sites-available/default The contents of the configuration file located in the path should be as follows.

server 
{
    listen 80 default_server;

    root /var/www/html;

    index zeroneed.php;

    error_page 403 /zeroneed.php;

    location / 
    {
        try_files $uri /zeroneed.php?$args;
        proxy_pass http://127.0.0.1:80;
    }

    location ~ zeroneed.php$ 
    {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
    }

    location ~ "\/Resources\/\w+\/.*?\.[a-zA-Z0-9]{2,4}$"
    {
        try_files $uri /".*?\/Resources\/";
    }
}

 

# Troubleshooting


If you encounter a different problem during or after installation, you can check available solutions from Troubleshooting page.