Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/songlipeng2003/yii3-demo
https://github.com/songlipeng2003/yii3-demo
Last synced: 5 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/songlipeng2003/yii3-demo
- Owner: songlipeng2003
- License: bsd-3-clause
- Created: 2020-08-09T09:19:42.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-08-09T09:19:55.000Z (over 4 years ago)
- Last Synced: 2024-10-18T09:13:48.336Z (3 months ago)
- Language: PHP
- Size: 77.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
Yii application template
[](https://packagist.org/packages/yiisoft/app)
[](https://packagist.org/packages/yiisoft/app)
[](https://github.com/yiisoft/app/actions)
[](https://scrutinizer-ci.com/g/yiisoft/app/?branch=master)
[](https://scrutinizer-ci.com/g/yiisoft/app/?branch=master)
Yii application template for Yii 3 is best for rapidly creating projects.
## Requirements
The minimum requirement by this project template that your Web server supports PHP 7.4.0.
## Installation
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).
You can then install this project template using the following command:
```
composer create-project --prefer-dist --stability=dev yiisoft/app
```
In order to launch development web server run:
```
composer run serve
```
Now you should be able to access the application through the URL printed to console.
Usually it is `http://localhost:8080`.
## Directory structure
The application template has the following structure:
```
config/ Configuration files.
docs/ Documentation.
public/ Files publically accessible from the Internet.
assets/ Published assets.
index.php Entry script.
resources/ Application resources.
assets/ Asset bundle resources.
layout/ Layout view templates.
view/ View templates.
runtime/ Files generated during runtime.
src/ Application source code.
Asset/ Asset bundle definitions.
Controller/ Web controller classes.
Provider/ Providers that take configuration and configure services.
tests/ A set of Codeception tests for the application.
vendor/ Installed Composer packages.
```
## Configuration
You can find configuration in `config` directory. There are multiple
configs, and the most interesting is `params.php`. Below there are details about its sections:
### Application Services
There are multiple pre-configured application services.
#### Aliases
```php
'aliases' => [
// standard directory aliases
'@root' => dirname(__DIR__),
'@assets' => '@root/public/assets',
'@assetsUrl' => '/assets',
'@npm' => '@root/node_modules',
'@public' => '@root/public',
'@resources' => '@root/resources',
'@runtime' => '@root/runtime',
'@views' => '@root/resources/views'
],
```
See ["Aliases"](https://github.com/yiisoft/docs/blob/master/guide/en/concept/aliases.md) in the guide.
#### Cache
```php
'yiisoft/cache-file' => [
'file-cache' => [
// cache directory path
'path' => '@runtime/cache'
],
],
```
#### Log Target File
```php
use Psr\Log\LogLevel;
'yiisoft/log-target-file' => [
'file-target' => [
// route directory file log
'file' => '@runtime/logs/app.log',
// levels logs target
'levels' => [
LogLevel::EMERGENCY,
LogLevel::ERROR,
LogLevel::WARNING,
LogLevel::INFO,
LogLevel::DEBUG,
],
],
'file-rotator' => [
// maximum file size, in kilo-bytes. Defaults to 10240, meaning 10MB.
'maxfilesize' => 10,
// number of files used for rotation. Defaults to 5.
'maxfiles' => 5,
// the permission to be set for newly created files.
'filemode' => null,
// Whether to rotate files by copy and truncate in contrast to rotation by renaming files.
'rotatebycopy' => null
],
],
```
See ["Logging"](https://github.com/yiisoft/docs/blob/master/guide/en/runtime/logging.md) in the guide.
#### Session
```php
'yiisoft/yii-web' => [
'session' => [
// options for cookies
'options' => ['cookie_secure' => 0],
// session handler
'handler' => null
],
],
```
#### View
```php
'yiisoft/view' => [
// Custom parameters that are shared among view templates.
'defaultParameters' => [
'applicationParameters' => 'App\ApplicationParameters',
'assetManager' => 'Yiisoft\Assets\AssetManager',
],
'theme' => [
// Apply pathMap example: ['@resources/layout' => '@resources/theme'] in yiisoft/app
// Apply pathMap example: ['@resources/layout' => '@modulealiases/theme'] in module
'pathMap' => [],
'basePath' => '',
'baseUrl' => '',
],
],
```
#### Yii Debug
```php
'yiisoft/yii-debug' => [
// enabled/disabled debugger
'enabled' => true
],
```
#### Application Layout Parameters
```php
'app' => [
'charset' => 'UTF-8',
'language' => 'en',
'name' => 'My Project',
],
```
## Testing
The template comes with ready to use [Codeception](https://codeception.com/) configuration.
In order to execute tests run:
```
composer run serve > ./runtime/yii.log 2>&1 &
vendor/bin/codecept run
```