Hướng Dẫn Cài Đặt YII Framework trên XAMP

Hướng dẫn cài đặt Yii2 Framework cho người mới

Bạn có thể cài đặt Yii theo 2 cách:

• Sử dụng trình quản lý gói Composer
• Tải xuống toàn bộ mã nguồn Yii.

Tuy nhiên, việc sử dụng trình quản lí Composer được sử dụng phổ biến hơn vì nó cho phép người dùng cài đặt các Gói mở rộng (eхtenѕionѕ) hoặc cập nhật Yii chỉ bằng một dòng lệnh.

Theo mặc định, cài đặt Yii sẽ cung cấp cho bạn một số chức năng cơ bản như đăng nhập, form liên hệ (contact form),… Các tính năng trên được khuyến khích và sử dụng rộng rãi, vì vậy Yii có thể hữu ích cho dự án của bạn.

Cài đặt qua trình quản lý Composer

Nếu chưa cài Composer, bạn có thể cài đặt theo đường link: https://getcomposer.org/download/

• Đối với hệ điều hành Linux và Mac OS X, có thể chạy các lệnh sau:

curl -s https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

• Đối với hệ điều hành Windows, có thể tải về và chạy: https://getcomposer.org/Composer-Setup.exe

Nếu máy đã cài đặt Composer, hay mở cmd (Nhấn tổ hợp Windows + R >> gõ cmd >> nhấn OK) và di chuyển đến đường dẫn thư mục muốn cài đặt Yii2, sao chép và dán các lệnh bên dưới vào của sổ lệnh cmd.

Sau khi cài đặt Composer, thì bạn có thể cài đặt Yii bằng cách chạy lệnh sau đây.

Mã lệnh cài đặt Yii2 Basic Application:

composer global require "fxp/composer-asset-plugin:^1.4.1"
composer create-project --prefer-dist yiisoft/yii2-app-basic basic

Trong đó,

• Câu lệnh thứ nhất sẽ cài đặt composer asset plugin và cho phép Composer có thể quản lý package dependencies của bower và npm. Câu lệnh thứ nhất này chỉ cần chạy một lần.
• Câu lệnh thứ hai dùng để cài đặt phiên bản Yii có tên là basic. Người dùng có thể chọn một tên thư mục khác nếu muốn.

Chú ý: Trong quá trình cài đặt Composer, có thể yêu cầu sử dụng thông tin đăng nhập từ tài khoản Github của người dùng.

Mã lệnh cài đặt Yii2 Advanced Application:

composer global require "fxp/composer-asset-plugin:~1.1.1"
composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced

Thủ thuật: Nếu muốn cài đặt phiên bản phát triển mới nhất của Yii, bạn có thể sử dụng lệnh sau để thay thế:

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

Chú ý. phiên bản phát triển của Yii(dev version) không nên sử dụng cho môi trường ứng dụng bởi vì phiên bản này có thể phá vỡ các hoạt động trong code.

Cài đặt từ tập lưu trữ

Việc cài đặt Yii từ một tập tin lưu trữ gồm 3 bước:

• Tải gói cài đặt từ: https://www.yiiframework.com/download
• Giải nén tệp download vào một thư mục Web của ứng dụng cần chạy.
• Sửa đồi tệp config/web.php bằng cách nhập thông tin secret key cookieValidationKey ở mục cấu hình (được thực hiện tự động nếu bạn cài đặt Yii sử dụng Composer):

// !!! chèn một secret key trong phần sau (nếu rỗng) - Việc này là cần thiết để xác thực cookie trong ứng dụng
'cookieValidationKey' => 'Nhập secret key tuỳ chọn vào đây',

Kết quả cài đặt

Sau khi cài đặt, người dùng có thể sử dụng trình duyệt để truy cập ứng dụng Yii với URL dưới đây: http://localhost/basic/web/index.php

URL là khi bạn đã cài đặt Yii trong một thư mục có tên là basic, trực tiếp dưới thư mục gốc tài liệu máy chủ Web, và các máy chủ Web đều đang chạy trên máy tính cục bộ của bạn (localhost). Bạn có thể sẽ cần phải điều chỉnh lại trong môi trường cài đặt.

Để chạy được trên loacalhost trên XMAPP không cần truy cập vào http://localhost/basic/web/index.php/ thì mình cần đổi port và tạo Virtual Host, bạn có thể vào

Mở file C:\xampp\apache\conf\httpd.conf với một công cụ chỉnh sửa (editor) nào đó, notepad cũng được, hoặc truy cập file trực tiếp từ XAMPP theo hình bên dưới.

• Khi file httpd.conf đã được mở, tìm tới dòng #Listen 12.34.56.78:80, bạn sẽ thấy đoạn code bên trong có dạng như sau:

#Listen 12.34.56.78:80
Listen 80

• Port 80 là port mặc định chạy http://localhost/ của XAMPP.
• Từ vị trí này ta thêm nhiều port khác nhau, save lại sau mỗi lần thêm port:

#Listen 12.34.56.78:80
Listen 80
Listen 81
Listen 82
Listen 83
#Listen 12.34.56.78:80
Listen 80
Listen 81
Listen 82
Listen 83

Cấu hình Virtual Host: httpd-vhosts.conf

<VirtualHost *:81>
    ServerAdmin webmaster@dummy-host.example.com
    DocumentRoot "G:/Xamp/htdocs/souce/web"
    ##ServerName dummy-host.example.com
    ##ServerAlias www.dummy-host.example.com
    ##ErrorLog "logs/dummy-host.example.com-error.log"
    ##CustomLog "logs/dummy-host.example.com-access.log" common
</VirtualHost>

• <VirtualHost *:82> : Đây là một trong những port đã được thêm vào httpd.conf, nếu cấu hình chạy domain thì chúng ta có thể dùng port 80.
• DocumentRoot Thư mục chứa project (khai báo bắt buộc).
• ServerName Tên server, dùng tên domain và port nếu có (khai báo bắt buộc).
• ServerAlias Tên thay thế cho tên server (khai báo tùy chọn).
• ErrorLog Đường dẫn tới file log error, sẽ xem lỗi từ đây (khai báo tùy chọn).
• CustomLog Đường dẫn tới file log Uri khi người dùng request (khai báo tùy chọn).
• Directory Bên trong tag này dùng để cấp quyền cho thư mục.

Sau khi cấu hình như trên hoàn tất, save lại và cần restart Apache, bằng cách mở XAMPP click vào stop tương ứng của Apache và start lại, khi này bạn thử chạy trên trình duyệt lại bằng đường dẫn mới:
http://localhost:82/hello-world.php.

Tương tự như vậy, chúng ta có thể tạo nhiều Virtual Host khác nhau trong cùng một server.