2015-04-02 21:09:56 +08:00
|
|
|
Yii 2 Basic Project Template
|
|
|
|
============================
|
2013-05-24 22:14:49 +08:00
|
|
|
|
2015-04-02 21:09:56 +08:00
|
|
|
Yii 2 Basic Project Template is a skeleton [Yii 2](http://www.yiiframework.com/) application best for
|
2014-02-16 00:57:11 +08:00
|
|
|
rapidly creating small projects.
|
2013-05-24 22:14:49 +08:00
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
The template contains the basic features including user login/logout and a contact page.
|
|
|
|
It includes all commonly used configurations that would allow you to focus on adding new
|
|
|
|
features to your application.
|
2013-05-24 22:14:49 +08:00
|
|
|
|
2015-03-23 03:19:01 +08:00
|
|
|
[![Latest Stable Version](https://poser.pugx.org/yiisoft/yii2-app-basic/v/stable.png)](https://packagist.org/packages/yiisoft/yii2-app-basic)
|
|
|
|
[![Total Downloads](https://poser.pugx.org/yiisoft/yii2-app-basic/downloads.png)](https://packagist.org/packages/yiisoft/yii2-app-basic)
|
|
|
|
[![Build Status](https://travis-ci.org/yiisoft/yii2-app-basic.svg?branch=master)](https://travis-ci.org/yiisoft/yii2-app-basic)
|
2013-05-24 22:14:49 +08:00
|
|
|
|
|
|
|
DIRECTORY STRUCTURE
|
|
|
|
-------------------
|
|
|
|
|
2014-01-16 19:56:26 +08:00
|
|
|
assets/ contains assets definition
|
2013-05-24 22:14:49 +08:00
|
|
|
commands/ contains console commands (controllers)
|
|
|
|
config/ contains application configurations
|
|
|
|
controllers/ contains Web controller classes
|
2014-02-13 04:01:01 +08:00
|
|
|
mail/ contains view files for e-mails
|
2013-05-24 22:14:49 +08:00
|
|
|
models/ contains model classes
|
|
|
|
runtime/ contains files generated during runtime
|
2014-01-16 19:56:26 +08:00
|
|
|
tests/ contains various tests for the basic application
|
2013-05-24 22:14:49 +08:00
|
|
|
vendor/ contains dependent 3rd-party packages
|
|
|
|
views/ contains view files for the Web application
|
2013-07-25 19:57:49 +08:00
|
|
|
web/ contains the entry script and Web resources
|
2013-05-24 22:14:49 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
REQUIREMENTS
|
|
|
|
------------
|
|
|
|
|
2015-04-02 21:09:56 +08:00
|
|
|
The minimum requirement by this project template that your Web server supports PHP 5.4.0.
|
2013-05-24 22:14:49 +08:00
|
|
|
|
|
|
|
|
|
|
|
INSTALLATION
|
|
|
|
------------
|
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
### Install from an Archive File
|
2013-05-24 22:14:49 +08:00
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
Extract the archive file downloaded from [yiiframework.com](http://www.yiiframework.com/download/) to
|
|
|
|
a directory named `basic` that is directly under the Web root.
|
2013-05-24 22:14:49 +08:00
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
You can then access the application through the following URL:
|
2013-05-24 22:14:49 +08:00
|
|
|
|
|
|
|
~~~
|
2013-12-02 01:17:58 +08:00
|
|
|
http://localhost/basic/web/
|
2013-05-24 22:14:49 +08:00
|
|
|
~~~
|
|
|
|
|
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
### Install via Composer
|
2013-05-24 22:14:49 +08:00
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
If you do not have [Composer](http://getcomposer.org/), you may install it by following the instructions
|
|
|
|
at [getcomposer.org](http://getcomposer.org/doc/00-intro.md#installation-nix).
|
2013-06-04 00:22:59 +08:00
|
|
|
|
2015-04-02 21:09:56 +08:00
|
|
|
You can then install this project template using the following command:
|
2013-06-04 00:22:59 +08:00
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
~~~
|
2015-05-06 22:18:56 +08:00
|
|
|
php composer.phar global require "fxp/composer-asset-plugin:~1.0.0"
|
2015-02-27 07:25:54 +08:00
|
|
|
php composer.phar create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
|
2013-12-02 01:17:58 +08:00
|
|
|
~~~
|
2013-06-04 00:22:59 +08:00
|
|
|
|
2013-12-02 01:17:58 +08:00
|
|
|
Now you should be able to access the application through the following URL, assuming `basic` is the directory
|
|
|
|
directly under the Web root.
|
2013-06-04 00:22:59 +08:00
|
|
|
|
|
|
|
~~~
|
2013-12-02 01:17:58 +08:00
|
|
|
http://localhost/basic/web/
|
2013-06-04 00:22:59 +08:00
|
|
|
~~~
|
|
|
|
|
2014-01-16 19:56:26 +08:00
|
|
|
|
|
|
|
CONFIGURATION
|
|
|
|
-------------
|
|
|
|
|
|
|
|
### Database
|
|
|
|
|
|
|
|
Edit the file `config/db.php` with real data, for example:
|
|
|
|
|
|
|
|
```php
|
|
|
|
return [
|
2014-05-23 22:51:38 +08:00
|
|
|
'class' => 'yii\db\Connection',
|
|
|
|
'dsn' => 'mysql:host=localhost;dbname=yii2basic',
|
|
|
|
'username' => 'root',
|
|
|
|
'password' => '1234',
|
|
|
|
'charset' => 'utf8',
|
2014-01-16 19:56:26 +08:00
|
|
|
];
|
|
|
|
```
|
|
|
|
|
|
|
|
**NOTE:** Yii won't create the database for you, this has to be done manually before you can access it.
|
|
|
|
|
|
|
|
Also check and edit the other files in the `config/` directory to customize your application.
|