همه مقالات تخصصی

Composer روی سرور: وابستگی‌های PHP را تکرارپذیر و امن مستقر کنید

وابستگی‌های PHP را با Composer مستقر کنید: composer.lock را commit کنید، روی سرور composer install --no-dev بزنید، autoloader را بهینه کنید، بسته‌ها را audit کنید و از اشتباه‌های رایج بپرهیزید.

Composer روی سرور: وابستگی‌های PHP را تکرارپذیر و امن مستقر کنید

Composer کتابخانه‌های PHP مورد نیاز پروژه را مدیریت می‌کند. مشکل‌ها معمولاً روی سرور پیدا می‌شوند: نسخهٔ PHP متفاوت، نبود فایل lock، بسته‌های توسعه در تولید یا فایل‌های متعلق به root. الگوی امن ساده است: نسخه‌ها را روی ماشین توسعه تعیین کنید، فایل lock را commit کنید و بگذارید سرور دقیقاً همان را نصب کند. دستورها از مستندات Composer آمده‌اند؛ روی سرور شما اجرایشان نکرده‌ام و بعضی هاست‌های اشتراکی دسترسی شل را محدود می‌کنند.

۱. اول PHP و Composer را بررسی کنید

Composer با نسخهٔ PHP خط فرمان کار می‌کند که می‌تواند با PHP وب فرق داشته باشد:

php -v
composer --version
composer validate
composer diagnose

برای اینکه PHP وب چطور انتخاب می‌شود راهنمای نسخهٔ PHP و راهنمای PHP-FPM را ببینید.

۲. نسخه‌ها را روی ماشین توسعه تعیین کنید

بسته‌ها را جایی اضافه و به‌روز کنید که می‌توانید تست کنید و هر دو فایل را commit کنید تا سرور بتواند نتیجه را بازسازی کند:

# Development machine: add or update, then commit composer.json AND composer.lock
composer require monolog/monolog:^3.0
composer update monolog/monolog --with-dependencies
git add composer.json composer.lock

قید نسخه در composer.json می‌گوید چه چیزی مجاز است؛ فایل lock ثبت می‌کند چه چیزی تست شده.

۳. روی سرور از فایل lock نصب کنید

روی سرور از install استفاده کنید نه update. بسته‌های توسعه را رد کنید و autoloader را بهینه کنید:

# Server: install exactly what the lock file says
cd /var/www/example
composer install --no-dev --prefer-dist --optimize-autoloader --no-interaction
composer show --installed | head

با کاربر برنامه اجرا کنید نه root. قبل از استقرار بکاپ بگیرید؛ راهنمای بکاپ را ببینید.

۴. audit و راستی‌آزمایی

آسیب‌پذیری‌های شناخته‌شده را بررسی کنید و مطمئن شوید برنامه بارگذاری می‌شود:

composer audit
composer outdated --direct
php -r 'require "vendor/autoload.php"; echo "autoload ok\n";'

اگر بعد از استقرار چیزی خراب شد لاگ خطا را بخوانید؛ برای لاگ سرویس‌ها راهنمای journalctl را ببینید.

۵. اشتباه‌هایی که باید پرهیز کرد

این عادت‌ها استقرار را غیرقابل‌پیش‌بینی می‌کنند:

composer update on the production server    # installs versions nobody tested
Running composer as root                    # creates root-owned files
vendor/ folder served from the web root     # exposes library code and files
No composer.lock in git                     # every deploy can differ

اگر فریم‌ورک اجازه می‌دهد پوشهٔ vendor را بیرون ریشهٔ عمومی وب نگه دارید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید برنامهٔ PHP کوچکی (ساختگی) محلی کار می‌کند ولی بعد از استقرار روی سرور خراب می‌شود. سرور composer update زده و نسخهٔ جدیدتر کتابخانه‌ای را گرفته که PHP جدیدتر می‌خواهد. بعد از commit کردن composer.lock و تغییر استقرار به composer install، سرور دقیقاً نسخه‌های تست‌شده را نصب می‌کند.

۷. اشتباه‌های رایج

  • اجرای composer update در تولید.
  • commit نکردن composer.lock.
  • استفاده از نسخهٔ اشتباه PHP CLI.
  • اجرای Composer با root.
  • نصب بسته‌های توسعه روی سرور.
  • در معرض‌گذاشتن vendor در ریشهٔ وب.

۸. پرسش‌های متداول

install یا update؟ update را روی ماشین توسعه و install را روی سرور بزنید.

vendor را commit کنم؟ معمولاً نه؛ composer.json و composer.lock را commit کنید.

–no-dev چه می‌کند؟ بسته‌های require-dev را رد می‌کند.

روی هاست اشتراکی می‌شود؟ فقط اگر هاست دسترسی شل یا ابزار استقرار بدهد.

۹. چک‌لیست سریع

  1. نسخهٔ PHP CLI را بررسی کنید.
  2. روی ماشین توسعه به‌روز کنید.
  3. فایل lock را commit کنید.
  4. روی سرور composer install بزنید.
  5. از –no-dev استفاده کنید.
  6. composer audit بزنید.
  7. برنامه را تست کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

Composer: Basic usage · Composer: install command · Composer: composer.lock · Composer: Autoloader optimization