Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
126 lines (92 sloc) 3.6 KB
layout title redirect
documentation.twig
Installation
2.1
start/getting-started

Installation

System Requirement

Windwalker 3.x requires PHP 5.6 or later.

Starter Application

Install via Composer

$ composer create-project windwalker/starter project_dir ~3.0

After project file downloaded, the installation script will ask you some information to initial system environment.

> Windwalker\Composer\StarterInstaller::rootInstall

Salt to generate secret [Windwalker-577f076209eff]:
Auto created secret key.

Do you want to use database? [Y/n]: y

Database driver only support mysql/postgresql now.
Database driver [mysql]:
Database host [localhost]:
Database name [acme]: db_name
Database user [root]: db_user
Database password: ******
Table prefix [wind_]:

Database config setting complete.

Install complete.

The Starter package is a default application help us start a project.

Use Windwalker as Library

If you just want to use Windwalker as a library, add windwalker/framework as your project's dependencies in composer.json.

{
    "require": {
        "windwalker/framework": "~3.0"
    }
}

~3.0 is equivalent to 3.0 to 3.9

You can also pick any child packages rather than the complete framework set. This is an example to install Session and Form package:

{
    "require": {
        "windwalker/session": "~3.0",
        "windwalker/form": "~3.0"
    }
}

See all available packages on Packagist

Overview

Open Windwalker Public Root

After installed, use browser open /www then you will see default landing page.

img

File Structure

Name Description
/bin All executable files, there is a console file can run Windwalker Console.
/etc All configuration and routing files.
-- app/*.php Basic config files for different environments.
-- package/*.php Config files for every packages.
-- define.php The system path constants.
-- config.yml Basic configuration file.
-- secret.dist.yml Contains some secret information like DB account.
Please rename to secret.yml before use.
-- routing.yml The routing configuration file.
/resources Some non-PHP or non-classes files.
-- languages Language files, default is .ini format
-- migrations Database migration files. See Migration
-- seeders Database seeder files. See Seeder
/src All PHP classes in your project.
/templates Layout and template files.
/vendor All 3rd party libraries.
/www Web public root (or /public in general)
-- asset Web front-end assets (image, vedio, css, etc..)
-- .htaccess Htaccess config for Apache, you need this file to make mod_rewrite work.
-- index.php Default web application entrance.
-- dev.php Default web application entrance for dev environment.
/phpunit.xml.dist PHPUnit configuration file. Rename to phpunit.xml before use.
/README.md Readme file
/composer.json Composer configuration file
.mode The env mode config file

Apache Alias

If you found Windwalker can not work as expected in Apache Alias, please modify www/.htaccess.

If your Alias is /flower, then uncomment and change:

# RewriteBase /

to

RewriteBase /flower/