Commit bcfb1eaf by Carsten Brandt

updated application guide and index

parent d7758146
...@@ -121,7 +121,7 @@ Configuring Composer ...@@ -121,7 +121,7 @@ Configuring Composer
After application template is installed it's a good idea to adjust default `composer.json` that can be found in the root After application template is installed it's a good idea to adjust default `composer.json` that can be found in the root
directory: directory:
```javascript ```json
{ {
"name": "yiisoft/yii2-app-advanced", "name": "yiisoft/yii2-app-advanced",
"description": "Yii 2 Advanced Application Template", "description": "Yii 2 Advanced Application Template",
...@@ -140,7 +140,10 @@ directory: ...@@ -140,7 +140,10 @@ directory:
"require": { "require": {
"php": ">=5.4.0", "php": ">=5.4.0",
"yiisoft/yii2": "dev-master", "yiisoft/yii2": "dev-master",
"yiisoft/yii2-composer": "dev-master" "yiisoft/yii2-swiftmailer": "dev-master",
"yiisoft/yii2-bootstrap": "dev-master",
"yiisoft/yii2-debug": "dev-master",
"yiisoft/yii2-gii": "dev-master"
}, },
"scripts": { "scripts": {
"post-create-project-cmd": [ "post-create-project-cmd": [
...@@ -160,15 +163,13 @@ directory: ...@@ -160,15 +163,13 @@ directory:
] ]
} }
} }
``` ```
First we're updating basic information. Change `name`, `description`, `keywords`, `homepage` and `support` to match First we're updating basic information. Change `name`, `description`, `keywords`, `homepage` and `support` to match
your project. your project.
Now the interesting part. You can add more packages your application needs to `require` section. Now the interesting part. You can add more packages your application needs to `require` section.
For example, to use markdown helper you need to add `michelf/php-markdown`. All these packages are coming from All these packages are coming from [packagist.org](https://packagist.org/) so feel free to browse the website for useful code.
[packagist.org](https://packagist.org/) so feel free to browse the website for useful code.
After your `composer.json` is changed you can run `php composer.phar update`, wait till packages are downloaded and After your `composer.json` is changed you can run `php composer.phar update`, wait till packages are downloaded and
installed and then just use them. Autoloading of classes will be handled automatically. installed and then just use them. Autoloading of classes will be handled automatically.
...@@ -30,6 +30,9 @@ Directory structure ...@@ -30,6 +30,9 @@ Directory structure
The basic application does not divide application directories much. Here's the basic structure: The basic application does not divide application directories much. Here's the basic structure:
- `assets` - application asset files.
- `AppAsset.php` - definition of application assets such as CSS, JavaScript etc. Check [Managing assets](assets.md) for
details.
- `commands` - console controllers. - `commands` - console controllers.
- `config` - configuration. - `config` - configuration.
- `controllers` - web controllers. - `controllers` - web controllers.
...@@ -56,14 +59,12 @@ code repository, add it there. ...@@ -56,14 +59,12 @@ code repository, add it there.
This directory contains configuration files: This directory contains configuration files:
- `AppAsset.php` - definition of application assets such as CSS, JavaScript etc. Check [Managing assets](assets.md) for
details.
- `console.php` - console application configuration. - `console.php` - console application configuration.
- `params.php` - common application parameters. - `params.php` - common application parameters.
- `web.php` - web application configuration. - `web.php` - web application configuration.
- `web-test.php` - web application configuration used when running functional tests. - `web-test.php` - web application configuration used when running functional tests.
All these files except `AppAsset.php` are returning arrays used to configure corresponding application properties. Check All these files are returning arrays used to configure corresponding application properties. Check
[Configuration](configuration.md) guide section for details. [Configuration](configuration.md) guide section for details.
### views ### views
...@@ -111,7 +112,7 @@ Configuring Composer ...@@ -111,7 +112,7 @@ Configuring Composer
After application template is installed it's a good idea to adjust default `composer.json` that can be found in the root After application template is installed it's a good idea to adjust default `composer.json` that can be found in the root
directory: directory:
```javascript ```json
{ {
"name": "yiisoft/yii2-app-basic", "name": "yiisoft/yii2-app-basic",
"description": "Yii 2 Basic Application Template", "description": "Yii 2 Basic Application Template",
...@@ -130,7 +131,10 @@ directory: ...@@ -130,7 +131,10 @@ directory:
"require": { "require": {
"php": ">=5.4.0", "php": ">=5.4.0",
"yiisoft/yii2": "dev-master", "yiisoft/yii2": "dev-master",
"yiisoft/yii2-composer": "dev-master" "yiisoft/yii2-swiftmailer": "dev-master",
"yiisoft/yii2-bootstrap": "dev-master",
"yiisoft/yii2-debug": "dev-master",
"yiisoft/yii2-gii": "dev-master"
}, },
"scripts": { "scripts": {
"post-create-project-cmd": [ "post-create-project-cmd": [
...@@ -153,8 +157,7 @@ First we're updating basic information. Change `name`, `description`, `keywords` ...@@ -153,8 +157,7 @@ First we're updating basic information. Change `name`, `description`, `keywords`
your project. your project.
Now the interesting part. You can add more packages your application needs to `require` section. Now the interesting part. You can add more packages your application needs to `require` section.
For example, to use markdown helper you need to add `michelf/php-markdown`. All these packages are coming from All these packages are coming from [packagist.org](https://packagist.org/) so feel free to browse the website for useful code.
[packagist.org](https://packagist.org/) so feel free to browse the website for useful code.
After your `composer.json` is changed you can run `php composer.phar update`, wait till packages are downloaded and After your `composer.json` is changed you can run `php composer.phar update`, wait till packages are downloaded and
installed and then just use them. Autoloading of classes will be handled automatically. installed and then just use them. Autoloading of classes will be handled automatically.
...@@ -18,7 +18,7 @@ Getting started ...@@ -18,7 +18,7 @@ Getting started
Base concepts Base concepts
============= =============
- [Basic concepts of Yii] - The Object and Component class, Path aliases and autoloading - [Basic concepts of Yii](basics.md) - The Object and Component class, Path aliases and autoloading
- [MVC](mvc.md) - Implementation of MVC in Yii and a typical MVC application flow - [MVC](mvc.md) - Implementation of MVC in Yii and a typical MVC application flow
- [Model](model.md) - The Yii Model provides Attributes, Scenarios and data Validation - [Model](model.md) - The Yii Model provides Attributes, Scenarios and data Validation
- [View](view.md) - Rendering Views applying layouts, using Widgets and asset management - [View](view.md) - Rendering Views applying layouts, using Widgets and asset management
...@@ -46,13 +46,13 @@ Extensions and 3rd party libraries ...@@ -46,13 +46,13 @@ Extensions and 3rd party libraries
================================== ==================================
- [Composer](composer.md) - How to manage applications dependencies via composer - [Composer](composer.md) - How to manage applications dependencies via composer
- [Extending Yii](extension.md) - [Extending Yii](extensions.md)
- [Template engines](template.md) - Using template engines such as Smary or Twig - [Template engines](template.md) - Using template engines such as Smary or Twig
Security and access control Security and access control
=========================== ===========================
- [Authentication](authentication.md) - Identifying User - [Authentication](authentication.md) - Identifying Users
- [Authorization](authorization.md) - Access control and RBAC - [Authorization](authorization.md) - Access control and RBAC
- [Security](security.md) - Hashing and verifying passwords, encryption - [Security](security.md) - Hashing and verifying passwords, encryption
- [Views security](view.md#security) - how to prevent XSS - [Views security](view.md#security) - how to prevent XSS
...@@ -69,6 +69,7 @@ Data providers, lists and grids ...@@ -69,6 +69,7 @@ Data providers, lists and grids
Advanced Topics Advanced Topics
=============== ===============
- [Asset Management](assets.md)
- [Working with forms](form.md) - [Working with forms](form.md)
- [Bootstrap widgets](bootstrap-widgets.md) - Using [twitter bootstrap](http://getbootstrap.com/) - [Bootstrap widgets](bootstrap-widgets.md) - Using [twitter bootstrap](http://getbootstrap.com/)
- [Theming](theming.md) - [Theming](theming.md)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment