Cách cài đặt Laravel PHP Framework với Apache 2 trên Ubuntu 22.04

[theanh]

Laravel là một nền tảng ứng dụng web dựa trên PHP để xây dựng các ứng dụng web doanh nghiệp. Đây là một nền tảng web miễn phí và mở theo kiến trúc model-view-controller (MVC) và dựa trên Symfony. Nó cung cấp cú pháp thanh lịch cho phép bạn tạo các ứng dụng với mã sạch và dễ đọc và hiểu.

Laravel là một nền tảng web cấp doanh nghiệp để xây dựng các ứng dụng web toàn bộ ngăn xếp mạnh mẽ và doanh nghiệp. Các ứng dụng Laravel có thể được phân phối nhanh chóng mà không gặp rắc rối, từ quy trình phát triển đến sản xuất.

Ghép nối nền tảng web Laravel với một nền tảng khác như React hoặc Vue cho phép bạn tạo ra một giao diện người dùng đẹp và tương tác. Ngoài ra, nó hỗ trợ nhiều cơ sở dữ liệu bao gồm MySQL, PostgreSQL, SQLite và SQL Server. Laravel cũng cung cấp giàn giáo để xác thực an toàn.

Trong hướng dẫn này, bạn sẽ tìm hiểu cách cài đặt Laravel trên Ubuntu 22.04 LTS mới nhất. Điều này cũng sẽ bao gồm cách thiết lập LAMP Stack cho quá trình phát triển Laravel.

Điều kiện tiên quyết​

• Máy Ubuntu 22.04. Ví dụ này sử dụng máy chủ Ubuntu.
• Người dùng không phải root có quyền quản trị viên sudo hoặc bạn cũng có thể sử dụng người dùng root.

Cài đặt Apache Web Server​

Trong bước đầu tiên này, bạn sẽ cài đặt máy chủ web Apache2 vào hệ thống Ubuntu của mình. Trong ví dụ này, bạn sẽ chạy Laravel web framework với máy chủ web Apache.

Bây giờ hãy chạy lệnh apt bên dưới để cập nhật và làm mới kho lưu trữ Ubuntu của bạn.

sudo apt update

Tiếp theo, cài đặt gói máy chủ web Apache2 bằng lệnh sau.

sudo apt install apache2

Nhập Y để xác nhận và nhấn ENTER để bắt đầu cài đặt. Quá trình cài đặt máy chủ web Apache sẽ bắt đầu.



Sau khi quá trình cài đặt Apache2 hoàn tất, bạn sẽ cần thêm các dịch vụ HTTP và HTTPS vào tường lửa UFW.

Chạy lệnh ufw bên dưới để thêm các dịch vụ HTTP và HTTPS vào tường lửa UFW.

sudo ufw allow "Apache Full"

Cuối cùng, hãy mở trình duyệt web của bạn và nhập địa chỉ IP của máy chủ vào thanh địa chỉ (ví dụ: http://192.168.10.15). Bây giờ bạn sẽ thấy trang index.html mặc định của máy chủ web Apache2.

Cài đặt PHP 8.1​

Sau khi cài đặt máy chủ web Apache, bạn sẽ cài đặt và cấu hình PHP trên máy Ubuntu 22.04. Kho lưu trữ mặc định của Ubuntu 22.04 cung cấp gói PHP v8.1 và được hỗ trợ tốt cho khung web Laravel.

Chạy lệnh apt bên dưới để cài đặt các gói PHP cho khung web Laravel.

sudo apt install php php-curl php-bcmath php-json php-mbstring php-xml php-tokenizer php-zip

Nhập Y để xác nhận cài đặt và nhấn ENTER để tiếp tục. Quá trình cài đặt PHP sẽ bắt đầu.



Sau khi quá trình cài đặt PHP hoàn tất, hãy chỉnh sửa cấu hình php.ini bằng trình soạn thảo nano.

sudo nano /etc/php/8.1/apache2/php.ini

Bỏ ghi chú các tùy chọn sau để bật tiện ích mở rộng PHP fileinfo, openssl và mbstring.

extension=fileinfo
extension=mbstring
extension=openssl

Lưu và đóng tệp khi bạn hoàn tất.

Tiếp theo, khởi động lại dịch vụ Apache2 để áp dụng các thay đổi mới cho cấu hình PHP của bạn.

sudo systemctl restart apache2

Cuối cùng, hãy kiểm tra và xác minh cấu hình PHP của bạn bằng cách chạy lệnh sau.

Kiểm tra phiên bản PHP được cài đặt trên máy Ubuntu của bạn.

php --version

Trong bên dưới ảnh chụp màn hình, bạn có thể thấy PHP 8.1.2 đã được cài đặt trên máy Ubuntu.



Kiểm tra tất cả các tiện ích mở rộng đã bật trên môi trường PHP của bạn.

php -m

Cài đặt MariaDB Server​

Bây giờ bạn đã cài đặt máy chủ web Apache2 và các gói PHP. Bây giờ bạn sẽ cài đặt và cấu hình máy chủ cơ sở dữ liệu MariaDB trên máy Ubuntu 22.04. Bạn cũng sẽ tạo một cơ sở dữ liệu MariaDB và người dùng mới cho dự án Laravekl.

Để cài đặt cơ sở dữ liệu MariaDB vào máy Ubuntu, bạn có thể chạy lệnh apt bên dưới.

sudo apt install mariadb-server

Nhập Y để xác nhận và nhấn ENTER để bắt đầu cài đặt.



Sau khi quá trình cài đặt MariaDB hoàn tất, hãy đăng nhập vào shell MariaDB với tư cách là người dùng root bằng lệnh bên dưới.

sudo mysql -u root -p

Bây giờ hãy chạy các truy vấn mariaDB bên dưới để tạo một cơ sở dữ liệu và người dùng mới cho dự án Laravel. Trong ví dụ này, bạn sẽ tạo cơ sở dữ liệu laravelapp với người dùng laravel và mật khẩu là "password".

CREATE DATABASE laravelapp;
CREATE USER laravel@localhost IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravelapp.* TO laravel@localhost;
FLUSH PRIVILEGES;

Bây giờ hãy chạy truy vấn "EXIT" để đăng xuất khỏi shell MariaDB. Bây giờ bạn đã cài đặt máy chủ cơ sở dữ liệu MariaDB và tạo một cơ sở dữ liệu và người dùng mới cho dự án Laravel.

Cài đặt Composer​

Trong phần này, bạn sẽ cài đặt Composer. Đây là trình quản lý gói cho ngôn ngữ lập trình PHP, giống như pip trên Python, gem trên Ruby, npm hoặc yarn trên Node.js.

Có nhiều cách để cài đặt Laravel web framework. Trong ví dụ này, bạn sẽ cài đặt Laravel web framework bằng Composer.

Bây giờ hãy chạy lệnh bên dưới để tải xuống trình cài đặt cho Composer.

curl -sS https://getcomposer.org/installer -o composer-setup.php

Bây giờ hãy chạy tập lệnh cài đặt "composer-setup.php" để cài đặt Composer. Lệnh này sẽ cài đặt Composer vào thư mục /usr/local/bin.

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

Dưới đây là ảnh chụp màn hình khi cài đặt Composer.



Bây giờ sau khi cài đặt hoàn tất, hãy chạy lệnh bên dưới để kiểm tra và xác minh cài đặt Composer.

Kiểm tra phiên bản Composer.

sudo -u www-data composer --version

Hiển thị nội dung trợ giúp của Composer.

sudo -u www-data composer --help

Bây giờ bạn đã sẵn sàng để bắt đầu cài đặt Laravel.

Bắt đầu cài đặt Laravel​

Trước khi bắt đầu cài đặt Laravel, hãy tạo các thư mục mới cho dự án Laravel.

Trong Ví dụ, bạn sẽ tạo ba thư mục, ".cache" để lưu trữ bộ nhớ đệm của các gói PHP, thư mục ".config" để lưu trữ cấu hình bổ sung của Composer và thư mục "laravelapp" cho chính dự án Laravel. Tất cả các thư mục đó sẽ có sẵn trong thư mục "/var/www
".

Chạy lệnh bên dưới để tạo các thư mục mới cho quá trình cài đặt Laravel.

mkdir -p /var/www/{.cache,.config,laravelapp}

Bây giờ hãy thay đổi quyền sở hữu các thư mục Laravel và Composer thành người dùng và nhóm www-data.

sudo chown -R www-data:www-data /var/www/{.cache,.config,laravelapp}

Tiếp theo, di chuyển đến thư mục /var/www/laravelapp bằng lệnh sau.

cd /var/www/laravelapp/

Sau đó, cài đặt Laravel web framework bằng lệnh composer bên dưới. Dấu chấm ở cuối lệnh sẽ cài đặt Laravel vào thư mục làm việc hiện tại /var/www/laravelapp.

sudo -u www-data composer create-project laravel/laravel .

Dưới đây là ảnh chụp màn hình quá trình cài đặt Laravel.



Và dưới đây là kết quả sau khi quá trình cài đặt Laravel hoàn tất.



Tiếp theo, sau khi quá trình cài đặt hoàn tất, hãy chỉnh sửa tệp ".env" bằng trình chỉnh sửa nano. Cấu hình này là cấu hình môi trường chính cho Laravel, bao gồm URL của quá trình cài đặt, thông tin chi tiết về cơ sở dữ liệu, v.v.

nano .env

Thay đổi cấu hình APP_URL bằng tên miền của bạn để cài đặt Laravel. Trong ví dụ này, Laravel sẽ chạy trên tên miền laravelapp.howtoforge.local.

APP_URL=http://laravelapp.howtoforge.local

Bây giờ hãy thay đổi thông tin chi tiết về cơ sở dữ liệu bằng cấu hình cơ sở dữ liệu của bạn.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravelapp
DB_USERNAME=laravel
DB_PASSWORD=password

Lưu và đóng tệp khi bạn hoàn tất.

Bây giờ bạn đã hoàn tất cài đặt Laravel web framework với máy chủ cơ sở dữ liệu MariaDB.

Thiết lập Apache Virtual Host​

Bây giờ đã đến lúc thiết lập Apache2 virtual host cho Laravel web framework. Trong ví dụ này, dự án Laravel sẽ chạy trên miền cục bộ laravelapp.howtoforge.local.

Tạo tệp mới "/etc/apache2/sites-available/laravel.conf" bằng trình soạn thảo nano.

sudo nano /etc/apache2/sites-available/laravel.conf

Thêm cấu hình sau vào tệp. Nếu bạn đang sử dụng tên miền của mình, bạn có thể thay đổi tên miền. Ngoài ra, hãy đảm bảo thay đổi đường dẫn của thư mục gốc Tài liệu từ dự án Laravel.

 ServerAdmin [emailprotected]
 ServerName laravelapp.howtoforge.local
 DocumentRoot /var/www/laravelapp/public

 
 Options FollowSymLinks
 AllowOverride None
 
 
 AllowOverride All
 

 ErrorLog ${APACHE_LOG_DIR}/error.log
 CustomLog ${APACHE_LOG_DIR}/access.log combined

Lưu và đóng tệp khi bạn hoàn tất.

Tiếp theo, kích hoạt lệnh viết lại mô-đun Apache2 và kích hoạt cấu hình máy chủ ảo laravel.conf bằng lệnh sau.

sudo a2enmod rewrite
sudo a2ensite laravel.conf

Bây giờ hãy xác minh cấu hình Apache2 và đảm bảo không có lỗi nào.

sudo apachectl configtest

Bây giờ hãy khởi động lại dịch vụ Apache2 để áp dụng cấu hình máy chủ ảo mới cho dự án Laravel bằng lệnh sau.

sudo systemctl restart apache2

Bây giờ bạn đã hoàn tất cấu hình máy chủ ảo Apache cho Laravel.

Trên máy của bạn, hãy chỉnh sửa tệp /etc/hosts bằng trình soạn thảo nano/vim.

sudo nano /etc/hosts

Thêm cấu hình sau. hãy chắc chắn thay đổi tên miền và địa chỉ IP bằng máy chủ chi tiết của bạn.

192.168.10.15 laravelapp.howtoforge.local

Lưu và đóng tệp khi bạn hoàn tất.

Cuối cùng, quay lại trình duyệt web của bạn và nhập URL cài đặt laravel (tức là http://laravelapp.howtoforge.local) vào thanh địa chỉ. Và bạn sẽ thấy trang chỉ mục mặc định của Laravel web framework. Ngoài ra, ở phía dưới, bạn có thể thấy phiên bản Laravel mà bạn vừa cài đặt và phiên bản PHP mà bạn hiện đang sử dụng.

Kết luận​

Xin chúc mừng! Bây giờ bạn đã cài đặt thành công Laravel web framework trên Ubuntu 22.04. Bạn cũng đã học được cấu hình cơ bản của LAMP Stack cho Laravel web farmwork.