Module 1: හැඳින්වීම සහ මූලික සැකසුම

මෙම මොඩියුලයෙන් අපි Laravel 11 යනු කුමක්දැයි හඳුනාගෙන, අපගේ project එකට අවශ්‍ය මූලික පරිසරය සකසා ගනිමු.

Laravel යනු **PHP** භාෂාවෙන් ලියන ලද, **MVC (Model-View-Controller)** αρχιτεκტურාව මත පදනම් වූ ප්‍රබල සහ ජනප්‍රිය web application framework එකකි. සරලව කිවහොත්, සංකීර්ණ වෙබ් යෙදුම් පහසුවෙන් සහ වේගවත්ව නිර්මාණය කිරීමට අවශ්‍ය මෙවලම් (tools) සහ ව්‍යුහයක් Laravel මගින් අපට සපයයි.

Laravel 11 හි ප්‍රධාන වාසි:

  • Minimalist Application Structure: Laravel 11 වලදී අනවශ්‍ය files ඉවත් කර, ඉතා සරල සහ gọn folder structure එකක් හඳුන්වා දී ඇත.
  • Elegant Syntax: ඉතා කියවීමට පහසු, සුන්දර කේත (code) ලිවීමට ඉඩ සලසයි.
  • Eloquent ORM: Database සමග ඉතා පහසුවෙන් ගනුදෙනු කිරීමට ඉඩ සලසන පද්ධතියකි. SQL queries වෙනුවට PHP code මගින් database සමග කතා කල හැක.
  • Blade Templating Engine: HTML code සමග PHP code ඉතා ක්‍රමවත්ව සහ පිරිසිදුව ලිවීමට ඉඩ සලසයි.
  • Artisan Console: විධාන (commands) මගින් project එකේ බොහෝ දේ ස්වයංක්‍රීයව කරගැනීමට උදව් වන command-line tool එකකි.

Laravel project එකක් run කිරීමට අපට මෘදුකාංග කිහිපයක් අවශ්‍ය වේ.

  1. Web Server (XAMPP/WAMP): මෙය අපට Apache (Web Server), PHP, සහ MariaDB/MySQL (Database) යන තුනම එකවර ලබා දේ. XAMPP ಡೌನ್‌ಲೋಡ್ කර install කරගන්න.
  2. Composer: මෙය PHP සඳහා වන dependency manager එකකි. අපගේ project එකට අවශ්‍ය PHP packages (libraries) install කර කළමනාකරණය කරන්නේ Composer මගිනි. Composer install කරගන්න.
  3. Node.js: Frontend assets (CSS, JavaScript) compile කිරීමට අවශ්‍ය වේ. Node.js install කරගන්න.
  4. Code Editor: Visual Studio Code නිර්දේශ කරනු ලැබේ.

ඔබගේ පරිගණකයේ Terminal (Command Prompt හෝ Git Bash) එක open කර, පහත command එක run කරන්න. මෙය `car-booking-system` නමින් නව Laravel project එකක් නිර්මාණය කරනු ඇත.

composer create-project laravel/laravel car-booking-system

Project එක create වූ පසු, එම folder එකට යන්න:

cd car-booking-system

දැන්, Laravel හි development server එක start කිරීමට පහත Artisan command එක run කරන්න:

php artisan serve
දැන් ඔබගේ web browser එකෙන් http://127.0.0.1:8000 වෙත පිවිසෙන්න. ඔබට Laravel welcome page එක දැකගත හැකි වනු ඇත!

Laravel 11 වලදී folder structure එක ඉතා සරල කර ඇත. ආරම්භකයෙකු ලෙස ඔබ දැනගත යුතුම ප්‍රධාන directories කිහිපයක්:

  • app/ - අපගේ යෙදුමේ ප්‍රධාන logic එක (Models, Controllers) අඩංගු වන්නේ මෙහිය.
  • bootstrap/ - Framework එක start-up කරන files මෙහි අඩංගු වේ.
  • config/ - Application එකේ සියලුම configuration files මෙහි ඇත.
  • database/ - Database migrations, seeders, සහ factories මෙහි අඩංගු වේ.
  • public/ - Web server එකේ document root එක මෙයයි. index.php file එක මෙහි ඇත.
  • resources/views/ - අපගේ HTML (Blade templates) files අඩංගු වන්නේ මෙහිය.
  • routes/ - අපගේ application එකේ URL (routes) define කරන්නේ මෙහිය. web.php යනු අප වැඩියෙන්ම භාවිතා කරන file එකයි.

.env file එක යනු අපගේ application එකේ පරිසරයට (environment) අදාළ settings (උදා: database credentials, app name) ගබඩා කර තබන ස්ථානයයි. මෙම file එකේ ඇති තොරතුරු sensitive වන බැවින් version control (Git) වලට ඇතුලත් නොවේ.

ඔබගේ project එකේ root directory එකේ ඇති .env file එක open කරගන්න. Database connection එකට අදාළ කොටස මෙසේ දිස්වනු ඇත:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

XAMPP හි phpMyAdmin වෙත ගොස් car_booking_db නමින් නව database එකක් සාදන්න. ඉන්පසු .env file එකේ DB_DATABASE අගය ඒ නමින් වෙනස් කරන්න.

DB_DATABASE=car_booking_db
ඔබගේ XAMPP/WAMP වල MySQL username එක `root` සහ password එක හිස් (`''`) නොවේ නම්, එම අගයන්ද .env file එකේ DB_USERNAME සහ DB_PASSWORD සඳහා යොදන්න.