وانە یەکەم: دەستپێکردن بە Laravel

Laravel چییە؟

Laravel فرەیمۆوەرکی (Framework) کۆدی کراوە زانیارییە کە بە زمانی PHP دروست کراوە و بۆ پەرەپێدانی ئەپڵیکەیشنە نوێنەکانی وێب بەکاردێت. Laravel بەهێزی خۆی لە سادگیی بەکارهێنان، کاراییی باڵا، و پشتگیرییە گەورە لەلایەن کۆمەڵگەوە دەردەکەوێت. Laravel چەندین تایبەتمەندییەکی هەیە کە پرۆسەی پەرەپێدانی ئەپڵیکەیشن سادەتر دەکات، وەک:

• ڕێڕەوکردن (Routing) .
• ئەنجامدادەری بنکەی داتا و پەیوەندییەکان (Eloquent ORM) .
• سیستەمی ڕاستەوخۆبوون (Authentication) .
• مووتۆری قالبەکان (Blade Templating Engine) .
• ئامرازەکان بۆ بەڕێوەبردنی کارە پشتگەڵەکان (Queues, Jobs) .

بۆچی Laravel؟

• ئاسانی فێربوون : Laravel ڕەچاوێکی ورد و ئاشکرا پێشکەش دەکات.
• کۆمەڵگەیەکی گەورە : چەندین چارەسەر و بەڵگەنامەی ئاماژەیی هەیە.
• کێشکردن : هەر جۆرێک لە ئەپڵیکەیشنی وێب بەکاری دەتوانیت بەرهەم بهێنیت.
• ئامرازەکانی ئامادە : ئامرازەکانی وەک Artisan CLI کە کارە ئاساییەکانی بە ئاسانی ئەنجام دەدات.

پێویستییە سەرەکییەکان

پێش دەستپێکردن بە فێربوونی Laravel ، پێویستە زانیاریە بنەڕەتییەکانی خوارەوەت هەبێت:

• PHP : پێویستە زانیاری باشی لە زمانی PHP هەبێت.
• MySQL یان هەر بنکەیەکی داتا: پێویستە بزانیت چۆن بە بنکەی داتا کار بکەیت.
• HTML/CSS/JavaScript : بۆ دروستکردنی رابەتی بەکارهێنەر.
• Composer : ئامرازی بەڕێوەبردنی پاکەتەکانی PHP.

ئامادەکردنی ژینگەی شوێنی

بۆ دەستپێکردن بە کارکردن لەگەڵ Laravel ، پێویستە ژینگەیەکی پەرەپێدانی شوێنی ئامادە بکەیت. لێرەدا چەندین هەنگاوی ورد هەیە:

1. سەرجەمکردنی PHP

PHP زمانی بنەڕەتییە کە Laravel لەسەر بەکاردێت. بۆیە پێویستە PHP لەسەر کۆمپیوتەرەکەت سەرجەم بکرێت.

لەسەر ویندۆز:

• بڕۆ بۆ ماڵپەڕی PHP: https://windows.php.net/download/ .
• وەرگرە وەشانی گونجاو بۆ سیستەمەکەت (64-bit یان 32-bit). وەشانی نوێتر (وەک PHP 8.x) پێشنیار دەکرێت.
• دوای داگرتن، فایلەکان بەردەوە بۆ پوختەیەک لەسەر کۆمپیوتەرەکەت (وەک C:\php).
• مەرجەکانی PHP زیاد بکە بۆ گۆڕەکەکانی ژینگە:
  • "Control Panel" → "System" → "Advanced system settings".
  • "Environment Variables" بکە.
  • لە "System variables"، "Path" بدۆزەرەوە و "Edit" بکە.
  • مەرجی کە PHP لێی داگرتون (وەک C:\php) زیاد بکە و "OK" بکە.
• بۆ ئەوەی بزانیت PHP بە دروستی کار دەکات، تێرمینال (Command Prompt) کردووە و بنووسە:
   

  php -v

   
  ئەگەر ژمارەی وەشان دەرکەوێت، ئەوە وایە PHP بە دروستی سەرجەم کراوە.

لەسەر macOS:

• macOS بەشێوەیەکی ئاسایی PHP هەیە. بۆ ئەزموون:

  php -v
  ئەگەر نەبوو، بەکاربێنە Homebrew:

  brew install php

لەسەر Linux (Ubuntu):

sudo apt update
sudo apt install php

بۆ ئەزموون:

php -v

2. سەرجەمکردنی Composer

Composer ئامرازێکی بەڕێوەبردنی پاکەتەکانی PHP یە کە بۆ سەرجەمکردن و بەڕێوەبردنی Laravel بەکاردێت. بێ ئەم ئامرازە، ناتوانیت Laravel بەکاربهێنیت.

لەسەر ویندۆز:

• بڕۆ بۆ ماڵپەڕی Composer: https://getcomposer.org/download/ .
• وەرگرە فایلی سەرجەمکردنی ویندۆز (Composer-Setup.exe).
• بە شێوەیەکی ئاسایی سەرجەم بکە.
• بۆ ئەزموون:

  composer --version

لەسەر macOS/Linux:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

بۆ ئەزموون:

composer --version

3. سەرجەمکردنی XAMPP یان Laragon

XAMPP و Laragon دوو هەڵبژاردنی بەناوبانگن بۆ ئامادەکردنی ژینگەی PHPی شوێنی. تۆ دەتوانیت یەکێکیان بەکاربهێنیت.

XAMPP:

• بڕۆ بۆ ماڵپەڕی XAMPP: https://www.apachefriends.org/index.html .
• داگرە و سەرجەم بکە.
• دوای سەرجەمکردن، پەنەلی کۆنتڕۆڵی XAMPP بکەروە و Apache و MySQL بەکاربهێنە.

Laragon:

• بڕۆ بۆ ماڵپەڕی Laragon: https://laragon.org/ .
• داگرە و سەرجەم بکە.
• دوای سەرجەمکردن، Laragon بکەروە و Apache و MySQL بەکاربهێنە.

4. سەرجەمکردنی Laravel

دوای سەرجەمکردنی Composer، تۆ دەتوانیت Laravel بەکاربهێنیت بە ئەم فەرمانەیە لە تێرمینالدا:

composer global require laravel/installer

5. دروستکردنی پڕۆژەیەکی نوێ

بۆ دروستکردنی پڕۆژەیەکی Laravel ی نوێ، ئەم فەرمانە بەکاربهێنە:

laravel new my-first-laravel-app

ئەم فەرمانە پوختەیەکی نوێ دروست دەکات بە ناوی my-first-laravel-app کە ڕەچاوی بنەڕەتی پڕۆژەکەی تێدایە.

6. چالاککردنی خزمەتگوزاری شوێنی

بڕۆ بۆ پوختەی پڕۆژەکە بەکاربێنەرەوە لە تێرمینالدا:

cd my-first-laravel-app

ئینجا خزمەتگوزاری شوێنی بەکاربهێنە:

php artisan serve

پەیامێک دەردەکەوێت کە دەڵێت خزمەتگوزاری لە ناونیشانی http://127.0.0.1:8000 کار دەکات. ئەم بەستەرە بکەرەوە بۆ بینینی پەڕەی سەرەکییەکەی Laravel .

ڕەچاوی پڕۆژەی Laravel

کاتێک پڕۆژەیەکی Laravel بکەیت، چەندین پوختە و فایل دەبینیت. گرنگترینیان:

• app/ : نموذجەکان (Models)، کۆنتڕۆڵەکان (Controllers)، و زیاتر.
• routes/ : فایلەکانی ڕێڕەوکردن (Routes).
• resources/ : قالبەکان (Views) و فایلەکانی تر.
• public/ : فایلەکانی گشتی وەک CSS و JavaScript.
• config/ : فایلەکانی ڕێکخستن.

نووسینی یەکەم Route

با دەست پێ بکەین بە نووسینی یەکەم Route لە Laravel دا. فایلی routes/web.php بکەروە و ئەم کۆدە زیاد بکە:

use Illuminate\Support\Facades\Route;


Route::get('/', function () {
return 'مرحبًا بك في Laravel!';
});

ئەم کۆدە نامەیەکی "مرحبًا بك في Laravel!" دەردەخات کاتێک پەڕەی سەرەکی (/) بینیت.

ڕێڕەوکردنەکان (Routes) لە Laravel

ڕێڕەوکردنەکان ڕێگایەکی Laravel ن بۆ چاکسازی داواکانی HTTP. ئێمە دەتوانین ڕێڕەوکردنەکان بەکاربێنین بە ڕێگەی فەرمانی Route::get() یان Route::post() و هتد.

نموونەی تر:

Route::get('/about', function () {
return 'هذه هي صفحة عن الموقع.';
});

کاتێک بەستەری http://127.0.0.1:8000/about بکەیت، نامەیەک دەردەکەوێت کە دەڵێت "هذه هي صفحة عن الموقع."

Artisan CLI

Artisan ئامرازێکی فەرمانی تێرمینالی Laravel یە. ئێمە دەتوانین بەکاری بێنین بۆ دروستکردنی فایلەکان، ڕاکردنی هەڵگەڕان (Migrations)، و هتد. بۆ نموونە:

• بۆ دروستکردنی Controller ی نوێ:

  php artisan make:controller MyController
• بۆ دروستکردنی Model ی نوێ:

  php artisan make:model Post

ئەنجام

لەم وانەیەدا، ئێمە فێر بووین:

• Laravel چییە و بۆچی هەڵبژاردنێکی باشە بۆ پەرەپێدانی ئەپڵیکەیشنەکانی وێب.
• چۆن PHP و Composer سەرجەم بکەین و ژینگەی شوێنی ئامادە بکەین بە بەکارهێنانی XAMPP یان Laragon.
• چۆن Laravel سەرجەم بکەین و پڕۆژەیەکی نوێ دروست بکەین.
• نووسینی یەکەم Route و تێگەیشتن لە ڕەچاوی پڕۆژەکە.

ئەگەر ئامادەیت بۆ بەردەوامبوون، دەتوانین بگەڕێینەوە بۆ وانەی دووەم کە لەوێ دەربارەی Controllers و Views و چۆن بەرهەم بهێنینی پەڕەکانی وێب بە Laravel صحبت دەکەین.