علاء عامر

تثبيت وإعداد Laravel: دليل شامل للمبتدئين

تثبيت وإعداد Laravel: دليل شامل للمبتدئين

دليل تخصصي من علاء عامر – مطور ومصمم مواقع وتطبيقات محترف

إعداد بيئة Laravel الصحيحة هو الخطوة الأولى نحو تطوير تطبيقات ويب احترافية. في هذا الدليل الشامل، ستتعلم كل ما تحتاجه.

2️⃣ تثبيت Laravel على أنظمة التشغيل المختلفة

تثبيت على Windows:

# 1. تثبيت Composer من الموقع الرسمي
# https://getcomposer.org/download/

# 2. تثبيت Laravel Installer
composer global require laravel/installer

# 3. إضافة مجلد Composer للمسار
# Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin

# 4. إنشاء مشروع جديد
laravel new my-project
# أو
composer create-project laravel/laravel my-project

# 5. الانتقال للمجلد وتشغيل الخادم
cd my-project
php artisan serve

تثبيت على macOS:

# 1. تثبيت Homebrew (إذا لم يكن مثبتاً)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2. تثبيت PHP وComposer
brew install php composer

# 3. تثبيت Laravel Installer
composer global require laravel/installer

# 4. إضافة مجلد Composer للمسار
echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 5. إنشاء مشروع Laravel
laravel new my-project --git --branch=main
cd my-project
php artisan serve

تثبيت على Linux (Ubuntu/Debian):

# 1. تحديث النظام
sudo apt update && sudo apt upgrade -y

# 2. تثبيت PHP والإضافات
sudo apt install php8.2 php8.2-cli php8.2-mbstring php8.2-xml \
    php8.2-mysql php8.2-zip php8.2-curl php8.2-gd \
    php8.2-intl php8.2-bcmath unzip -y

# 3. تثبيت Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

# 4. تثبيت Laravel
composer global require laravel/installer

# 5. إضافة مجلد Composer للمسار
echo 'export PATH="$HOME/.config/composer/vendor/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 6. إنشاء مشروع Laravel
laravel new my-project
cd my-project
php artisan serve --host=0.0.0.0 --port=8000

4️⃣ إعداد خادم الويب

إعداد Apache Virtual Host:

# /etc/apache2/sites-available/laravel-app.conf
<VirtualHost *:80>
    ServerName laravel-app.local
    ServerAlias www.laravel-app.local
    DocumentRoot /var/www/laravel-app/public

    <Directory /var/www/laravel-app/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/laravel-app_error.log
    CustomLog ${APACHE_LOG_DIR}/laravel-app_access.log combined
</VirtualHost>

# تفعيل الموقع وإعادة تشغيل Apache
sudo a2ensite laravel-app.conf
sudo a2enmod rewrite
sudo systemctl restart apache2

# إضافة الدومين لملف hosts
echo "127.0.0.1 laravel-app.local" | sudo tee -a /etc/hosts

docker-compose.yml:

version: "3.8"

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    image: laravel-app
    container_name: laravel-app
    restart: unless-stopped
    working_dir: /var/www
    volumes:
      - ./:/var/www
    networks:
      - laravel

  webserver:
    image: nginx:alpine
    container_name: laravel-nginx
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - ./:/var/www
      - ./docker/nginx:/etc/nginx/conf.d
    networks:
      - laravel

  db:
    image: mysql:8.0
    container_name: laravel-mysql
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: laravel
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_USER: laravel
      MYSQL_PASSWORD: laravel
    ports:
      - "3307:3306"
    volumes:
      - dbdata:/var/lib/mysql
    networks:
      - laravel

  redis:
    image: redis:alpine
    container_name: laravel-redis
    restart: unless-stopped
    ports:
      - "6380:6379"
    networks:
      - laravel

networks:
  laravel:
    driver: bridge

volumes:
  dbdata:
    driver: local

💡 نصائح للإعداد المثالي

1. استخدم Laravel Sail للتطوير السريع مع Docker
2. فعّل SSL حتى في بيئة التطوير المحلية
3. استخدم متغيرات البيئة لجميع الإعدادات الحساسة
4. اعمل backup منتظم لقاعدة البيانات
5. استخدم Git لإدارة الإصدارات من البداية
6. فعّل التسجيل المتقدم لتتبع الأخطاء
7. اختبر البيئة الإنتاجية قبل النشر

الخطوة التالية

تعلم نمط MVC في Laravel وكيفية إنشاء أول Controller و Model.

📩 هل تواجه مشاكل في إعداد Laravel؟