پیش‌نیازها

در این سند

• در این سند
• پیش‌نیازهای سیستم
• بررسی نسخه‌های نصب‌شده
• گام بعدی

قبل از راه‌اندازی پروژه، مطمئن شوید که سیستم شما دارای پیش‌نیازهای زیر است:

پیش‌نیازهای سیستم

پیش‌نیازها

نرم‌افزارهای زیر باید پیش از شروع راه‌اندازی پروژه پلنت روی سیستم شما نصب شده باشند:

همه سیستم‌ها

نسخه‌های مورد نیاز نرم‌افزارها

Node.js: >=18.0.0
npm: >=8.0.0
php: >=8.1
composer: >=2.1.0
docker: >=20.10.0

لینوکس

برای کاربران لینوکس، می‌توانید این وابستگی‌ها را با استفاده از مدیر بسته توزیع خود نصب کنید:

اوبونتو/دبیان

# به‌روزرسانی لیست بسته‌ها
sudo apt update

# نصب Node.js و npm
sudo apt install nodejs npm

# نصب PHP
sudo apt install php8.1 php8.1-cli php8.1-common

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

macOS

برای کاربران macOS، استفاده از Homebrew توصیه می‌شود:

macOS با Homebrew

# نصب Homebrew در صورت نیاز
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# نصب Node.js و npm
brew install node

# نصب PHP
brew install php@8.1

# نصب Composer
brew install composer

ویندوز

برای کاربران ویندوز، استفاده از WSL2 (زیرسیستم لینوکس ویندوز) برای بهترین تجربه توسعه توصیه می‌شود.

همچنین می‌توانید پیش‌نیازها را به صورت دستی نصب کنید:

1. دانلود و نصب Node.js از nodejs.org
2. دانلود و نصب PHP از windows.php.net
3. دانلود و نصب Composer از getcomposer.org

این پیش‌نیازها برای عملکرد صحیح پروژه ضروری هستند. حتماً قبل از ادامه نصب، نسخه‌های صحیح را روی سیستم خود داشته باشید.

بررسی نسخه‌های نصب‌شده

می‌توانید نسخه‌های نصب‌شده را با دستورات زیر بررسی کنید:

Node.js و npm

بررسی نسخه Node.js و npm

node -v
npm -v

خروجی مورد انتظار:

v18.16.0  # یا بالاتر
8.19.3    # یا بالاتر

PHP و Composer

بررسی نسخه PHP و Composer

php -v
composer -v

خروجی مورد انتظار:

PHP 8.1.10 (cli) # یا بالاتر
Composer version 2.5.8 # یا بالاتر

Docker

بررسی نسخه Docker

docker -v
docker compose version

خروجی مورد انتظار:

Docker version 20.10.21 # یا بالاتر
Docker Compose version v2.13.0 # یا بالاتر

عدم تطابق نسخه

اگر هر یک از این اجزا نصب نشده یا قدیمی هستند، لطفاً قبل از ادامه راه‌اندازی پروژه آن‌ها را نصب یا به‌روزرسانی کنید. استفاده از نسخه‌های ناسازگار ممکن است منجر به مشکلات غیرمنتظره در توسعه شود.

گام بعدی

پس از اطمینان از رعایت تمام پیش‌نیازها، می‌توانید ادامه دهید:

1. راه‌اندازی Docker - نصب و پیکربندی Docker
2. راه‌اندازی پروژه - راه‌اندازی پروژه پلنت