Installation 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.


composer create-project znframework/znframework


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.


↓ Download


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


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.


composer create-project znframework/single-edition


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.


composer create-project znframework/custom-edition


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.


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.


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

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


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

    listen 80 default_server;

    root /var/www/html;

    index zeroneed.php;

    error_page 403 /zeroneed.php;

    location / 
        try_files $uri /zeroneed.php?$args;

    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.