بناء موقع Laravel بكلود AI — من التثبيت للنشر

# الطريقة الأولى: عبر Composer مباشرة
composer create-project laravel/laravel my-laravel-app
cd my-laravel-app

# الطريقة الثانية: عبر Laravel Installer (أسرع)
composer global require laravel/installer
laravel new my-laravel-app

# تشغيل خادم التطوير
php artisan serve

APP_NAME="موقعي بـ Laravel"
APP_ENV=local
APP_KEY=base64:...
APP_DEBUG=true
APP_URL=http://localhost:8000

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

CACHE_DRIVER=redis
QUEUE_CONNECTION=database
SESSION_DRIVER=database

// routes/web.php — مثال لمتجر إلكتروني
use App\Http\Controllers\ProductController;
use App\Http\Controllers\CartController;
use App\Http\Controllers\CheckoutController;

// صفحة رئيسية
Route::get('/', [ProductController::class, 'index'])->name('home');

// منتجات — Resource Route يولّد 7 routes تلقائياً
Route::resource('products', ProductController::class)->only([
    'index', 'show'
]);

// سلة التسوق — تتطلب تسجيل دخول
Route::middleware('auth')->group(function () {
    Route::get('/cart', [CartController::class, 'index'])->name('cart.index');
    Route::post('/cart/add/{product}', [CartController::class, 'add'])->name('cart.add');
    Route::delete('/cart/{item}', [CartController::class, 'remove'])->name('cart.remove');
    Route::get('/checkout', [CheckoutController::class, 'index'])->name('checkout');
    Route::post('/checkout', [CheckoutController::class, 'process'])->name('checkout.process');
});

# إنشاء Controller فارغ
php artisan make:controller ProductController

# إنشاء Resource Controller (7 methods جاهزة)
php artisan make:controller ProductController --resource

# إنشاء Controller مع Model في خطوة واحدة
php artisan make:controller ProductController --model=Product

// app/Http/Controllers/ProductController.php
namespace App\Http\Controllers;

use App\Models\Product;
use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function index()
    {
        // جلب المنتجات مع pagination وCache لمدة 5 دقائق
        $products = cache()->remember('products.index', 300, function () {
            return Product::with('category')
                ->active()
                ->latest()
                ->paginate(12);
        });

        return view('products.index', compact('products'));
    }

    public function show(Product $product)
    {
        // Route Model Binding — Laravel يجلب المنتج تلقائياً بالـ ID أو الـ slug
        $relatedProducts = Product::where('category_id', $product->category_id)
            ->where('id', '!=', $product->id)
            ->active()
            ->limit(4)
            ->get();

        return view('products.show', compact('product', 'relatedProducts'));
    }
}

# إنشاء Model مع Migration في خطوة واحدة
php artisan make:model Product -m

# إنشاء Model مع Migration وFactory وSeeder وController دفعة واحدة
php artisan make:model Product -mfsc

// database/migrations/xxxx_create_products_table.php
return new class extends Migration
{
    public function up(): void
    {
        Schema::create('products', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('slug')->unique();
            $table->text('description')->nullable();
            $table->decimal('price', 10, 2);
            $table->string('image')->nullable();
            $table->foreignId('category_id')->constrained()->cascadeOnDelete();
            $table->boolean('is_active')->default(true);
            $table->unsignedInteger('download_count')->default(0);
            $table->timestamps();
            $table->softDeletes();

            // indexes للبحث السريع
            $table->index(['is_active', 'created_at']);
            $table->index('slug');
        });
    }
};

// app/Models/Product.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Support\Str;

class Product extends Model
{
    use SoftDeletes;

    protected $fillable = [
        'name', 'slug', 'description', 'price',
        'image', 'category_id', 'is_active'
    ];

    protected $casts = [
        'is_active' => 'boolean',
        'price'     => 'decimal:2',
    ];

    // علاقة مع الفئة
    public function category()
    {
        return $this->belongsTo(Category::class);
    }

    // علاقة مع الطلبات
    public function orders()
    {
        return $this->belongsToMany(Order::class)->withTimestamps();
    }

    // Scope للمنتجات النشطة فقط
    public function scopeActive($query)
    {
        return $query->where('is_active', true);
    }

    // Accessor: تنسيق السعر بالعملة
    protected function formattedPrice(): Attribute
    {
        return Attribute::make(
            get: fn () => number_format($this->price, 2) . ' ج.م'
        );
    }

    // توليد slug تلقائياً قبل الحفظ
    protected static function boot()
    {
        parent::boot();
        static::creating(function ($product) {
            $product->slug ??= Str::slug($product->name);
        });
    }
}

# تشغيل كل Migrations
php artisan migrate

# تشغيل مع بيانات تجريبية
php artisan migrate --seed

# إعادة البناء من الصفر (في التطوير فقط)
php artisan migrate:fresh --seed

{{-- resources/views/layouts/app.blade.php --}}
<!DOCTYPE html>
<html lang="ar" dir="rtl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>@yield('title', config('app.name'))</title>
    @vite(['resources/css/app.css', 'resources/js/app.js'])
    @stack('styles')
</head>
<body class="bg-gray-50">
    <x-header />

    <main class="container mx-auto px-4 py-8">
        @if(session('success'))
            <x-alert type="success" :message="session('success')" />
        @endif

        @yield('content')
    </main>

    <x-footer />

    @stack('scripts')
</body>
</html>

{{-- resources/views/products/index.blade.php --}}
@extends('layouts.app')

@section('title', 'جميع المنتجات')

@section('content')
<div class="mb-6">
    <h1 class="text-3xl font-bold text-gray-900">المنتجات</h1>
    <p class="text-gray-500 mt-1">{{ $products->total() }} منتج متاح</p>
</div>

<div class="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-6">
    @forelse($products as $product)
        <x-product-card :product="$product" />
    @empty
        <div class="col-span-full text-center py-16 text-gray-400">
            لا توجد منتجات حالياً
        </div>
    @endforelse
</div>

<div class="mt-8">
    {{ $products->links() }}
</div>
@endsection

{{-- resources/views/components/product-card.blade.php --}}
@props(['product'])

<div class="bg-white rounded-xl shadow-sm hover:shadow-md transition-shadow overflow-hidden">
    <a href="{{ route('products.show', $product->slug) }}">
        <img
            src="{{ asset('storage/' . $product->image) }}"
            alt="{{ $product->name }}"
            class="w-full h-48 object-cover"
            loading="lazy"
        >
    </a>
    <div class="p-4">
        <h3 class="font-semibold text-gray-900 truncate">
            <a href="{{ route('products.show', $product->slug) }}">
                {{ $product->name }}
            </a>
        </h3>
        <div class="flex items-center justify-between mt-3">
            <span class="text-xl font-bold text-indigo-600">
                {{ $product->formatted_price }}
            </span>
            <form action="{{ route('cart.add', $product) }}" method="POST">
                @csrf
                <button type="submit" class="bg-indigo-600 text-white px-4 py-2 rounded-lg text-sm hover:bg-indigo-700 transition">
                    أضف للسلة
                </button>
            </form>
        </div>
    </div>
</div>

# تثبيت Filament
composer require filament/filament:"^3.0"

# نشر وتثبيت Filament
php artisan filament:install --panels

# إنشاء مستخدم admin أول
php artisan make:filament-user

# نشر Assets
php artisan filament:assets

# إنشاء Filament Resource
php artisan make:filament-resource Product --generate

// app/Filament/Resources/ProductResource.php
namespace App\Filament\Resources;

use Filament\Forms;
use Filament\Tables;
use Filament\Resources\Resource;
use App\Models\Product;

class ProductResource extends Resource
{
    protected static ?string $model = Product::class;
    protected static ?string $navigationIcon = 'heroicon-o-shopping-bag';
    protected static ?string $navigationLabel = 'المنتجات';
    protected static ?string $pluralLabel = 'المنتجات';

    public static function form(Forms\Form $form): Forms\Form
    {
        return $form->schema([
            Forms\Components\Section::make('معلومات المنتج')->schema([
                Forms\Components\TextInput::make('name')
                    ->label('اسم المنتج')
                    ->required()
                    ->maxLength(255)
                    ->live(onBlur: true)
                    ->afterStateUpdated(fn ($state, $set) =>
                        $set('slug', \Illuminate\Support\Str::slug($state))),

                Forms\Components\TextInput::make('slug')
                    ->label('الرابط المختصر')
                    ->unique(ignoreRecord: true)
                    ->required(),

                Forms\Components\Textarea::make('description')
                    ->label('الوصف')
                    ->rows(4)
                    ->columnSpanFull(),

                Forms\Components\TextInput::make('price')
                    ->label('السعر')
                    ->numeric()
                    ->prefix('ج.م')
                    ->required(),

                Forms\Components\Select::make('category_id')
                    ->label('الفئة')
                    ->relationship('category', 'name')
                    ->searchable()
                    ->preload()
                    ->required(),

                Forms\Components\FileUpload::make('image')
                    ->label('صورة المنتج')
                    ->image()
                    ->directory('products')
                    ->columnSpanFull(),

                Forms\Components\Toggle::make('is_active')
                    ->label('منتج نشط')
                    ->default(true),
            ])->columns(2),
        ]);
    }

    public static function table(Tables\Table $table): Tables\Table
    {
        return $table
            ->columns([
                Tables\Columns\ImageColumn::make('image')->label('صورة')->circular(),
                Tables\Columns\TextColumn::make('name')->label('الاسم')->searchable()->sortable(),
                Tables\Columns\TextColumn::make('category.name')->label('الفئة')->badge(),
                Tables\Columns\TextColumn::make('price')->label('السعر')->money('EGP')->sortable(),
                Tables\Columns\ToggleColumn::make('is_active')->label('نشط'),
                Tables\Columns\TextColumn::make('created_at')->label('تاريخ الإضافة')->dateTime('d/m/Y')->sortable(),
            ])
            ->filters([
                Tables\Filters\SelectFilter::make('category')->label('الفئة')->relationship('category', 'name'),
                Tables\Filters\TernaryFilter::make('is_active')->label('الحالة'),
            ])
            ->actions([
                Tables\Actions\EditAction::make()->label('تعديل'),
                Tables\Actions\DeleteAction::make()->label('حذف'),
            ])
            ->bulkActions([
                Tables\Actions\BulkActionGroup::make([
                    Tables\Actions\DeleteBulkAction::make()->label('حذف المحدد'),
                ]),
            ]);
    }
}

# تثبيت Laravel Sanctum
composer require laravel/sanctum
php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
php artisan migrate

// routes/api.php — API Routes منظمة
use App\Http\Controllers\Api\AuthController;
use App\Http\Controllers\Api\ProductController;

Route::prefix('v1')->group(function () {

    // Authentication Routes — متاحة بدون Token
    Route::post('/register', [AuthController::class, 'register']);
    Route::post('/login', [AuthController::class, 'login']);

    // Protected Routes — تتطلب Token صالح
    Route::middleware('auth:sanctum')->group(function () {
        Route::post('/logout', [AuthController::class, 'logout']);
        Route::get('/me', [AuthController::class, 'me']);
        Route::apiResource('products', ProductController::class);
    });
});

# إنشاء API Resource
php artisan make:resource ProductResource
php artisan make:resource ProductCollection

// app/Http/Resources/ProductResource.php
namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;

class ProductResource extends JsonResource
{
    public function toArray($request): array
    {
        return [
            'id'             => $this->id,
            'name'           => $this->name,
            'slug'           => $this->slug,
            'description'    => $this->description,
            'price'          => (float) $this->price,
            'formatted_price' => $this->formatted_price,
            'image_url'      => $this->image
                ? asset('storage/' . $this->image)
                : null,
            'category'       => [
                'id'   => $this->category->id,
                'name' => $this->category->name,
            ],
            'download_count' => $this->download_count,
            'is_active'      => $this->is_active,
            'created_at'     => $this->created_at->toISOString(),
        ];
    }
}

// app/Http/Controllers/Api/ProductController.php
namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use App\Http\Resources\ProductResource;
use App\Models\Product;
use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function index()
    {
        $products = Product::with('category')
            ->active()
            ->paginate(15);

        return ProductResource::collection($products)
            ->additional(['status' => 'success']);
    }

    public function show(Product $product)
    {
        return response()->json([
            'status' => 'success',
            'data'   => new ProductResource($product->load('category')),
        ]);
    }

    public function store(Request $request)
    {
        $validated = $request->validate([
            'name'        => 'required|string|max:255',
            'description' => 'nullable|string',
            'price'       => 'required|numeric|min:0',
            'category_id' => 'required|exists:categories,id',
            'image'       => 'nullable|image|max:2048',
        ]);

        if ($request->hasFile('image')) {
            $validated['image'] = $request->file('image')->store('products', 'public');
        }

        $product = Product::create($validated);

        return response()->json([
            'status'  => 'success',
            'message' => 'تمت إضافة المنتج بنجاح',
            'data'    => new ProductResource($product),
        ], 201);
    }
}

# تثبيت PHP 8.3 وExtensions المطلوبة
sudo apt update && sudo apt upgrade -y
sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php -y
sudo apt install -y php8.3 php8.3-fpm php8.3-mysql php8.3-mbstring \
    php8.3-xml php8.3-curl php8.3-zip php8.3-bcmath php8.3-gd php8.3-redis

# تثبيت Nginx وMySQL
sudo apt install -y nginx mysql-server

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

# /etc/nginx/sites-available/my-laravel-app
server {
    listen 80;
    server_name example.com www.example.com;
    root /var/www/my-laravel-app/public;
    index index.php;

    # تمرير PHP Requests لـ PHP-FPM
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # إعادة توجيه كل الطلبات لـ index.php (Laravel Routing)
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # Cache للـ Static Files
    location ~* \.(css|js|jpg|jpeg|png|gif|ico|woff2)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }

    # أمان: منع الوصول لملفات حساسة
    location ~ /\.(env|git) {
        deny all;
    }
}

#!/bin/bash
# deploy.sh — سكريبت نشر Laravel

cd /var/www/my-laravel-app

# سحب آخر الكود
git pull origin main

# تثبيت dependencies (بدون dev packages)
composer install --no-dev --optimize-autoloader

# تشغيل Migrations الجديدة
php artisan migrate --force

# تحسين الأداء في الإنتاج
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache

# إعادة تشغيل Queue Workers
php artisan queue:restart

# الصلاحيات الصحيحة
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

echo "✅ النشر اكتمل بنجاح!"