Lời nói đầu
Laravel là một framework phát triển ứng dụng web với cú pháp tinh tế, hàm ý. 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 sẽ bỏ công sức ra làm chi tiết.
Laravel cố gắng cung cấp trải nghiệm tuyệt vời nhất cho nhà phát triển đồng thời cung cấp các tính năng mạnh mẽ như tích hợp phụ thuộc, lớp abstraction hóa cơ sở dữ liệu, queue và scheduled job, unit và integration test, v.v.
Cho dù bạn là người mới làm quen với PHP web framework hay là người đã có nhiều năm kinh nghiệm, Laravel là một framework có thể phát triển cùng với bạn. Chúng tôi sẽ giúp bạn thực hiện những bước đầu tiên với tư cách là nhà phát triển web hoặc nâng cao kiến thức chuyên môn của bạn lên một tầm cao mới. Chúng tôi nóng lòng muốn xem những gì bạn xây dựng.
[!NOTE] Bạn mới sử dụng Laravel? Hãy xem Laravel Bootcamp để có thể tham quan thực tế về framework và chúng tôi sẽ hướng dẫn bạn về cách xây dựng ứng dụng Laravel đầu tiên của bạn.
Tại sao lại là Laravel?
Có rất nhiều công cụ và framework có sẵn cho bạn khi bạn xây dựng một ứng dụng web. Tuy nhiên, chúng tôi tin rằng Laravel là một lựa chọn tốt nhất để xây dựng các ứng dụng web full-stack hiện đại.
A Progressive Framework
Chúng tôi muốn gọi Laravel là một framework "tiến bộ". Bằng cách đó, chúng tôi muốn nói rằng Laravel phát triển cùng với bạn. Nếu bạn mới thực hiện những bước đầu tiên trong quá trình phát triển web, thư viện tài liệu, hướng dẫn và video hướng dẫn khổng lồ của Laravel sẽ giúp bạn tìm hiểu các bước cơ bản mà không bị choáng ngợp.
Nếu bạn là nhà phát triển cấp cao, Laravel cũng cung cấp cho bạn các công cụ mạnh mẽ để tích hợp phụ thuộc, unit test, queue, real-time events, và nhiều hơn thế. 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ý khối lượng lớn công việc của doanh nghiệp.
A Scalable Framework
Laravel có khả năng mở rộng đáng kinh ngạc. Nhờ tính chất thân thiện của PHP và tính năng hỗ trợ sẵn có của Laravel dành cho các hệ thống bộ nhớ cache phân tán 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 request mỗi tháng.
Cần mở rộng quy mô cực lớn? Các nền tảng như Laravel Vapor cho phép bạn chạy ứng dụng Laravel của bạn ở quy mô gần như vô hạn trên công nghệ serverless mới nhất của AWS.
A Community Framework
Laravel kết hợp các package tốt nhất trong hệ sinh thái PHP để cung cấp framework mạnh mẽ và thân thiện nhất với nhà phát triển. 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 cho framework. Ai biết được, thậm chí có thể bạn sẽ trở thành người đóng góp cho Laravel.
Creating a Laravel Project
Trước khi tạo project Laravel đầu tiên, bạn hãy chắc chắn là máy local của bạn đã cài đặt PHP và Composer. Nếu bạn đang phát triển trên môi trường macOS, PHP và Composer, thì bạn có thể cài đặt được chúng trong vài phút thông qua Laravel Herd. Ngoài ra, chúng tôi cũng khuyên bạn nên cài đặt Node và NPM.
Sau khi bạn đã hoàn thành việc cài đặt PHP và Composer, bạn có thể tạo một project Laravel mới thông qua lệnh create-project của Composer:
composer create-project "laravel/laravel:^10.0" example-appHoặc, bạn có thể tạo project Laravel mới bằng cách dùng qua Laravel installer đang được cài đặt global thông qua Composer:
composer global require laravel/installer
laravel new example-appKhi project đã được tạo, hãy khởi động máy chủ local của Laravel bằng lệnh serve của Laravel Artisan:
cd example-app
php artisan serveSau khi bạn đã khởi động máy chủ bằng Artisan, ứng dụng của bạn sẽ có thể truy cập được trong trình duyệt web của bạn bằng địa chỉ http://localhost:8000. Tiếp theo, bạn đã sẵn sàng bắt đầu thực hiện các bước khác trong hệ sinh thái Laravel. Tất nhiên, bạn cũng có thể muốn cấu hình cơ sở dữ liệu.
[!NOTE] Nếu bạn muốn có một sự khởi đầu thuận tiện khi phát triển ứng dụng Laravel, thì hãy cân nhắc sử dụng một trong những bộ khởi tạo của chúng tôi. Bộ khởi tạo này cung cấp một nền tảng xác thực có sẵn cả backend và frontend cho ứng dụng Laravel mới của bạn.
Initial Configuration
Tất cả các file cấu hình cho Laravel framework đều được lưu trong thư mục config. Mỗi tùy chọn đều đã được giải thích, vì vậy bạn hãy thoải mái xem qua các file 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 bạn cấu hình thêm bất cứ cấu hình nào khi cài đặt. Bạn có thể thoải mái bắt đầu phát triển! Tuy nhiên, bạn có thể muốn xem qua file config/app.php và tài liệu hướng dẫn 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 trạng thái ứng dụng của bạn.
Environment Based Configuration
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ôi trường local hay môi trường là production, nên nhiều giá trị cấu hình quan trọng được định nghĩa trong file .env có ở trong thư mục root của ứng dụng.
File .env của bạn không nên được commit vào source control của ứng dụng, vì mỗi nhà phát triển và server của họ sẽ sử dụng ứng dụng của bạn theo nhiều yêu cầu cấu hình khác nhau. Hơn nữa, đây sẽ là rủi ro bảo mật trong trường hợp kẻ xâm nhập có quyền truy cập vào source control 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ộ.
[!NOTE] Để biết thêm thông tin về file
.envvà cấu hình theo môi trường, hãy xem tài liệu cấu hình.
Databases and Migrations
Bây giờ bạn đã tạo ứng dụng Laravel của bạn, có lẽ bạn muốn lưu một số dữ liệu vào trong cơ sở dữ liệu. Mặc định, file cấu hình .env của ứng dụng của bạn sẽ tương tác với cơ sở dữ liệu MySQL và sẽ truy cập cơ sở dữ liệu ở địa chỉ 127.0.0.1.
[!NOTE] Nếu bạn đang phát triển trên macOS và cần cài đặt MySQL, Postgres hoặc Redis ở local, hãy cân nhắc sử dụng DBngin.
Nếu bạn không muốn cài đặt MySQL hoặc Postgres trên máy local của bạn, bạn có thể sử dụng cơ sở dữ liệu SQLite. SQLite là một loại cơ sở dữ liệu nhỏ, nhanh và độc lập. Để bắt đầu, hãy cập nhật file cấu hình .env của bạn để sử dụng driver cơ sở dữ liệu sqlite của Laravel. Bạn có thể xóa các tùy chọn cấu hình cơ sở dữ liệu khác:
DB_CONNECTION=sqlite # [tl! add]
DB_CONNECTION=mysql # [tl! remove]
DB_HOST=127.0.0.1 # [tl! remove]
DB_PORT=3306 # [tl! remove]
DB_DATABASE=laravel # [tl! remove]
DB_USERNAME=root # [tl! remove]
DB_PASSWORD= # [tl! remove]Sau khi cấu hình cơ sở dữ liệu SQLite, bạn có thể chạy database migrations của ứng dụng, lệnh này sẽ tạo ra các bảng cơ sở dữ liệu cho ứng dụng:
php artisan migrateNếu cơ sở dữ liệu SQLite chưa được tạo cho ứng dụng của bạn, Laravel sẽ hỏi bạn có muốn tạo cơ sở dữ liệu không. Thông thường, file cơ sở dữ liệu SQLite sẽ được tạo tại database/database.sqlite.
Cấu hình thư mục
Laravel nên được chạy từ thư mục root của "web directory" đã được cấu hình trong server web của bạn. Bạn không nên cố gắng chạy ứng dụng Laravel từ thư mục con của "web directory". Cố gắng làm như vậy có thể làm lộ các file nhạy cảm có trong ứng dụng của bạn.
Cài đặt Docker bằng Sail
Chúng tôi muốn việc bắt đầu với Laravel trở nên dễ dàng nhất có thể với bất kỳ hệ điều hành nào mà bạn thích. Vì vậy, có nhiều tùy chọn để phát triển và chạy dự án Laravel trên máy local của 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 sẵn có để chạy các project Laravel của bạn bằng Docker.
Docker là một công cụ để chạy các ứng dụng và service trong các "containers" nhỏ, nhẹ, không can thiệp vào cấu hình hoặc phần mềm được cài đặt trên máy local 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ư web server và cơ sở dữ liệu trên máy local của bạn. Để bắt đầu, bạn chỉ cần cài đặt Docker Desktop.
Laravel Sail là giao diện command-line nhẹ để tương tác với cấu hình Docker mặc định của Laravel. Sail cung cấp đ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 cần yêu cầu kinh nghiệm về Docker trước đó.
[!NOTE] Bạn đã là chuyên gia về 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.ymlcó trong Laravel.
Sail 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 terminal đơn giản để tạo project 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 terminal của bạn:
curl -s "https://laravel.build/example-app" | bashTấ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 - chỉ cần đảm bảo tên ứng dụng của bạn chỉ chứa các ký tự chữ, số, dấu gạch ngang và dấu gạch dưới. Thư mục của ứng dụng Laravel sẽ được tạo trong thư mục mà bạn đang chạy lệnh.
Việc cài đặt Sail có thể mất vài phút khi các container ứng dụng của Sail được cấu trúc vào máy local của bạn.
Sau khi project được tạo, bạn có thể di chuyển đến thư mục ứng dụng và khởi động Laravel Sail. Laravel Sail cung cấp một giao diện command-line đơ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 upKhi container Docker của ứng dụng đã được khởi động xong, bạn có thể truy cập vào ứng dụng trong trình duyệt web của bạn tại: http://localhost.
[!NOTE] Để tiếp tục tìm hiểu thêm về Laravel Sail, hãy xem lại tài liệu đầy đủ.
Sail trên Windows
Trước khi chúng ta tạo một ứng dụng Laravel mới trên máy Windows của bạn, hãy đảm bảo bạn đã cài đặt Docker Desktop. Tiếp theo, bạn nên đảm bảo là Windows Subsystem cho Linux 2 (WSL2) đã được cài đặt và được kích hoạt trên máy của bạn. WSL cho phép bạn chạy các tệp lệnh nhị phân Linux nguyên bản trên Windows 10. Bạn có thể tìm thấy thông tin về cách cài đặt và kích hoạt WSL2 trong tài liệu về môi trường dành cho nhà phát triển của Microsoft.
[!NOTE] Sau khi cài đặt và kích hoạt WSL2 xong, bạn nên đảm bảo rằng Docker Desktop đã được cấu hình để sử dụng WSL2.
Tiếp theo, bạn đã sẵn sàng tạo project Laravel đầu tiên của bạn. Chạy Windows Terminal và bắt đầu phiên terminal mới cho hệ điều hành WSL2 Linux của bạn. Tiếp theo, bạn có thể sử dụng lệnh terminal đơn giản để tạo project Laravel mới. Ví dụ: để tạo một ứng dụng Laravel mới trong thư mục có tên là "example-app", bạn có thể chạy lệnh sau trong terminal của bạn:
curl -s https://laravel.build/example-app | bashTấ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 - chỉ cần đảm bảo tên ứng dụng của bạn chỉ chứa các ký tự chữ, số, dấu gạch ngang và dấu gạch dưới. Thư mục của ứng dụng Laravel sẽ được tạo trong thư mục mà bạn đang chạy lệnh.
Việc cài đặt Sail có thể mất vài phút khi các container ứng dụng của Sail được cấu trúc vào máy local của bạn.
Sau khi project được tạo, bạn có thể di chuyển đến thư mục ứng dụng và khởi động Laravel Sail. Laravel Sail cung cấp một giao diện command-line đơ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 upKhi container Docker của ứng dụng đã được khởi động xong, bạn có thể truy cập vào ứng dụng trong trình duyệt web của bạn tại: http://localhost.
[!NOTE] Để tiếp tục tìm hiểu thêm về Laravel Sail, hãy xem lại tài liệu đầy đủ.
Developing Within WSL2
Tất nhiên, bạn cũng sẽ cần có khả năng thay đổi các file ứng dụng Laravel đã được tạo trong quá trình cài đặt WSL2. Để thực hiện điều này, chúng tôi khuyên bạn nên sử dụng IDE Visual Studio Code của Microsoft và extension của nhà phát triển cho Remote Development.
Sau khi cài đặt các công cụ này, bạn có thể mở bất kỳ dự án Laravel nào bằng cách chạy lệnh code . từ thư mục gốc của ứng dụng bằng Windows Terminal.
Sail trên Linux
Nếu bạn đang phát triển trên Linux và Docker Compose đã được cài đặt, bạn có thể sử dụng lệnh terminal đơn giản để tạo dự án Laravel mới.
Đầu tiên, nếu bạn đang sử dụng Docker Desktop cho Linux, thì bạn nên thực hiện lệnh sau. Nếu bạn không sử dụng Docker Desktop cho Linux, bạn có thể bỏ qua bước này:
docker context use defaultSau đó, để tạo một ứng dụng Laravel mới trong thư mục có tên là "example-app", bạn có thể chạy lệnh sau trong terminal của bạn:
curl -s https://laravel.build/example-app | bashTấ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 - chỉ cần đảm bảo tên ứng dụng của bạn chỉ chứa các ký tự chữ, số, dấu gạch ngang và dấu gạch dưới. Thư mục của ứng dụng Laravel sẽ được tạo trong thư mục mà bạn đang chạy lệnh.
Việc cài đặt Sail có thể mất vài phút khi các container ứng dụng của Sail được cấu trúc vào máy local của bạn.
Sau khi project được tạo, bạn có thể di chuyển đến thư mục ứng dụng và khởi động Laravel Sail. Laravel Sail cung cấp một giao diện command-line đơ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 upKhi container Docker của ứng dụng đã được khởi động xong, bạn có thể truy cập vào ứng dụng trong trình duyệt web của bạn tại: http://localhost.
[!NOTE] Để tiếp tục tìm hiểu thêm về Laravel Sail, hãy xem lại tài liệu đầy đủ.
Chọn service Sail bạn dùng
Khi tạo một ứng dụng Laravel mới thông qua Sail, bạn có thể sử dụng biến with để chọn service nào sẽ được cấu hình trong file docker-compose.yml của ứng dụng mới của bạn. Các service có sẵn là mysql, pgsql, mariadb, redis, memcached, meilisearch, typesense, minio, selenium và mailpit:
curl -s "https://laravel.build/example-app?with=mysql,redis" | bashNếu bạn không chỉ định service nào mà bạn muốn cấu hình, một stackp mặc định gồm có mysql, redis, meilisearch, mailpit và selenium sẽ được cấu hình mặc định.
Bạn cũng có thể chỉ định Sail cài đặt một Devcontainer mặc định vào bằng cách thêm tham số devcontainer vào URL:
curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bashIDE Support
Bạn có thể thoải mái sử dụng bất kỳ trình code editor nào mà bạn muốn khi phát triển các ứng dụng Laravel; tuy nhiên, PhpStorm cung cấp hỗ trợ toàn diện cho Laravel và hệ sinh thái của nó, bao gồm cả Laravel Pint.
Ngoài ra, cộng đồng cũng duy trì Laravel Idea, một Plugin PhpStorm cung cấp nhiều tiện ích bổ sung cho IDE, bao gồm việc tạo code, gợi ý cú pháp Eloquent, gợi ý rule validation...
Laravel and AI
Laravel Boost là một công cụ mạnh mẽ giúp thu hẹp khoảng cách giữa các AI coding agent và các ứng dụng Laravel. Boost cung cấp cho các AI agent cùng với các ngữ cảnh, công cụ và hướng dẫn cụ thể cho Laravel để chúng có thể tạo ra code chính xác hơn, phù hợp với phiên bản và tuân thủ các quy ước của Laravel.
Khi cài đặt Boost vào ứng dụng Laravel, các AI agent sẽ có quyền truy cập vào hơn 15 công cụ chuyên dụng, bao gồm khả năng nhận diện các package đang sử dụng, truy vấn cơ sở dữ liệu, tìm kiếm tài liệu Laravel, đọc log trình duyệt, tạo test và thực thi code thông qua Tinker.
Ngoài ra, Boost cung cấp cho các AI agent quyền truy cập vào hơn 17.000 tài liệu hệ sinh thái Laravel đã được vector hóa, dành riêng cho các phiên bản package mà bạn đã cài đặt. Điều này có nghĩa là các agent có thể cung cấp các hướng dẫn nhắm mục tiêu chính xác hơn đến các phiên bản mà dự án của bạn đang sử dụng.
Boost cũng chứa các hướng dẫn AI do Laravel phát triển nhằm giúp các agent tuân thủ các quy ước của framework, viết các test phù hợp và tránh các lỗi phổ biến khi tạo code Laravel.
Installing Laravel Boost
Boost có thể được cài đặt trong các ứng dụng Laravel 10, 11, 12, và 13 chạy PHP 8.1 trở lên. Để bắt đầu, hãy cài đặt Boost như một development dependency:
composer require laravel/boost --devSau khi cài đặt, hãy chạy installer:
php artisan boost:installInstaller sẽ tự động nhận diện IDE và các AI agent của bạn, cho phép bạn lựa chọn các tính năng phù hợp với dự án của mình. Boost tôn trọng các quy ước dự án hiện có và mặc định không ép buộc các quy tắc style mang tính quan điểm.
[!NOTE] Để tìm hiểu thêm về Boost, hãy xem repository Laravel Boost trên GitHub.
Bước tiếp theo
Bây giờ bạn đã tạo xong project Laravel của bạn, có thể bạn đang tự hỏi nên 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 Laravel hoạt động bằng cách đọc các tài liệu sau:
Cách bạn muốn sử dụng Laravel như thế nào cũng sẽ quyết định các bước tiếp theo trên hành trình của bạn. Có nhiều cách khác nhau để sử dụng Laravel và chúng ta sẽ khám phá hai trường hợp sử dụng chính của framework ở bên dưới.
[!NOTE] Bạn mới sử dụng Laravel? Hãy xem Laravel Bootcamp để có thể tham quan thực tế về framework và chúng tôi sẽ hướng dẫn bạn về cách xây dựng ứng dụng Laravel đầu tiên của bạn.
Laravel cho Full Stack
Laravel có thể phục vụ như một full stack framework. "Full stack" framework, ý chúng tôi muốn nói là bạn sẽ sử dụng Laravel để route các request đến ứng dụng của bạn và hiển thị giao diện người dùng của bạn thông qua Blade templates hoặc kết hợp với một single-page application như Inertia. Đây là cách phổ biến nhất để sử dụng framework Laravel và theo chúng tôi, đây là cách sử dụng Laravel hiệu quả nhất.
Nếu đây là cách mà 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ề frontend development, routing, views hoặc Eloquent ORM. Ngoài ra, bạn có thể muốn tìm hiểu về các package cộng đồng như Livewire và Inertia. Các package này cho phép bạn vẫn sử dụng Laravel làm full-stack framework trong khi vẫn 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 single-page.
Nếu bạn đang sử dụng Laravel làm full stack framework, 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 cho ứng dụng của bạn bằng cách sử dụng Vite.
[!NOTE] Nếu bạn muốn bắt đầu xây dựng ứng dụng của bạn một cách thuận lợi, hãy xem một trong các bộ công cụ tạo nhanh ứng dụng chính thức của chúng tôi.
Laravel cho backend api
Laravel cũng có thể đóng vai trò là backend API cho mộpt ứng dụng single-page JavaScript application hoặc ứng dụng di động. Ví dụ: bạn có thể sử dụng Laravel làm backend API cho ứng dụng Next.js của bạn. Trong trường hợp 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 bạn, đồng thời tận dụng các service mạnh mẽ của Laravel như queue, email, thông báo, và nhiều hơn thế nữa.
Nếu đây là cách bạn dự định sử dụng Laravel, bạn có thể muốn xem tài liệu của chúng tôi về routing, Laravel Sanctum và Eloquent ORM.
[!NOTE] Bạn cần bắt đầu xây dựng backend là Laravel và frontend là Next.js? Laravel Breeze sẽ cung cấp API stack cũng như triển khai frontend Next.js để bạn có thể bắt đầu sau vài phút.
entry
