Hướng dẫn thiết lập môi trường chạy ứng dụng Laravel trên Ubuntu

Bài đăng này đã không được cập nhật trong 4 năm

1. Giới thiệu

Để chạy một project Laravel chúng ta cần một web server. Giống như trên Windows, khi phát triển một ứng dụng Web sẽ sử dụng XAMPP, thì ở trên Ubuntu sẽ có một Web Server tương tự đó là LAMP. Tiếp theo, cần cài đặt Composer để cài đặt Laravel. Trong bài viết này, mình sẽ hướng dẫn các bạn cài đặt LAMP, Composer trên Ubuntu 18.04, các phiên bản khác cũng tương tự, nhưng mình khuyên mọi người nên sử dụng bản Ubuntu mới nhất để có những trải nghiệm người dùng tốt nhất.

2. LAMP

LAMP gồm 4 thành phần chính Linux, Apache, MySQL, và PHP hoặc Python hoặc Perl.

Linux: Linux là tên của một hệ điều hành mở và cũng là tên hạt nhân của hệ điều hành. Được ra đời lần đầu tiên vào năm 1994 bởi Linus Torvalds. Ubuntu là hệ điều hành mã nguồn mở dựa trên GNU Debian/Linux. Hiện nay, Ubuntu rất phổ biến và được sử dụng nhiều trong những công ty IT bởi vì đây là hệ điều hành miễn phí (yaoming). Bởi vì mình cài LAMP trên Ubuntu 18.04, chính hệ điều hành cũng là một thành phần của LAMP nên sẽ không cần cài đặt nữa.
Apache: Apache là phần mềm web server miễn phí mã nguồn mở. Nó đang chiếm đến khoảng 46% thị phần websites trên toàn thế giới. Tên chính thức của Apache là Apache HTTP Server, được điều hành và phát triển bởi Apache Software Foundation. Sau đây là cách cài đặt Apache trên Ubuntu:
- Chạy câu lệnh sau: $ sudo apt-get install apache2
- Sau đó bấm Y để tiếp tục cài đặt. Tiếp theo, mở trình duyệt gõ 127.0.0.1 để kiểm tra Apache đã hoạt động chưa.
- Khi trình duyệt hiện ra như trên, đã cài đặt Apache thành công. Tiếp theo sẽ cài đặt MySQL.
MySQL: MySQL là hệ quản trị cơ sở dữ liệu mã nguồn mở, được sử dụng phổ biến rộng rãi trên thế giới.
- Sau đây là câu lệnh cài đặt MySQL: $ sudo apt-get install mysql-server
- Bấm chọn Y để tiếp tục cài đặt.
- Sau khi cài đặt xong, tiếp tục chạy câu lệnh sau: $ sudo mysql_secure_installation.
- Ở đây có 2 lựa chọn, nếu chọn Y sẽ sử dụng VALIDATE PASSWORD PLUGIN có nghĩa là bạn phải sử dụng mất khẩu mạnh cho cơ sở dữ liệu, như là độ dài mật khẩu phải trên 8 kí tự, in hoa, in thường, kí tự đặt biệt, etc... Còn nếu chọn N sẽ không sử dụng VALIDATE PASSWORD PLUGIN. Và ở đây cài đặt trên máy cá nhân nên cũng không cần sử VALIDATE PASSWORD PLUGIN. Nên ở đây mình sẽ chọn N để tiện cho việc cài đặt.
- Sau khi chọn N, sẽ yêu cầu bạn thiết lập mật khẩu cho MySQL. Ở đây để dễ nhớ mình sẽ đặt là: 123456
- Gõ lại mật khẩu lần nữa. Và ấn Enter.
- Tiếp theo chọn Y và ấn Enter.
- Tiếp theo chọn N và ấn Enter.
- Tiếp theo chọn Y và Enter.
- Tiếp theo chọn Y và Enter.
- Vậy là đã cài đặt xong MySQL. Tiếp theo chạy cậu lệnh sau:$ mysql -u root -p để truy cập vào MySQL, root ở đây là username mặc định khi cài đặt MySQL. Bạn cũng thể tự tạo một tài khoản khác để truy cập vào MySQL.
- Nhập mật khẩu đã thiết lập trước đó, nếu như hiện thông tin như ảnh trên. Thì chạy câu lệnh sau: $ sudo mysql. Để truy cập vào MySQL với quyền root mà không cần mật khẩu cho tài khoản có username là root.
- Sau khi đăng nhập vào MySQL với quyền root, chạy câu lệnh sau:
  - ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';. Trường password là để thiết lập lại mật khẩu cho tài khoản root. Ở đây mình sẽ đặt giá trị password là 123456.
  - Tiếp theo chạy câu lệnh:FLUSH PRIVILEGES; Mục đích là để reload lại và apply những thay đổi.
  - Sau đó thoát ra và đăng nhập lại MySQL để kiểm tra thiết lập mật khẩu thành công hay không.
- Vậy là đã cài xong MySQL. Tiếp đến sẽ cài đặt PHP.
PHP: Để cài đặt PHP, chạy câu lệnh sau: $ sudo apt-get install php libapache2-mod-php php-mysql
- Để kiểm tra PHP đã cài đặt thành công hay chưa, sử dụng câu lệnh: php -v.
- Tiếp cần phải cài đặt một số thư viện cần thiết cho PHP. Ở đây mình cài thư viện mcrypt.
- Chạy câu lệnh sau: sudo apt install php-dev libmcrypt-dev php-pear
- Sau đó chạy tiếp 2 câu lệnh sau: sudo pecl channel-update pecl.php.net và sudo pecl install mcrypt-1.0.1
- Sau khi cài đặt xong, chạy câu lệnh sau: sudo nano /etc/php/7.2/cli/php.ini và thêm vào file php.ini dòng sau: extension=mcrypt.so
- Sau đó Ctrl + S và Ctrl + X để lưu lại. Để kiểm tra cài đặt thành công hay chưa, sử dụng câu lệnh sau: php -m | grep mcrypt. Nếu thành công sẽ hiện ra như sau:
Vậy là đã thiết lập LAMP thành công.

3. Composer

Tóm tắt: Composer là công cụ để quả lý package hay library PHP. Composer sẽ cài đặt những libraries vào một thư mục nào đó nằm bên trong project bạn đang làm việc.

Để tải composer, chạy những câu lệnh sau:

     php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
     php -r "if (hash_file('sha384', 'composer-setup.php') === 'c5b9b6d368201a9db6f74e2611495f369991b72d9c8cbd3ffbc63edff210eb73d46ffbfce88669ad33695ef77dc76976') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
     php composer-setup.php
     php -r "unlink('composer-setup.php');"

Kiểm tra Composer đã được cài đặt chưa, chạy câu lệnh sau: php composer.phar. Nếu cài đặt thành công, sẽ hiển thị như sau:

Để có thể ở bất cứ đâu cũng có thể sử dụng Composer, sử dụng câu lệnh sau: sudo mv composer.phar /usr/local/bin/composer. Sau đó chạy câu lệnh: composer. Để kiểm tra config đã thành công chưa.

Vậy là đã cài đặt xong Composer

4. Laravel

Để cài đặt được Laravel, theo tài liệu trang chủ hướng dẫn https://laravel.com/docs/6.x, cần có những extension sau:

    PHP >= 7.2.0
    BCMath PHP Extension
    Ctype PHP Extension
    JSON PHP Extension
    Mbstring PHP Extension
    OpenSSL PHP Extension
    PDO PHP Extension
    Tokenizer PHP Extension
    XML PHP Extension

Để kiểm tra xem những extension nào đã được cài rồi, sử dụng câu lệnh sau: php -m | grep tên extension. Ví dụ, kiểm tra xem extension BCmath đã có chưa: php -m | grep bcmath

Nếu chạy xong câu lệnh mà thông báo như trên có nghĩa là extension BCMath chưa được cài đặt. Để cài đặt một extension của php, sử dụng câu lệnh sau: sudo apt-get install php-bcmath. Cụ thể, để cài đặt extension BCMath, sử dụng câu lệnh sau: sudo apt-get install php-bcmath. Sau đó, chạy lại câu lệnh php -m | grep bcmath để kiểm tra xem cài đặt thành công hay chưa.

Như vậy, đã cài đặt tthành công extension BCMath. Những extension còn lại, làm theo tương tự.
Tiếp theo, cài đặt Laravel thông qua Composer. Chạy câu lệnh sau: composer global require laravel/installer
Sau khi chạy xong. Chạy câu lệnh: laravel, nếu như ở command line hiện nên là: laravel: command not found, sẽ cần phải làm theo những bước sau:
- Chạy câu lệnh: sudo nano ~/.bashrc
- Tiếp theo: Thêm dòng sau vào cuối file export PATH="~/.config/composer/vendor/bin:$PATH"
- Ctrl + S và Ctrl + X để lưu lại.
- Cuối cùng, chạy câu lệnh: source ~/.bashrc
Khi thực hiện xong những bước trên, chạy lại câu lệnh laravel để kiểm tra.

Vậy là đã thiết lập thành công.

4. Lời kết

Hy vọng bài hướng dẫn này sẽ giúp mọi người có thể thiết lập môi trường thành công và bắt tay vào việc làm quen với Laravel. Happy Coding!!!

Ubuntu 18.04

Mục lục