APACHECTL(8) apachectl APACHECTL(8)

apachectl - رابط کنترل وب‌سرور HTTP آپاچی

هنگامی که در حالت عبور مستقیم (pass-through) عمل می‌کند، apachectl می‌تواند تمام آرگومان‌های موجود برای باینری httpd را بپذیرد.

apachectl [ httpd-argument ]

هنگامی که در حالت SysV init عمل می‌کند، apachectl دستورات ساده و تک‌کلمه‌ای که در ادامه تعریف شده‌اند را می‌پذیرد.

apachectl command

دستور apachectl یک رابط پیشانی (front end) برای سرور پروتکل انتقال ابرمتن آپاچی (HTTP) است. این ابزار به منظور کمک به مدیر سیستم جهت کنترل عملکرد دیمن httpd آپاچی طراحی شده است.

اسکریپت apachectl می‌تواند در دو حالت کار کند. نخست، می‌تواند به عنوان یک پیشانی ساده برای دستور httpd عمل کند که صرفاً متغیرهای محیطی لازم را تنظیم کرده و سپس httpd را با ارسال آرگومان‌های خط فرمان فراخوانی می‌کند. دوم، apachectl می‌تواند به عنوان یک اسکریپت SysV init عمل کند و آرگومان‌های ساده و تک‌کلمه‌ای مانند start، restart و stop را دریافت کرده و آن‌ها را به سیگنال‌های مناسب برای httpd تبدیل نماید.

اگر نصب آپاچی شما از مسیرهای غیراستاندارد استفاده می‌کند، باید اسکریپت apachectl را برای تنظیم مسیرهای مناسب به باینری httpd ویرایش کنید. همچنین می‌توانید هرگونه آرگومان خط فرمان لازم برای httpd را مشخص کنید. برای جزئیات بیشتر به توضیحات درون اسکریپت مراجعه کنید.

اسکریپت apachectl در صورت موفقیت مقدار خروج 0 و در صورت وقوع خطا مقداری بزرگتر از 0 (>0) برمی‌گرداند. برای جزئیات بیشتر، توضیحات درون اسکریپت را مشاهده کنید.

در اینجا تنها گزینه‌های به سبک SysV init تعریف شده‌اند. سایر آرگومان‌ها در صفحه راهنمای httpd تعریف شده‌اند.

دیمن httpd آپاچی را راه‌اندازی می‌کند. در صورتی که دیمن در حال اجرا باشد، خطا می‌دهد. این معادل با apachectl -k start است.
دیمن httpd آپاچی را متوقف می‌کند. این معادل با apachectl -k stop است.
دیمن httpd آپاچی را مجدداً راه‌اندازی می‌کند. اگر دیمن در حال اجرا نباشد، راه‌اندازی می‌شود. این دستور پیش از آغاز راه‌اندازی مجدد، به صورت خودکار فایل‌های پیکربندی را همانند configtest بررسی می‌کند تا مطمئن شود دیمن متوقف نمی‌شود. این معادل با apachectl -k restart است.
یک گزارش وضعیت کامل از mod_status نمایش می‌دهد. برای کارکرد این گزینه، باید mod_status روی سرور شما فعال باشد و یک مرورگر متنی مانند lynx روی سیستم شما در دسترس باشد. نشانی اینترنتی (URL) مورد استفاده برای دسترسی به گزارش وضعیت را می‌توان با ویرایش متغیر STATUSURL در اسکریپت تنظیم کرد.
یک گزارش وضعیت مختصر نمایش می‌دهد. مشابه گزینه fullstatus است، با این تفاوت که فهرست درخواست‌هایی که در حال حاضر به آن‌ها رسیدگی می‌شود حذف شده است.
دیمن httpd آپاچی را به صورت نرم (graceful) مجدداً راه‌اندازی می‌کند. اگر دیمن در حال اجرا نباشد، راه‌اندازی می‌شود. تفاوت این حالت با راه‌اندازی مجدد عادی در این است که اتصال‌های در حال حاضر باز قطع نمی‌شوند. اثر جانبی این امر آن است که فایل‌های گزارش (لاگ) قدیمی بلافاصله بسته نخواهند شد. این بدان معناست که اگر در یک اسکریپت چرخش گزارش (log rotation) استفاده شود، ممکن است تاخیر قابل‌توجهی برای اطمینان از بسته شدن فایل‌های گزارش قدیمی قبل از پردازش آن‌ها لازم باشد. این دستور پیش از آغاز راه‌اندازی مجدد، به صورت خودکار فایل‌های پیکربندی را همانند configtest بررسی می‌کند تا مطمئن شود آپاچی متوقف نمی‌شود. این معادل با apachectl -k graceful است.
دیمن httpd آپاچی را به صورت نرم (graceful) متوقف می‌کند. تفاوت این حالت با توقف عادی در این است که اتصال‌های در حال حاضر باز قطع نمی‌شوند. اثر جانبی این امر آن است که فایل‌های گزارش قدیمی بلافاصله بسته نخواهند شد. این معادل با apachectl -k graceful-stop است.
آزمون نحو (سینتکس) فایل پیکربندی را اجرا می‌کند. این دستور فایل‌های پیکربندی را تجزیه کرده و یا عبارت Syntax Ok را گزارش می‌دهد یا اطلاعات دقیقی درباره خطای نحوی خاص ارائه می‌کند. این معادل با apachectl -t است.

گزینه زیر در نسخه‌های قبلی در دسترس بود اما حذف شده است.

برای راه‌اندازی httpd با پشتیبانی از SSL، باید فایل پیکربندی خود را ویرایش کنید تا دستورالعمل‌های مربوطه را شامل شود و سپس از دستور عادی apachectl start استفاده کنید.

مسیرهای پیش‌فرض ذکرشده در زیر ممکن است در زمان کامپایل تغییر کرده باشند. برای مکان‌های واقعی به نصب محلی خود مراجعه کنید.

/usr/local/apache2/bin/envvars
تنظیمات متغیرهای محیطی که در زمان راه‌اندازی بارگذاری (source) می‌شوند.
/usr/local/apache2/bin/httpd
باینری httpd که توسط apachectl فراخوانی می‌شود.
2026-05-08 Apache HTTP Server