Laravel: Cài đặt
Lưu ý: Đây là phiên bản Laravel 8.x
Giới thiệu Laravel
Laravel là một framework ứng dụng web với cú pháp biểu cảm, thanh lịch. Framework web cung cấp cấu trúc và điểm bắt đầu để tạo ứng dụng của bạn, cho phép bạn tập trung vào việc tạo ra thứ gì đó tuyệt vời trong khi chúng tôi tìm hiểu chi tiết.
Laravel cố gắng cung cấp trải nghiệm tuyệt vời cho nhà phát triển đồng thời cung cấp các tính năng mạnh mẽ như chèn phụ thuộc triệt để, lớp trừu tượng cơ sở dữ liệu rõ ràng, hàng đợi và công việc đã lên lịch, thử nghiệm đơn vị và tích hợp, v.v.
Cho dù bạn là người mới làm quen với PHP hoặc các khung công tác web hay đã có nhiều năm kinh nghiệm, Laravel là một khung công tác có thể phát triển cùng bạn. Chúng tôi sẽ giúp bạn thực hiện những bước đầu tiên của mình với tư cách là nhà phát triển web hoặc thúc đẩy bạn khi bạn nâng chuyên môn của mình lên cấp độ tiếp theo. Chúng tôi không thể chờ đợi để xem những gì bạn xây dựng.
Tại sao Laravel?
Có rất nhiều công cụ và khuôn khổ có sẵn cho bạn khi xây dựng một ứng dụng web. Tuy nhiên, chúng tôi tin rằng Laravel là lựa chọn tốt nhất để xây dựng các ứng dụng web hiện đại, đầy đủ.
Framework tiến bộ
Chúng tôi muốn gọi Laravel là một Framework "tiến bộ". Bởi đó, chúng tôi muốn nói rằng Laravel sẽ phát triển cùng bạn. Nếu bạn chỉ mới thực hiện những bước đầu tiên để phát triển web, thư viện tài liệu, hướng dẫn và video hướng dẫn rộng lớn của Laravel sẽ giúp bạn tìm hiểu kỹ càng mà không bị choáng ngợp.
Nếu bạn là nhà phát triển cấp cao, Laravel cung cấp cho bạn các công cụ mạnh mẽ cho dependency injection, unit test, queue, real-time events và hơn thế nữa. Laravel được tinh chỉnh để xây dựng các ứng dụng web chuyên nghiệp và sẵn sàng xử lý tải công việc của doanh nghiệp.
Framework có thể mở rộng
Laravel có khả năng mở rộng đáng kinh ngạc. Nhờ tính chất thân thiện với quy mô của PHP và hỗ trợ tích hợp của Laravel cho các hệ thống bộ nhớ cache phân tán, nhanh như Redis, việc mở rộng quy mô theo chiều ngang với Laravel thật dễ dàng. Trên thực tế, các ứng dụng Laravel đã dễ dàng mở rộng quy mô để xử lý hàng trăm triệu yêu cầu mỗi tháng.
Cần mở rộng quy mô cực cao? Các nền tảng như Laravel Vapor cho phép bạn chạy ứng dụng Laravel của mình ở quy mô gần như vô hạn trên công nghệ không máy chủ mới nhất của AWS.
Một Framework cộng đồng
Laravel kết hợp các gói tốt nhất trong hệ sinh thái PHP để cung cấp Framework thân thiện và mạnh mẽ nhất hiện có. Ngoài ra, hàng nghìn nhà phát triển tài năng từ khắp nơi trên thế giới đã đóng góp vào framework. Ai biết được, có thể bạn thậm chí sẽ trở thành một người đóng góp cho Laravel.
Dự án Laravel đầu tiên của bạn
Chúng tôi muốn nó trở nên dễ dàng nhất có thể để bắt đầu với Laravel. Có nhiều tùy chọn để phát triển và chạy một dự án Laravel trên máy tính của riêng bạn. Mặc dù bạn có thể muốn khám phá các tùy chọn này sau đó, nhưng Laravel cung cấp Sail, một giải pháp tích hợp để chạy dự án Laravel của bạn bằng Docker.
Docker là một công cụ để chạy các ứng dụng và dịch vụ trong các "vùng chứa" nhỏ, nhẹ, không can thiệp vào cấu hình hoặc phần mềm đã cài đặt trên máy tính cục bộ của bạn. Điều này có nghĩa là bạn không phải lo lắng về việc cấu hình hoặc thiết lập các công cụ phát triển phức tạp như máy chủ web và cơ sở dữ liệu trên máy tính cá nhân của mình. Để bắt đầu, bạn chỉ cần cài đặt Docker Desktop.
Laravel Sail là một giao diện dòng lệnh nhẹ để tương tác với cấu hình Docker mặc định của Laravel. Sail cung cấp một điểm khởi đầu tuyệt vời để xây dựng ứng dụng Laravel bằng PHP, MySQL và Redis mà không yêu cầu kinh nghiệm Docker trước đó.
Đã là chuyên gia Docker? Đừng lo lắng! Mọi thứ về Sail có thể được tùy chỉnh bằng cách sử dụng file docker-compose.yml đi kèm với Laravel.
Bắt đầu trên macOS
Nếu bạn đang phát triển trên máy Mac và Docker Desktop đã được cài đặt, bạn có thể sử dụng một lệnh đầu cuối đơn giản để tạo một dự án Laravel mới. Ví dụ: để tạo một ứng dụng Laravel mới trong thư mục có tên "example-app", bạn có thể chạy lệnh sau trong thiết bị đầu cuối của mình:
curl -s "https://laravel.build/example-app" | bash
Tất nhiên, bạn có thể thay đổi "example-app" trong URL này thành bất kỳ thứ gì bạn thích. Thư mục của ứng dụng Laravel sẽ được tạo trong thư mục mà bạn thực thi lệnh.
Sau khi dự án đã được tạo, bạn có thể điều hướng đến thư mục ứng dụng và khởi động Laravel Sail. Laravel Sail cung cấp một giao diện dòng lệnh đơn giản để tương tác với cấu hình Docker mặc định của Laravel:
cd example-app
./vendor/bin/sail up
Lần đầu tiên bạn chạy lệnh Sail up, các vùng chứa ứng dụng của Sail sẽ được tạo trên máy của bạn. Quá trình này có thể mất vài phút. Đừng lo lắng, những lần thử khởi động Sail tiếp theo sẽ nhanh hơn nhiều.
Khi vùng chứa Docker của ứng dụng đã được khởi động, bạn có thể truy cập ứng dụng trong trình duyệt web của mình tại: http://localhost.
Để tiếp tục tìm hiểu thêm về Laravel Sail, hãy xem lại tài liệu đầy đủ của nó.
Bắt đầu trên Windows
Trước khi chúng tôi tạo một ứng dụng Laravel mới trên máy tính Windows của bạn, hãy đảm bảo cài đặt Docker Desktop. Tiếp theo, bạn nên đảm bảo rằng Hệ thống con của Windows dành cho Linux 2 (WSL2) đã được cài đặt và kích hoạt. WSL cho phép bạn chạy các tệp thực thi nhị phân Linux nguyên bản trên Windows 10. Thông tin về cách cài đặt và kích hoạt WSL2 có thể được tìm thấy trong tài liệu môi trường dành cho nhà phát triển của Microsoft.
Sau khi cài đặt và bật WSL2, bạn nên đảm bảo rằng Docker Desktop được định cấu hình để sử dụng phần phụ trợ WSL2.
Tiếp theo, bạn đã sẵn sàng để tạo dự án Laravel đầu tiên của mình. Khởi chạy Windows Terminal và bắt đầu phiên đầu cuối mới cho hệ điều hành WSL2 Linux của bạn. Tiếp theo, bạn có thể sử dụng một lệnh terminal đơn giản để tạo một dự án Laravel mới. Ví dụ: để tạo một ứng dụng Laravel mới trong thư mục có tên "example-app", bạn có thể chạy lệnh sau trong thiết bị đầu cuối của mình:
curl -s https://laravel.build/example-app | bash
Tất nhiên, bạn có thể thay đổi "example-app" trong URL này thành bất kỳ thứ gì bạn thích. Thư mục của ứng dụng Laravel sẽ được tạo trong thư mục mà bạn thực thi lệnh.
Sau khi dự án đã được tạo, bạn có thể điều hướng đến thư mục ứng dụng và khởi động Laravel Sail. Laravel Sail cung cấp một giao diện dòng lệnh đơn giản để tương tác với cấu hình Docker mặc định của Laravel:
cd example-app
./vendor/bin/sail up
Lần đầu tiên bạn chạy lệnh Sail up, các vùng chứa ứng dụng của Sail sẽ được tạo trên máy của bạn. Quá trình này có thể mất vài phút. Đừng lo lắng, những lần thử khởi động Sail tiếp theo sẽ nhanh hơn nhiều.
Khi vùng chứa Docker của ứng dụng đã được khởi động, bạn có thể truy cập ứng dụng trong trình duyệt web của mình tại: http://localhost.
Để tiếp tục tìm hiểu thêm về Laravel Sail, hãy xem lại tài liệu đầy đủ của nó.
Phát triển trong WSL2
Tất nhiên, bạn sẽ cần có thể sửa đổi các tệp ứng dụng Laravel đã được tạo trong cài đặt WSL2 của bạn. Để thực hiện điều này, chúng tôi khuyên bạn nên sử dụng trình soạn thảo Visual Studio Code của Microsoft và tiện ích mở rộng của bên thứ nhất dành cho Phát triển từ xa.
Sau khi các công cụ này được cài đặt, bạn có thể mở bất kỳ dự án Laravel nào bằng cách thực thi lệnh code . từ thư mục gốc của ứng dụng bằng Windows Terminal.
Bắt đầu trên Linux
Nếu bạn đang phát triển trên Linux và Docker đã được cài đặt, bạn có thể sử dụng một lệnh đầu cuối đơn giản để tạo một dự án Laravel mới. Ví dụ: để tạo một ứng dụng Laravel mới trong thư mục có tên "example-app", bạn có thể chạy lệnh sau trong thiết bị đầu cuối của mình:
curl -s https://laravel.build/example-app | bash
Tất nhiên, bạn có thể thay đổi "example-app" trong URL này thành bất kỳ thứ gì bạn thích. Thư mục của ứng dụng Laravel sẽ được tạo trong thư mục mà bạn thực thi lệnh.
Sau khi dự án đã được tạo, bạn có thể điều hướng đến thư mục ứng dụng và khởi động Laravel Sail. Laravel Sail cung cấp một giao diện dòng lệnh đơn giản để tương tác với cấu hình Docker mặc định của Laravel:
cd example-app
./vendor/bin/sail up
Lần đầu tiên bạn chạy lệnh Sail up, các vùng chứa ứng dụng của Sail sẽ được tạo trên máy của bạn. Quá trình này có thể mất vài phút. Đừng lo lắng, những lần thử khởi động Sail tiếp theo sẽ nhanh hơn nhiều.
Khi vùng chứa Docker của ứng dụng đã được khởi động, bạn có thể truy cập ứng dụng trong trình duyệt web của mình tại: http://localhost.
Để tiếp tục tìm hiểu thêm về Laravel Sail, hãy xem lại tài liệu đầy đủ của nó.
Chọn Dịch vụ Sail của bạn
Khi tạo một ứng dụng Laravel mới qua Sail, bạn có thể sử dụng biến chuỗi truy vấn with để chọn dịch vụ nào sẽ được định cấu hình trong file docker-compose.yml của ứng dụng mới của bạn. Dịch vụ có sẵn bao gồm mysql, pgsql, mariadb, redis, memcached, meilisearch, selenium, và mailhog:
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
Nếu bạn không chỉ định mà dịch vụ mà bạn muốn được cấu hình, thì một stack mặc định gồm mysql, redis, meilisearch, mailhog, và selenium sẽ được cấu hình.
Cài đặt thông qua Composer
Nếu máy tính của bạn đã cài đặt PHP và Composer, bạn có thể tạo một dự án Laravel mới bằng cách sử dụng trực tiếp Composer. Sau khi ứng dụng đã được tạo, bạn có thể khởi động máy chủ phát triển cục bộ của Laravel bằng lệnh Artisan CLI's serve:
composer create-project laravel/laravel example-app
cd example-app
php artisan serve
Trình cài đặt Laravel
Hoặc, bạn có thể cài đặt Trình cài đặt Laravel làm phần phụ thuộc Composer chung:
composer global require laravel/installer
laravel new example-app
cd example-app
php artisan serve
Đảm bảo đặt thư mục bin của nhà cung cấp trên toàn hệ thống của Composer trong $PATH của bạnđể trình thực thi laravel có thể được định vị bởi hệ thống của bạn. Thư mục này tồn tại ở các vị trí khác nhau dựa trên hệ điều hành của bạn; tuy nhiên, một số vị trí phổ biến bao gồm:
- Hệ điều hành Mac:
$HOME/.composer/vendor/bin - Windows:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin - Bản phân phối GNU / Linux:
$HOME/.config/composer/vendor/binhoặc$HOME/.composer/vendor/bin
Để thuận tiện, trình cài đặt Laravel cũng có thể tạo kho lưu trữ Git cho dự án mới của bạn. Để chỉ ra rằng bạn muốn tạo một kho lưu trữ Git, hãy truyền cờ --git khi tạo một dự án mới:
laravel new example-app --git
Lệnh này sẽ khởi tạo một kho lưu trữ Git mới cho dự án của bạn và tự động commit khung Laravel cơ sở. Cờ git giả sử bạn đã cài đặt và cấu hình đúng Git. Bạn cũng có thể sử dụng cờ --branch để đặt tên nhánh ban đầu:
laravel new example-app --git --branch="main"
Thay vì sử dụng cờ --git, bạn cũng có thể sử dụng cờ --github để tạo kho lưu trữ Git và cũng tạo kho lưu trữ riêng tương ứng trên GitHub:
laravel new example-app --github
Kho lưu trữ đã tạo sau đó sẽ có sẵn tại https://github.com/<your-account>/my-app.com. Cờ github giả sử bạn đã cài đặt đúng GitHub CLI và được chứng thực với GitHub. Ngoài ra, bạn cần có git đã cài đặt và định cấu hình đúng cách. Nếu cần, bạn có thể truyền các cờ bổ sung được GitHub CLI hỗ trợ:
laravel new example-app --github="--public"
Bạn có thể sử dụng cờ --organization để tạo kho lưu trữ trong một tổ chức GitHub cụ thể:
laravel new example-app --github="--public" --organization="laravel"
Cấu hình ban đầu
Tất cả các tệp cấu hình cho framework Laravel được lưu trữ trong thư mục config. Mỗi tùy chọn đều được lập thành tài liệu, vì vậy hãy thoải mái xem qua các tệp và làm quen với các tùy chọn có sẵn cho bạn.
Laravel hầu như không cần cấu hình bổ sung. Bạn có thể tự do bắt đầu phát triển! Tuy nhiên, bạn có thể muốn xem lại file config/app.php và tài liệu của nó. Nó chứa một số tùy chọn như timezone và locale mà bạn có thể muốn thay đổi theo ứng dụng của mình.
Cấu hình dựa trên môi trường
Vì nhiều giá trị tùy chọn cấu hình của Laravel có thể khác nhau tùy thuộc vào việc ứng dụng của bạn đang chạy trên máy tính cục bộ hay trên máy chủ web sản xuất, nhiều giá trị cấu hình quan trọng được xác định bằng cách sử dụng file .env tồn tại ở gốc ứng dụng của bạn.
File .env không được commit với quyền kiểm soát nguồn của ứng dụng, vì mỗi nhà phát triển/máy chủ sử dụng ứng dụng của bạn có thể yêu cầu cấu hình môi trường khác nhau. Hơn nữa, đây sẽ là một rủi ro bảo mật trong trường hợp kẻ xâm nhập giành được quyền truy cập vào kho lưu trữ kiểm soát nguồn của bạn, vì bất kỳ thông tin xác thực nhạy cảm nào cũng sẽ bị lộ.
Để biết thêm thông tin về file .env và cấu hình dựa trên môi trường, hãy xem toàn bộ tài liệu cấu hình.
Cấu hình thư mục
Laravel phải luôn được cung cấp từ thư mục gốc của "thư mục web" được định cấu hình cho máy chủ web của bạn. Bạn không nên cố gắng cung cấp ứng dụng Laravel ra khỏi thư mục con của "thư mục web". Cố gắng làm như vậy có thể làm lộ các tệp nhạy cảm tồn tại trong ứng dụng của bạn.
Bước tiếp theo
Bây giờ bạn đã tạo xong dự án Laravel của mình, bạn có thể tự hỏi phải học gì tiếp theo. Trước tiên, chúng tôi thực sự khuyên bạn nên làm quen với cách hoạt động của Laravel bằng cách đọc tài liệu sau:
Cách bạn muốn sử dụng Laravel cũng sẽ quyết định các bước tiếp theo trong hành trình của bạn. Có nhiều cách để sử dụng Laravel và chúng ta sẽ khám phá hai trường hợp sử dụng chính cho framework bên dưới.
Full Stack Framework Laravel
Laravel có thể đóng vai trò như một framework full stack đầy đủ. Framework "full stack", chúng tôi muốn nói rằng bạn sẽ sử dụng Laravel để định tuyến các yêu cầu đến ứng dụng của mình và hiển thị giao diện người dùng của bạn thông qua các mẫu Blade hoặc sử dụng công nghệ kết hợp ứng dụng đơn trang (single-page application) như Inertia.js. Đây là cách phổ biến nhất để sử dụng Laravel framework.
Nếu đây là cách bạn định sử dụng Laravel, bạn có thể muốn xem tài liệu của chúng tôi về định tuyến, chế độ xem hoặc ORM Eloquent. Ngoài ra, bạn có thể quan tâm đến việc tìm hiểu về các gói cộng đồng như Livewire và Inertia.js. Các gói này cho phép bạn sử dụng Laravel như một framework full-stack trong khi tận hưởng nhiều lợi ích về giao diện người dùng được cung cấp bởi các ứng dụng JavaScript đơn trang.
Nếu bạn đang sử dụng Laravel làm framework full-stack, chúng tôi cũng đặc biệt khuyến khích bạn tìm hiểu cách biên dịch CSS và JavaScript của ứng dụng bằng Laravel Mix.
Nếu bạn muốn bắt đầu xây dựng ứng dụng của mình, hãy xem một trong những bộ dụng cụ bắt đầu ứng dụng chính thức của chúng tôi .
API Backend Laravel
Laravel cũng có thể đóng vai trò là chương trình phụ trợ API cho ứng dụng đơn trang JavaScript hoặc ứng dụng di động. Ví dụ: bạn có thể sử dụng Laravel làm API backend cho ứng dụng Next.js của mình. Trong bối cảnh này, bạn có thể sử dụng Laravel để cung cấp xác thực và lưu trữ / truy xuất dữ liệu cho ứng dụng của mình, đồng thời tận dụng các dịch vụ mạnh mẽ của Laravel như hàng đợi, email, thông báo, v.v.
Nếu đây là cách bạn định sử dụng Laravel, bạn có thể muốn xem tài liệu của chúng tôi về định tuyến, Laravel Sanctum và Eloquent ORM.