Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Yii
Code

Cách cài đặt Yii trên Windows và Mac

by
Difficulty:BeginnerLength:LongLanguages:

Vietnamese (Tiếng Việt) translation by Thùy Trang (you can also view the original English article)

Final product image
What You'll Be Creating

Muốn biết thêm về Yii? Đọc giới thiệu về Framework Yii và theo dõi loạt bài lập trình Yii của chúng tôi.

Chào mừng

Trong bài hướng dẫn hôm nay, chúng ta sẽ cùng nhau tìm hiểu cách cài đặt Yii trên môi trường local cho cả Windows và Mac. Cho Windows, chúng ta sẽ dùng WAMP server, WAMP bao gồm môi trường phát triển web trên windows, Apache, PHP và Mac, và với Mac, chúng ta sẽ sử dụng người anh em của nó, là MAMP. Mặc dù Rod sẽ sử dụng WAMP cho hướng dẫn ngày hôm nay, nhưng cũng sẽ có một phần khác nói tới MAMP khi dùng trên Windows.

Tôi sẽ viết phần hướng dẫn cho Mac, và đồng nghiệp của tôi, Rod Ussing, sẽ viết phần hướng dẫn cho Windows. Tôi và Rod gặp nhau ở trường cấp 3 tại California khi tôi đang làm công việc lập trình thứ hai khoảng nhiều năm về trước. Rod hiện vẫn trung thành với Windows, còn với tôi, sau 8 năm làm việc cho Microsoft và phát chán với việc phải khởi động lại máy để mở lại Outlook thì tôi đã chuyển sang MacOS.

Yii là gì?

Yii là một framework PHP dễ phát triển, thiết kế tốt, là một framework PHP mang lại hiệu quả cao, cũng giống như Rails cho Ruby hay Lavarel. Nếu bạn đang thắc mắc liệu có thể xây các ứng dụng thực tế trên Yii, thì hãy xem bài viết Meeting Planner và loại bài Building Your Startup của chúng tôi.

Tôi thích dùng Yii. Vì với Yii, mọi thứ đều nhanh chóng và đơn giản hơn. Và tương đối cởi mở hơn so với những frameworks khác (vâng tôi đang nhìn Rails với một ánh mắt có phần ít thiện cảm hơn).

Chúng ta sẽ bắt đầu bằng những điểm đáng lưu ý khi cài đặt Yii trên MacOS và sau đó là trên Windows. Sau đó, tổng hợp cách hướng dẫn cài đặt trên cả hai platform sẽ được miêu tả sau đó.

Chọn giữa Yii Basic và Yii Advanced

Yii Basic là dạng đơn giản của Yii. Bạn có thể dùng nó để xây dựng mọi loại ứng dụng, đặc biệt là cho một thành phần duy nhất, dạng như khi chỉ cần 1 phía client dùng ứng dụng.

Dưới đây là cấu trúc thư mục của một ứng dụng Yii Basic, gồm một tập hợp các thư mục cho một ứng dụng:

Trái lại, mẫu dự án Yii 2 Advanced lại phù hợp cho việc xây dựng các ứng dụng web phức tạp với nhiều thành phần như front end, back end, và console app, mỗi thành phần là một ứng dụng Yii riêng biệt. Ví dụ, bạn có thể xây dựng một admin site hoạt động ở back end, và những cron task chạy trên môi trường console.

Với những sự khác nhau đó, cấu trúc thư mục của một ứng dụng dùng Yii Advanced với nhiều thành phần sẽ như sau:

Mỗi thành phần thuộc một site riêng, nhưng chúng ta vẫn có thể thiết kế hệ thống để chúng có thể kết nối và sử dụng chung một database. Tôi sẽ sử dụng hệ thống dạng này cho loạt bài mở đầu chúng tôi.  Yii Advanced cũng cung cấp nhiều hỗ trợ sẵn có trên nhiều môi trường khác nhau, giúp việc lập trình dễ dàng hơn.

Chuẩn bị macOS cho Yii

Tôi đã lập trình với Yii trên MacOS trong nhiều năm nay. Tôi thích sử dụng MAMP để chạy MySQL, Apache và PHP nhưng ngoài ra còn rất nhiều các web server khác bạn có thể sử dụng để chạy trên Mac.  

Cài đặt MAMP

Install Yii on Windows or a Mac - MAMP Website Home Page

Về cơ bản, chỉ cần truy cập trang web MAMP và tải về các gói phần mềm macOS:

Install Yii on Windows or a Mac - MAMP Downloads Page

Ngay khi tải xong, bạn có thể chuyển tập tin vừa tải đó vào trong thư mục Applications và double-click để bắt đầu cài đặt. Một màn hình MAMP sẽ hiện lên như sau:

Install Yii on Windows or a Mac - MAMP Window

Cấu hình MAMP

Chọn Preferences để cấu hình lại port cho server (Tôi sử dụng port 8888 cho Apache):

Install Yii on Windows or a Mac - MAMP Preferences Ports Configuration

Chọn Web Server để xem lại hoặc có thể thay đổi thư mục server. Tôi sử dụng Apache trên máy:

Install Yii on Windows or a Mac - MAMP Preferences Web Server Configuration

Cài đặt Trình soạn thảo trên macOS

Để cài đặt Yii2 thành công, chúng ta cần phải cài Composer, một trình quản lý khá nổi tiếng được tin tưởng dành cho PHP, nếu chưa có Composer trong máy, bạn hãy cài đặt nó theo hướng dẫn sau:

Tiếp theo, dùng Composer vừa được cài đặt để tiếp tục cho việc cài đặt Yii2. Bạn cần một tài khoản GitHub để việc cài đặt được thành công, nếu chưa có bạn phải đăng ký một tài khoản mới.

Rod miêu tả việc cài đặt Yii cần phụ thuộc vào việc cài đặt plugin composer trước đó.

Anh ấy khuyên nên có một tài khoản GitHub và cấu hình để có được access token. Lý do là vì trong quá trình cài đặt Yii, nếu số lượng request vượt quá giới hạn cho phép của GitHub API, thì Composer có thể sẽ dừng quá trình cài đặt và yêu cầu bạn cung cấp credential để có được access token mới.

Tới đây, bạn đã có thể bắt đầu cài đặt Yii. Chúng ta sẽ cài đặt Yii basic trong thư mục ~/sites/hello

Sau đó, tạo một symlink cho MAMP tới thư mục ứng dụng của bạn:

Nếu bạn muốn cài đặt Yii Advanced, bạn cần phải kích hoạt và chỉnh lại file virtual host như sau:

Bên dưới, tôi đã cấu hình lại frontend.dev và backend.dev để Yii Advanced được cài đặt trong thư mục ~/sites/yiiplus, thư mục mà có link tượng trưng trong /Applications/MAMP.

Nếu bạn quyết định cài đặt Yii Advanced, tôi khuyên bạn nên xem qua bài hướng dẫn về những tính năng của Yii Advanced để biết thêm thông tin.

Trên đây là những bước cơ bản để cài đặt Yii trên MacOS. Giờ chúng ta sẽ chuyển qua hướng dẫn cài đặt trên Windows. Sau đó, chúng ta sẽ nói về những bước cuối để hoàn tất việc cài đặt Yii trên cả hai platform. Nếu bạn chỉ sử dụng MacOS, bạn có thể bỏ qua phần hướng dẫn cho Windows và nhảy đến phần Completing the Yii Confirguration luôn để hoàn tất cài đặt.

Chuẩn bị Windows cho Yii

Đối với Windows, chúng ta sẽ dùng WAMP thay cho MAMP. Tương tự, trước khi bắt đầu cài đặt, bạn hãy tải WAMP về và cấu hình chúng trên máy. Trong bài hướng dẫn này, chúng ta sẽ tải WAMP về máy local. Nếu bạn muốn cài đặt chúng trên một máy host từ xa, bạn cần phải liên hệ nhà cung cấp server và làm theo hướng dẫn của họ cho việc cài đặt và cấu hình chúng.

Cài đặt WAMP

Install Yii on Windows or a Mac - WAMPSERVER Home Page

Bài hướng dẫn này tập trung vào việc cài đặt Yii, nên tôi khuyên bạn có thể xem qua các bài hướng dẫn chi tiết khác cho việc cài đặt WAMP, và cài đặt WAMP không hề khó khăn chút nào. Vì đây cũng là một ứng dụng PHP, nên bạn có thể bắt đầu bằng việc xem qua bài hướng dẫn cài đặt WAMP cho WordPress.

Sau khi cài đặt thành công WAMP, chúng ta sẽ cài Composer, sau đó sẽ dùng Composer để cài đặt Yii.

Cài đặt Trình soạn thảo trên Windows

Mặc dù bạn có thể tải Yii package trực tiếp từ GitHub, nhưng chúng ta sẽ sử dụng Composer trong bài hướng dẫn này. Nếu bạn chưa biết cách sử dụng Composer, thì cũng có thể học thêm cách dùng nó từ bài hướng dẫn này.

Đầu tiên, hãy tới trang GitHub và tải về bản mới nhất Composer-setup.exe, phiên bản mới nhất hiện đang là v4.5.0.

Sau khi cài đặt xong, bạn cũng nên đăng xuất và đăng nhập lại để chắc rằng việc cài đặt thành công và được cập nhật.

Bạn có thể kiểm tra việc cài đặt bằng cách mở Command prompt:

Nhập lệnh sau đây:

Thông tin về version của Composer sẽ được hiển thị lên trên màn hình:

Cài đặt Plugin Tài nguyên Composer

Để có thể đọc, truy suất các loại file, asset trong file .json mà không cần dùng tới NPM hay Bower, bạn sẽ cần phải chạy câu lệnh cài đặt để đảm bảo có tất cả các package cần thiết cho Composer plugin.

Mở command prompt trên Windows và sửa đường dẫn đến thư mục PHP của bạn. Trong lần cài đặt này thì PHP sẽ nằm ở đường dẫn wamp64\bin\ và nó có phiên bản là 7.0.10. Do đó chúng ta sẽ sử dụng câu lệnh:

Sau đó gõ lệnh sau đây:

Vì phần mềm là thứ luôn thay đổi và được cập nhật, hãy nhớ kiểm tra version hiện tại và luôn luôn làm việc trên version mới và stable nhất. Tránh xa những bản Beta ra vì nếu bạn phát triển vượt quá khả năng của nó thì bạn có thể gặp lỗi bất cứ lúc nào.

Hãy kiểm tra version mới nhất của Composer và Composer Plugin theo link sau:

Cấu hình WAMP cho ứng dụng Yii của bạn

Bây giờ, chúng ta sẽ cùng cấu hình lại WAMP. Hãy đổi thư mục đang làm việc thành đường dẫn [thư mục cài WAMP]\www:

Trong đường dẫn này, chúng ta sẽ tạo ra thư mục yii-basic bằng cách gõ dòng lệnh:

Đây là thư mục chúng ta sẽ cài Yii Basic. Bạn cũng có thể bỏ qua và cài Yii trong thư mục www, nhưng bạn nên tạo đường dẫn thư mục có tên rõ ràng dễ nhớ để tránh bị nhầm lẫn, đặc biệt là nếu bạn dự định cài đặt cả hai template Yii Basic và Yii advanced.

Trong thư mục yii-basic, chạy dòng lệnh sau để bắt đầu cài đặt mẫu Yii Basic:

Chúng ta có thể kiểm tra việc cài đặt thành công hay không bằng việc kiểm tra thư mục yii-basic vừa được tạo.

Bây giờ, chúng ta nhập vào các lệnh:

Với lệnh này Yii sẽ được khởi động bằng PHP engine.

Cấu hình tập tin Host trong Windows

Nếu bạn muốn chỉnh lại địa chỉ cho website của bạn, hay muốn tùy chỉnh địa chỉ cho site front end và back end khi dùng Yii-Advanced, thì bạn sẽ phải có thêm một số chỉnh sửa khác nữa.

Có thể click chọn tab Open File trên editor hay dùng Windows Explorer để mở file host.

Chúng ta đang tìm kiếm các phần đọc:

Vì Yii-Advanced có nhiều site, hãy tạo một trang frontend và một trang backend như sau:

Nó sẽ giống như thế này:

Install Yii on Windows or a Mac - Windows Host Config

Bạn có thể tìm hiểu nhiều hơn trong việc thiết lập và cấu hình file host trong Windows tại đây.

Cho phép các máy chủ ảo trong httpd.conf File

Bạn cũng nên kiểm tra thử xem Virtual Host đã được bật trong httpd.conf chưa.

Nhớ là hãy cẩn thận khi chỉnh sửa trong file httpd.conf, tốt nhất là bạn nên tạo ra một bản copy trước khi bắt đầu làm việc và chắc chắn rằng bạn biết bạn đang làm gì trước khi chỉnh sửa, nếu không bạn sẽ ở trong tình trạng ngàn cân treo sợi tóc, chỉ một sai sót nhỏ thôi là server WAMP của bạn sẽ sập. [Jeff: có vẻ Rod đã có kinh nghiệm xương máu về vụ này rồi.]

Để tìm httpd.conf, gõ:

Tôi nghĩ trong bài hướng dẫn này tôi sẽ giải thích chi tiết hơn về httpd.conf để bật các tính năng liên quan đến Virtual Host trong Apache và thiết lập Virtual Host trên WAMP.

Cấu hình máy chủ ảo

Bây giờ chúng ta sẽ cấu hình Virtual Host. Sử dụng menu trong editor hoặc Windows Explorer để đi đến thư mục sau đây:

Hiện tại localhost đã có sẵn một Vitrual Host, vậy nên chúng ta chỉ cần tạo ra Virtual Host cho Yii frontend và backend. Và tốt nhất là các bạn nên ghi tên của mỗi Virtual Host bên trên để tránh bị rối. (Đừng quên đặt chúng vào trong phần comment (bình luận) nhé!)

Ví dụ : #Frontend

File cấu hình của Virtual Host sẽ giống như thế này.

Trong ví dụ này, chúng ta đã cài đặt Yii Advance vào đường dẫn c:/wamp64/www/yii-advanced và tạo một ứng dụng tên là yii-application. Các bạn cũng có thể cài Yii vào www nhé, lúc đó đường dẫn đúng sẽ đổi thành như sau c:/wamp64/www/myapp/frontend/web.

Install Yii on Windows or a Mac - Windows Virtual Host Config

Nhớ để ý đến dòng DocumentRootDirectory. Nó phải bao gồm toàn bộ đường dẫn đến thư mục web nằm bên trong thư mục gốc của site và tương ứng với frontend hay backend. Nội dung của DocumentRoot và Directory phải đồng nhất ngoại trừ đường dẫn của Directory thì nằm trong dấu ngoặc kép.

Cài đặt mẫu Yii nâng cao cho Windows

Để cài đặt template Yii advance, hãy quay lại đường dẫn wamp64\www:

Bây giờ chúng ta sẽ tạo một thư mục mới tên là yii-advanced:

Trong thư mục mới, chúng ta cho chạy câu lệnh sau đây, lệnh này sẽ thực thi cài đặt template Yii Advance:

Install Yii on Windows or a Mac - Composer install Yii-Advanced

Cho đến giờ thì việc cài đặt Yii Basic và Yii Advanced đều tương đối giống nhau. Chỉ cần vài bước nữa thôi là Yii Advanced Template sẵn sàng hoạt động rồi.

Hoàn thành cấu hình Yii

Các bước cho cả Windows và Mac

Tạo cơ sở dữ liệu MySQL

Chúng ta giả sử PHPmyAdmin được cài trên server WAMP của bạn (bao gồm cả MAMP), bạn có thể tạo database (cơ sở dữ liệu) thông qua PHPmyAdmin GUI, nhưng lần này, chúng ta sẽ cài đặt thông qua các dòng lệnh SQL, thật lòng mà nói thì nó không lấy thêm nhiều công sức của bạn mấy đâu.

Trong command line trong Windows, thay đổi đường dẫn tới thư mục MySQL bằng cách gõ câu lệnh sau: 

Với việc này thì bạn có thể thực hiện bất cứ đâu, miễn là WAMP hoặc MAMP được nằm trong môi trường local.

Hãy dùng câu lệnh sau cho cả Mac và Windows:

Tiếp theo chúng ta sẽ đến với mysql command line. Ta sẽ chạy những dòng lệnh SQL sau:

(Bạn có thể đặt tên cơ sở dữ liệu là bất cứ gì bạn muốn, hãy chắc chắn sử dụng tên thích hợp trong suốt phần còn lại của quá trình.)

Giờ bạn hãy tạo username và password cho database bằng cách nhập vào những lệnh SQL sau:

Xong việc rồi, ra khỏi MySQL và trở về console command line thôi.

Lưu trữ username và password của database để cấu hình lại PHP (common/config/main-local.php), cho phép Yii có thể giao tiếp với MySQL.

Khởi chạy ứng dụng Yii Advanced

Phần này không cần thiết khi cài đặt Yii-basic.

Để cài đặt Yii advanced, chúng ta cần đi tới thư mục chứa ứng dụng. Trong trường hợp này sẽ là:

Sau đó gõ init:

Câu lệnh sẽ chạy đoạn mã cài đặt, và sẽ hỏi khi nào bạn muốn cài đặt môi trường development hay là production, giống như dưới đây:

Vì mục đích của bài hướng dẫn này, chúng ta sẽ làm việc trên môi trường development, vì vây nhập 0 và enter, sau đó nhập “yes” (không ngoặc kép) khi được hỏi và việc cài đặt sẽ được hoàn tất.

Cũng gần xong rồi, chỉ còn lại vài bước cấu hình và chúng ta đã có thể bắt đầu lập trình với Yii.

Install Yii on Windows or a Mac - Yii Init Results

Cập nhật cài đặt cấu hình Yii

Đối với Yii-basic, bạn sẽ sửa file /yii-basic/config/db.ini. Với Yii-advanced thì bạn sẽ sửa file /yii-advanced/common/config/main-local.php.

Để sửa file này thì chúng ta sẽ cần dùng text editor. Atom sẽ là lựa chọn tốt nhất cho việc này cũng như công việc lập trình sau này.

Để mở file cấu hình, bạn có thể dùng thanh drop-down Open File trong editor hoặc dẫn trực tiếp đến file thiết lập bằng Windows Explorer và chuột phải vào Open With và chọn text editor. (Trong Windows, có thể bạn sẽ cần phải chạy dưới quyền admin).

Chúng ta sẽ lấy ví dụ từ cài đặt mà chúng ta sử dụng hôm nay để mô tả quá trình này. Hãy nhớ là bạn có thể dùng tên ổ đĩa khác và đường dẫn khác tùy thuộc vào tên thư mục mà bạn đặt.

Tập tin cấu hình nên trông như thế này:

Install Yii on Windows or a Mac - Yii config main-local ini file

Hãy nhớ là nhập username và password giống với khi bạn cài MySQL, không thì coi chừng Yii và MySQL “xung đột” với nhau đấy!

Và đừng nghĩ đến việc sử dụng root username và password của database mà bạn dùng trong file đấy nhé! [Jeff đây... thực sự là đừng dùng nhé].

Sử dụng công cụ di chuyển Yii

Hiện Yii Advanced có sẵn database migration rồi. Giờ với MySQL đã được thiết lập, chúng ta sẽ cần thêm một vài table. Yii migration sẽ tạo bảng và schema trong database MySQL của bạn một cách có hệ thống.

Để khởi động công cụ Yii Migration trong Windows, chúng ta cần vào đường dẫn cài đặt của Yii bằng cách gõ lệnh sau:

Một lần nữa, bạn có thể chọn cài đặt nó mà không cần đường dẫn cha mà Rod đã tạo ra cho demo này. Ví dụ, với MAMP, tôi sử dụng:

Bây giờ gõ lệnh sau đây:

Một lúc sau bạn sẽ được hỏi liệu bạn có muốn “Áp dụng migration bên trên hay không?”

Nhấn Yes và enter. Nếu mọi thứ vẫn ổn thì chúng ta sẽ nhận được tin nhắn là Yii đã được migrate thành công

Install Yii on Windows or a Mac - Yii Migration results

Ghé thăm trang web Yii của bạn

Cuối cùng đã đến lúc trải nghiệm. Khi bạn vào localhost:8888 trên trình duyệt, bạn sẽ thấy:

Install Yii on Windows or a Mac - Your Yii Website Congrtulations Default Home Page

Với Yii Advance thì bạn sẽ cần phải thử frontend.dev hoặc thêm frontend, backend sau đường link, ví dụ: localhost:8888/frontend. Nếu bạn không chỉnh ửa host file của bạn thì bạn có thể truy cập trực tiếp thông qua đường dẫn localhost:8888/web.

Nếu bạn cài đặt advanced template, vào đường dẫn để đăng ký và nhập tên, email mà bạn muốn dùng, sau đó là password.

Đừng dùng MySQL password của bạn (cái mà bạn nhập vào file thiết lập PHP ấy). Đây sẽ là database cho người dùng ứng dụng Yii của bạn.

Tài khoản đầu tiên trong ứng dụng sẽ là tài khoản quản trị với quyền truy cập vào tất cả mọi thứ.

Và giờ bạn đã đăng kí xong, nhập vào trình duyệt như sau:

backend.dev

Bạn sẽ vào được trang đăng nhập admin nơi mà bạn có thể nhập username và password mới của bạn:

The Yii Login Screen

Nó sẽ đưa bạn về trở lại trang “Congratulations” nhưng với tài khoản đã được xác thực và đăng nhập vào.

Thấy chúc mừng cũng nhiều rồi, bạn cũng nên tự chúc mừng bản thân vì bạn vừa cài đặt thành công Yii rồi đấy. Bạn làm rất tốt. [Jeff đây, nếu bạn làm trên Windows, hãy mua một máy tính Mac và thử trên đó.]

Kết thúc

Tôi mong bài hướng dẫn hôm nay sẽ giúp bạn bắt đầu với Yii. Rod và tôi đã rất hứng thú khi cùng nhau viết bài này.

Hãy đón chờ bài hướng dẫn tới trong chuyên đề Programming with Yii2 series vì chúng tôi sẽ tiếp tục đào sâu hơn nhiều khía cạnh của framework này. Hãy chắc rằng bạn xem qua chuyên đề Building Your Startup With PHP series, bài này sẽ sử dụng advanced template của Yii2 để xây dựng các ứng dụng thực tế.

Chương Cách bắt đầu lập trình với Yii đã làm rất tốt việc đi vào chi tiết về cách thiết lập Yii và server production trên Linux.

Nếu bạn muốn biết khi nào có bài hướng dẫn tiếp theo về Yii2, hãy theo dõi tôi @reifman trên Twitter hoặc xem trang hướng dẫn của tôi. Trang hướng dẫn của tôi sẽ bao gồm tất cả các bài viết từ loạt bài này ngay sau khi chúng được xuất bản.

Các liên kết có liên quan

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.