نصب Composer روی ویندوز — راهنمای کامل برای Laravel و PHP

Composer بدون Laravel تقریباً بی‌معناست — و بدون Composer روی ویندوز، نصف آموزش‌های فارسی عملی نمی‌شوند. اگر XAMPP را نصب کرده‌اید، قدم بعدی دقیقاً همین است: نصب درست Composer و اتصالش به C:\xampp\php\php.exe.

Composer چیست و چرا لازم است؟

مدیر وابستگی PHP. پکیج‌ها را از Packagist می‌گیرد، در vendor/ می‌گذارد، autoload PSR-4 می‌سازد. Laravel خودش یک پکیج Composer است.

روش ۱ — Composer-Setup.exe (پیشنهادی)

1. از getcomposer.org Windows Installer را بگیرید
2. مسیر PHP را به C:\xampp\php\php.exe بدهید
3. گزینه «Add to PATH» را فعال کنید
4. ترمینال جدید باز کنید: composer -V

روش ۲ — نصب دستی composer.phar

cd C:\xampp\php
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

فایل composer.bat در PATH بسازید که php C:\xampp\php\composer.phar %* را اجرا کند.

تنظیمات مفید بعد از نصب

composer config -g process-timeout 2000
composer config -g preferred-install dist
composer diagnose

در ایران اگر دانلود کند است، VPN پایدار یا mirror امتحان کنید. composer diagnose مشکلات SSL و extension را نشان می‌دهد.

خطاهای رایج

php is not recognized

مسیر C:\xampp\php را به Environment Variables → Path اضافه کنید.

ext-curl / openssl disabled

در php.ini اکستنشن‌ها را فعال کنید — همان مرحله نصب Laravel.

SSL certificate problem

به‌روزرسانی CA bundle یا موقتاً تنظیم secure-http (با احتیاط). بهتر: php.ini مقدار curl.cainfo را به فایل cacert.pem بدهید.

اولین پروژه

cd C:\xampp\htdocs
composer create-project laravel/laravel my-app "12.*"

دستورات روزمره

composer install
composer update
composer require spatie/laravel-permission
composer dump-autoload

در production همیشه composer install --no-dev --optimize-autoloader.

جمع‌بندی

Composer + PHP درست = دروازه Laravel. بعد از نصب، ساختار پوشه‌ها و فایل .env را بخوانید.

راه‌اندازی پروژه — کمک می‌کنم.