Giới Thiệu
Trong bài viết này, chúng ta sẽ cùng tìm hiểu cách cài đặt và chạy một trang web viết bằng Symfony phiên bản 5.x trên Linux. Cụ thể là 3 hệ điều hành Linux đang phổ biến Fedora, Ubuntu và Arch.
Trong mỗi distro, chúng ta đều cần cài 4 packages:
- PHP 8.x
- Git
- Composer
- Symfony CLI
Chỉ có cách cài PHP trên distro khác nhau thì sẽ khác nhau, còn lại Git, Composer và Symfony CLI đều như nhau. Như vậy, mình sẽ hướng dẫn các bạn các cài đặt PHP trên mỗi distro trước, sau đó mình sẽ hướng dẫn cách cài đặt Git, Composer và Symfony CLI chung trên cả 3 distro.
Cài PHP
Cài PHP 8.x trên Ubuntu 20.04
Các bạn chạy lần lượt các lệnh sau và nhập mật khẩu nếu được hỏi:
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.0 libapache2-mod-php8.0
sudo systemctl restart apache2
Sau khi cài đặt xong, để kiểm tra xem PHP đã được cài chưa và có cài chính xác version các bạn mong muốn không thì các bạn gõ lệnh:
php --version
Nếu output của bạn gần giống như vậy thì chúng ta đã cài xong PHP (một số thông tin có thể khác nhưng bạn cần lưu ý version phải từ 8 trở lên):
PHP 8.0.9 (cli) (built: Jul 29 2021 12:53:58) ( NTS gcc x86_64 )
Copyright (c) The PHP Group
Zend Engine v4.0.9, Copyright (c) Zend Technologies
Cài PHP 8.x trên Fedora 34
Các bạn chạy lần lượt các lệnh sau và nhập mật khẩu nếu được hỏi:
sudo dnf install https://rpms.remirepo.net/fedora/remi-release-34.rpm
sudo dnf module reset php
sudo dnf module install php:remi-8.0
Sau khi cài đặt xong, để kiểm tra xem PHP đã được cài chưa và có cài chính xác version các bạn mong muốn không thì các bạn gõ lệnh:
php --version
Nếu output của bạn gần giống như vậy thì chúng ta đã cài xong PHP (một số thông tin có thể khác nhưng bạn cần lưu ý version phải từ 8 trở lên):
PHP 8.0.9 (cli) (built: Jul 29 2021 12:53:58) ( NTS gcc x86_64 )
Copyright (c) The PHP Group
Zend Engine v4.0.9, Copyright (c) Zend Technologies
Cài PHP 8.x trên Arch
Lưu ý, với Arch thì bạn cần cập nhật bản mới nhất cho distro bằng lệnh :
sudo pacman -Syyu
Sau đó các bạn chạy lệnh sau:
sudo pacman -S php
Sau khi cài đặt xong, để kiểm tra xem PHP đã được cài chưa và có cài chính xác version các bạn mong muốn không thì các bạn gõ lệnh:
php --version
Nếu output của bạn gần giống như vậy thì chúng ta đã cài xong PHP (một số thông tin có thể khác nhưng bạn cần lưu ý version phải từ 8 trở lên):
PHP 8.0.9 (cli) (built: Jul 29 2021 12:53:58) ( NTS gcc thànhx86_64 )
Copyright (c) The PHP Group
Zend Engine v4.0.9, Copyright (c) Zend Technologies
Cài Git
Trên Ubuntu 20.04
sudo apt install git
Trên Fedora 34
sudo dnf install git
Trên Arch
sudo pacman -S git
Cài Composer
Các bạn chạy lần lượt các lệnh sau:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
Cài Symfony CLI
Các bạn chạy lệnh sau để cài Symfony CLI, lưu ý các bạn cần có wget hoặc curl trước khi cài Symfony CLI.
wget https://get.symfony.com/cli/installer -O - | bash
sudo mv /home/username/.symfony/bin/symfony /usr/local/bin/symfony
Bạn cần thay thế username bằng username của các bạn. Ví dụ username của user trên máy mình là lkp, thì câu lệnh thứ 2 sẽ thành:
sudo mv /home/lkp/.symfony/bin/symfony /usr/local/bin/symfony
Khởi tạo dự án bằng Symfony CLI
Để khởi tạo dự án, bạn gõ lệnh:
symfony new projectName --version=version
Lưu ý, bạn cần thay thế projectName thành tên project của mình và version thành phiên bản bạn muốn cài đặt. Ví dụ tên project của mình là todolo và version mình muốn cài là 5.3 thì câu lệnh sẽ thành:
symfony new todolo --version=5.3
Bạn có thể bỏ qua phần version để cài đặt bản mới nhất của Symfony. Ví dụ bản mới nhất thời điểm mình viết bài này là 5.3 nên khi mình gõ lệnh:
symfony new todolo
Thì sẽ tự động khởi tạo dự án Symfony phiên bản 5.3.
Chạy dự án
Để chạy dự án mới khởi tạo các bạn cần truy cập vào dự án mới tạo:
cd new-project
Ví dụ, mình mới tạo dự án tên todolo, thì mình cần chạy lệnh:
cd todolo
Sau đó các bạn gõ lệnh để chạy dự án:
symfony serve
Các bạn sẽ thấy terminal hiện ra những thông tin như thế này:
[WARNING] run "symfony server:ca:install" first if you want to
run the web server with TLS support, or use "--no-tls
" to avoid this warning
Tailing Web Server log file (/home/lkp/.symfony/log/2982355613aafd922c24cff778aecc907ce25a5a.log)
Tailing PHP-FPM log file (/home/lkp/.symfony/log/2982355613aafd922c24cff778aecc907ce25a5a/53fb8ec204547646acb3461995e4da5a54cc7575.log)
[OK] Web server listening
The Web server is using PHP FPM 8.0.9
http://127.0.0.1:8000
[Web Server ] Aug 27 09:21:37 |DEBUG | PHP Reloading PHP versions
[Web Server ] Aug 27 09:21:37 |DEBUG | PHP Using PHP version 8.0.9 (from default version in $PATH)
[Web Server ] Aug 27 09:21:37 |INFO | PHP listening path="/usr/sbin/php-fpm" php="8.0.9" port=37689
[PHP-FPM ] Aug 27 09:21:37 |NOTICE | FPM fpm is running, pid 10546
[PHP-FPM ] Aug 27 09:21:37 |NOTICE | FPM ready to handle connections
[PHP-FPM ] Aug 27 09:21:37 |NOTICE | FPM systemd monitor interval set to 10000ms
Các bạn lưu ý chỗ:
[OK] Web server listening
The Web server is using PHP FPM 8.0.9
http://127.0.0.1:8000
Ở đây có nghĩa là bạn đã chạy dự án thành công. Dự án chạy trên Domain 127.0.0.1 và cổng là 8000. Như vậy, để truy cập dự án, bạn mở browser, gõ vào url: http://127.0.0.1:8000 hoặc localhost:8000.
Tada, nếu các bạn thấy màn hình như thế này thì các bạn đã chạy dự án thành công. Các bạn lưu ý có thể đường dẫn thư mục trong hình /home/lkp/Workspace/test/scratch-project sẽ khác với các bạn, miễn sao nó là đường dẫn thư mục đến dự án của các bạn là ok:
Lời kết
Như vậy chúng ta đã cài đặt những pakages cần thiết và chạy dự án viết bằng Symfony trên Linux. Nếu có gặp lỗi, khó khăn hay bất kì thắc mắc gì, các bạn hãy tham gia cộng đồng Symfony Vietnam để trao đổi thêm cũng như là giải quyết những vấn đề bạn đang gặp phải. Chúc các bạn thành công.
