Tạo project Yii2 Framework

Chào mừng các bạn đến với chuỗi bài viết về lập trình Yii2 Framework. Để lập trình được Yii2 thì yêu
cầu đầu tiên là các bạn phải biết lập trình php cơ bản nhé.

Yii 2 Framework có 2 bản là Yii2 Basic và Yii2 Advanced. Đầu tiên ta sẽ đi tìm hiểu về Yii2 Basic
trước, sau đó sẽ tìm hiểu về Yii2 Advanced sau.

Đây là phần đầu tiên của chuỗi bài viết về Yii2 Framework bản Basic và tất nhiên để chạy được Yii2
thì ta phải cài đặt Yii2 cái đã. Ở bài viết này mình sẽ hướng dẫn các bạn cài đặt môi trường chạy Yii2
và giới thiệu cấu trúc thư mục của nó. Để cài đặt Yii2 thì do Yii2 là Framework PHP nên yêu cầu về
môi trường chạy cũng như công cụ giống yêu cầu của PHP:

 Máy đã cài Xampp bản XAMPP 5.5.30 

 Đã cài một phần mềm để viết code (Sublime Text, Notepad++, phpDesigner,..) Hiện
mình đang dùng Sublime Text 2. Túm váy lại là có cái để mà viết code là được

Tạm thời là thế đã. Giờ bắt đầu vào tạo project Yii2.
1. Cài đặt Yii 2 

Đầu tiên cần cài đặt Composer. Để tải Composer các bạn có thể chọn nút Download phía dưới nhé.

Cài đặt theo các bước:

(*) Nếu trong quá trình cài đặt gặp lỗi thì hãy vào đâu xem nhé:  Một số lỗi khi cài đặt Composer

Ấn Install và cài đặt cho đến hết. Sau khi cài xong vào thư mục muốn đặt project chuột phải chọn
Use composer here 
Sau đó chạy lệnh 

php -r "readfile('https://getcomposer.org/installer');" | php

Chạy xong sẽ được file composer.phar. Chạy tiếp lệnh

php composer.phar global require "fxp/composer-asset-plugin:^1.2.0"

Cuối cùng chạy lệnh tạo project

php composer.phar create-project yiisoft/yii2-app-basic study-yii2 2.0.11

Lưu ý: Composer sẽ lấy file từ github.com về nên nó sẽ yêu cầu username và password của github,
nên nhớ tạo tài khoản.

Ngồi chờ 1 lúc. Sau khi xong ta được thư mục tên study-yii2. 

assets/ Chứa file asset gọi đến thư viện css và js

commands/ Chứa các lệnh console (chưa cần quan tâm)

config/ Chứa các file cấu hình Yii

controllers/ Chứa các file Controller

mail/ Chứa các file mail (chưa cần quan tâm)

models/ Chứa các file Model

runtime/ Chứa các file log thực thi (chưa cần quan tâm)

tests/ Chứa các file để test (chưa cần quan tâm)

vendor/ Chứa các file thư viện của Yii (chưa cần động đến)

views/ Chứa các file view hiển thị

web/ Chứa các file script (css,js,xml...) và ảnh

Đến đây là ta đã có file Yii2. Tiếp theo là làm sao để chạy

 2. Cấu hình Virtual host

Nếu như ta hay sử dụng url web mặc định của apache là http://localhost/study-yii2/  thì giờ ta sẽ cấu
hình lại url thành http://study-yii2/

Đầu tiên nếu cài Xampp mặc định ở ổ C thì ta tìm theo đường dẫn 

C:\xampp\apache\conf\extra

Tạo 1 file có tên httpd-study-yii2.conf   và ghi vào đó như sau

<VirtualHost *:80>

    DocumentRoot "C:\xampp\htdocs\study-yii2\web"

        ServerName study-yii2

    ErrorLog "logs/study-yii2_error.log"

    CustomLog "logs/study-yii2_access.log" combined

    <Directory "C:\xampp\htdocs\study-yii2\web">

        Options FollowSymLinks Includes ExecCGI

        AllowOverride All

        Require all granted

    </Directory>

</VirtualHost>
Trong đó: 

DocumentRoot "C:\xampp\htdocs\study-yii2\web"

và

<Directory "C:\xampp\htdocs\study-yii2\web">

là đường dẫn đến project Yii2

ServerName study-yii2 là tên domain muốn dùng để trỏ đến project

Những cái khác chưa cần quan tâm.

Tiếp đến tìm file httpd.conf trong thu mục

C:\xampp\apache\conf

Thêm dòng sau vào dòng cuối cùng

Include "conf/extra/httpd-study-yii2.conf" 

Sau đó tìm theo đường dẫn đến thư mục 

C:\Windows\System32\drivers\etc 

Mở file host lên và thêm dòng sau vào dòng cuối cùng (Lưu ý dùng quyền admin để chỉnh sửa file
host nếu không sẽ không save được. Còn nếu không biết cách dùng quyền admin thì GOOGLE) 

127.0.0.1       study-yii2

Đến đây là xong. Khởi động xampp lên và xem thành quả :D
  

Đến đây là coi như xong. Tiếp đến ta có thể tạo link thân thiện như sau (Không bắt buộc nhưng nên
làm)

Ta vào trong project, vào thư mục web. Tạo file .htaccess. Sau đó ghi vào như sau

RewriteEngine on

# If a directory or a file exists, use it directly

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

# Otherwise forward it to index.php

RewriteRule . index.php

Tiếp đến vào config/web.php thêm đoạn này vào. Lưu ý là đặt nó trong phần components, đặt sai vị
trí là ERROR luôn đấy

'urlManager' => [

            'enablePrettyUrl' => true,

            'showScriptName' => false,      

            'rules' => [ 

            ],
        ], 

 Xong, đến đây đã hoàn thành phần tạo project và cấu hình sơ lược qua. Nếu có bất kỳ thắc mắc
hoặc khó khăn trong phần cài đặt các bạn có thể để lại bình luận bên dưới và mình sẽ giải đáp
nhé. Phần tiếp theo sẽ nói về cách kết nối cơ sở dữ liệu trong Yii :)

* Tiến hành cài đặt Yii2 Advanced 

Sau khi cài xong composer, cần chạy lệnh sau để cài đặt composer plusin

php composer.phar global require "fxp/composer-asset-

1 plugin:~1.1.1"

- Bạn gõ vào dòng lệnh sau để download Yii2 về

composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-

1 advanced yii2adv

Trong đó thì "yii2-app-advanced" là phiên bản Yii2 Advanced, còn nếu bạn muốn cài phiên bản Basic thì thay thế
bằng "yii2-app-basic". yii2adv là thư mục web của mình.

- Note : Trong quá trình download, composer sẽ yêu cầu token từ github, bạn nhập token vào nhé. Nếu bạn không
biết lấy token github thì có thể xem ở đây.

2. Cài đặt Yii2 Framework bằng bản Zip

Nếu bạn muốn cài bằng bản Zip, thì bạn down ở đây. Sau đó giải nén vào thư mục project của mình. Khi bạn cài
bằng bản Zip hoặc bằng Composer thì bạn chưa chạy được Yii2 luôn đâu nhé. Bạn cần mở Command Line và gõ vào
lệnh sau

- Truy cập vào mục project của bạn sau đó gõ lệnh Init

- Tiếp theo Yii2 sẽ hỏi bạn muốn dùng trên Production hay Development, bạn tùy chọn 0 hoặc 1 sau đó chọn Yes
nhé. Ở đây mình chọn 0

Việc ta gõ lệnh init là để generate ra một số file common/config/main.php và web/index.php, mặc định khi down yii2
về thì không có sẵn các file này nên chúng ta phải chạy lệnh init để tạo ra các file này.

Chờ đến khi chạy xong, ta sẽ thấy thư mục yii2adv trong thư mục xampp/htdocs chứa source của Yii2 Advanced như
sau
- Với cấu trúc của Yii2 Adv thì đã phân cấp thành hai phần là Backend và Frontend rõ ràng

- Common là thư mục cấu hình database, chứa các model chung cho cả backend và frontend.
- Console là thự mục chạy bacth, chẳng hạn khi nào bạn muốn hẹn giờ để tự động chạy một chức năng nào đó
- Vendor là thư mục core của Yii2, chứa các extensions mở rộng

* Chạy Yii2 trên browse 

1 http://localhost/yii2adv/frontend/web/

 
Như vậy là mình đã hướng dẫn các bạn cài đặt Yii2 Advanced thành công, Nếu bạn nào gặp khó khăn khi cài đặt cứ
comment ở dưới nhé, Chúc vui