1. මෙම පාඩමේදී අවධානය යොමු කරන ගොනු සහ මෙවලම්
මෙම පාඩමේදී, අපි අපගේ Laravel යෙදුම දත්ත ගබඩාවකට සම්බන්ධ කිරීමට අවශ්ය සැකසුම් සිදු කරන්නෙමු.
hello-app/ └── .env <-- (1. Database සම්බන්ධතා තොරතුරු මෙහි ඇතුළත් කරමු) phpMyAdmin <-- (2. Database එක සෑදීමට භාවිතා කරන මෙවලම) Terminal/CMD <-- (3. සම්බන්ධතාවය පරීක්ෂා කිරීමට භාවිතා කරමු)
2. phpMyAdmin හි දත්ත ගබඩාවක් (Database) සෑදීම
- ඔබගේ XAMPP Control Panel හි Apache සහ MySQL ක්රියාත්මක වන බවට වග බලා ගන්න.
- වෙබ් බ්රව්සරය විවෘත කර
http://localhost/phpmyadminවෙත පිවිසෙන්න. - වම් පස ඇති "New" බොත්තම ක්ලික් කරන්න.
- "Database name" යන කොටසේ, ඔබගේ දත්ත ගබඩාව සඳහා නමක් ඇතුළත් කරන්න. අපි
hello_app_dbලෙස භාවිතා කරමු. - Collation එක සඳහා
utf8mb4_unicode_ciතෝරා "Create" බොත්තම ක්ලික් කරන්න.
දැන් ඔබගේ හිස් දත්ත ගබඩාව සූදානම්.
3. .env ගොනුව සැකසීම
.env ගොනුව ඔබගේ යෙදුමේ පරිසරයට අදාළ සැකසුම් (environment configurations) රඳවා තබා ගනී. දත්ත ගබඩා සම්බන්ධතා තොරතුරු වැනි සංවේදී දත්ත ගබඩා කරන්නේ මෙහිය.
VS Code හි ඔබගේ ව්යාපෘතියේ root directory එකේ ඇති .env ගොනුව විවෘත කරන්න. එහි DB_ වලින් ආරම්භ වන කොටස සොයා ගන්න. එය මේ ආකාරයට දිස්වනු ඇත:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
දැන්, අපි පෙර පියවරේදී සෑදූ දත්ත ගබඩාවට ගැලපෙන පරිදි එය වෙනස් කරමු. ඔබ වෙනස් කළ යුත්තේ DB_DATABASE අගය පමණි.
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=hello_app_db
DB_USERNAME=root
DB_PASSWORD=
.env ගොනුවේ වෙනසක් සිදු කළ පසු, එම වෙනස්කම් යෙදුමට ලබාගැනීම සඳහා ඔබගේ Laravel development server එක (php artisan serve) නවත්වා නැවත ආරම්භ කිරීම අනිවාර්ය වේ.
4. සම්බන්ධතාවය පරීක්ෂා කිරීම සහ Migrations Run කිරීම
අපගේ සැකසුම් නිවැරදි දැයි පරීක්ෂා කිරීමට හොඳම ක්රමය වන්නේ Laravel හි migrate command එක ක්රියාත්මක කිරීමයි. Migrations යනු දත්ත ගබඩාවේ වගු (tables) සෑදීම සඳහා වන ගොනු වේ.
ඔබගේ VS Code terminal එකේ පහත command එක ක්රියාත්මක කරන්න:
php artisan migrate
සාර්ථක ප්රතිචාරයක් (Success):
සම්බන්ධතාවය නිවැරදි නම්, ඔබට මෙවැනි ප්රතිචාරයක් දැකගත හැක. Laravel විසින් පෙරනිමි වගු කිහිපයක් ඔබගේ දත්ත ගබඩාවේ සාර්ථකව නිර්මාණය කළ බව මෙයින් කියවේ.
INFO Running migrations.
2014_10_12_000000_create_users_table .................... 10ms DONE
2014_10_12_100000_create_password_reset_tokens_table ... 12ms DONE
2019_08_19_000000_create_failed_jobs_table ............. 15ms DONE
දෝෂයක් (Error):
Access denied හෝ Unknown database වැනි දෝෂයක් පැමිණියහොත්, ඔබගේ .env ගොනුවේ DB_DATABASE, DB_USERNAME, හෝ DB_PASSWORD වැරදි ලෙස ඇතුළත් කර ඇත. නැවත පරීක්ෂා කර බලන්න.
දැන් නැවත phpMyAdmin වෙත ගොස් hello_app_db database එක refresh කර බලන්න. එහි users, migrations වැනි නව වගු කිහිපයක් සෑදී ඇති බව ඔබට පෙනෙනු ඇත.