.TH PHP-FPM 8 "2024" "The PHP Group" "Scripting Language"
.SH "نام (NAME)"
.TP 15
php-fpm \- مدیر فرآیند FastCGI برای PHP با عنوان «PHP-FPM»
.SH "خلاصه دستور (SYNOPSIS)"
.B php-fpm
[\fIگزینه‌ها\fR]
.LP
.SH "توضیحات (DESCRIPTION)"
\fBPHP\fP یک زبان اسکریپت‌نویسی همه‌منظوره و پرکاربرد است که به طور ویژه برای
توسعه وب مناسب بوده و می‌تواند درون HTML قرار گیرد. این نسخه از PHP به صورت یک دیمون در پس‌زمینه اجرا می‌شود و به درخواست‌های CGI گوش فرا می‌دهد. خروجی در مسیر /var/log/php-fpm.log ثبت می‌شود.
.LP
بیشتر گزینه‌ها در فایل پیکربندی تنظیم می‌شوند. فایل پیکربندی در مسیر /etc/php/php-fpm.conf قرار دارد. به طور پیش‌فرض، php-fpm با گوش دادن روی درگاه 9000 پروتکل HTTP در localhost به درخواست‌های CGI پاسخ می‌دهد. بنابراین php-fpm انتظار دارد وب‌سرور شما تمام درخواست‌های مربوط به فایل‌های «.php» را به درگاه 9000 هدایت کند و شما باید فایل پیکربندی وب‌سرور خود را به شکل مناسب ویرایش کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP 15
.B \-C
تغییر ندادن دایرکتوری به دایرکتوری اسکریپت (عدم اجرای chdir)
.TP
.PD 0
.B \-\-php\-ini \fIpath\fP|\fIfile\fP
.TP
.PD 1
.B \-c \fIpath\fP|\fIfile\fP
جستجوی فایل
.B php.ini
در دایرکتوری
.IR path
یا استفاده از
.IR file
مشخص‌شده
.TP
.PD 0
.B \-\-no\-php\-ini
.TP
.PD 1
.B \-n
هیچ فایل
.B php.ini
استفاده نخواهد شد
.TP
.PD 0
.B \-\-define \fIfoo\fP[=\fIbar\fP]
.TP
.PD 1
.B \-d \fIfoo\fP[=\fIbar\fP]
تعریف مدخل INI
.IR foo
با مقدار
.IR bar
.TP
.B \-e
تولید اطلاعات تکمیلی و گسترده برای اشکال‌زدا/پروفایلر
.TP
.PD 0
.B \-\-help
.TP
.PD 1
.B \-h
نمایش این راهنما
.TP
.PD 0
.B \-\-info
.TP
.PD 1
.B \-i
اطلاعات و پیکربندی PHP
.TP
.PD 0
.B \-\-modules
.TP
.PD 1
.B \-m
نمایش ماژول‌های کامپایل‌شده داخلی
.TP
.PD 0
.B \-\-version
.TP
.PD 1
.B \-v
شماره نسخه
.TP
.PD 0
.B \-\-prefix \fIpath\fP
.TP
.PD 1
.B \-p
مشخص کردن مسیر پیشوند جایگزین (پیش‌فرض /usr است)
.TP
.PD 0
.B \-\-pid \fIfile\fP
.TP
.PD 1
.B \-g
مشخص کردن محل فایل شناسه فرآیند (PID).
.TP
.PD 0
.B \-\-fpm\-config \fIfile\fP
.TP
.PD 1
.B \-y
مشخص کردن مسیر جایگزین برای فایل پیکربندی مدیر فرآیند FastCGI (پیش‌فرض /etc/php/php-fpm.conf است)
.TP
.PD 0
.B \-\-test
.TP
.PD 1
.B \-t
آزمایش صحت فایل پیکربندی FPM و خروج
اگر دو بار فراخوانی شود (\-tt)، پیکربندی پیش از خروج نمایش داده می‌شود (دامپ می‌شود).
.TP
.PD 0
.B \-\-daemonize
.TP
.PD 1
.B \-D
اجبار به اجرا در پس‌زمینه و نادیده گرفتن گزینه daemonize از فایل پیکربندی.
.TP
.PD 0
.B \-\-nodaemonize
.TP
.PD 1
.B \-F
اجبار به ماندن در پیش‌زمینه و نادیده گرفتن گزینه daemonize از فایل پیکربندی.
.TP
.PD 0
.B \-\-force\-stderr
.TP
.PD 1
.B \-O
اجبار ارسال خروجی به stderr در حالت nodaemonize حتی اگر stderr یک پایانه TTY نباشد.
.TP
.PD 0
.B \-\-allow\-to\-run\-as\-root
.TP
.PD 1
.B \-R
اجازه به استخر (pool) برای اجرا به عنوان کاربر ارشد (ریشه) (به طور پیش‌فرض غیرفعال است)
.SH "فایل‌ها (FILES)"
.TP 15
.B php-fpm.conf
فایل پیکربندی دیمون php-fpm.
.TP
.B php.ini
فایل پیکربندی استاندارد php.
.SH "مثال‌ها (EXAMPLES)"
برای هر یک از سیستم‌های یونیکس که از init.d به عنوان مدیر فرآیند اصلی خود استفاده می‌کنند، باید از اسکریپت init ارائه‌شده برای شروع و توقف دیمون php-fpm استفاده کنید.
.P
.PD 1
.RS
sudo /etc/init.d/php-fpm start
.RE
.TP
برای هر یک از سیستم‌های یونیکس که از systemd به عنوان مدیر فرآیند اصلی خود استفاده می‌کنند، باید از فایل واحد (unit) ارائه‌شده برای شروع و توقف دیمون php-fpm استفاده کنید.
.P
.PD 1
.RS
sudo systemctl start php-fpm.service
.RE
.TP
اگر در سیستم شما اسکریپت init مناسب وجود ندارد، php-fpm را بدون هیچ آرگومانی اجرا کنید. این برنامه به طور پیش‌فرض به صورت یک دیمون (فرآیند پس‌زمینه) اجرا خواهد شد. فایل /var/run/php-fpm.pid مشخص می‌کند که آیا php-fpm در حال حاضر اجرا شده و در حال کار است یا خیر. پس از شروع، php-fpm به چندین سیگنال POSIX پاسخ می‌دهد:
.P
.PD 0
.RS
.B SIGINT,SIGTERM 	\fPخاتمه فوری
.TP
.B SIGQUIT 			\fPتوقف ملایم (Graceful)
.TP
.B SIGUSR1 			\fPبازگشایی مجدد فایل لاگ
.TP
.B SIGUSR2 			\fPبارگذاری مجدد و ملایم تمام workerها + بارگذاری مجدد پیکربندی/باینری fpm
.RE
.PD 1
.P
.SH "نکات (TIPS)"
دیمون CGI مربوط به PHP-FPM به خوبی با بیشتر وب‌سرورهای محبوب از جمله Apache2، lighttpd و nginx کار می‌کند.
.PD 1
.P
.SH "همچنین ببینید (SEE ALSO)"
برای توضیحات کمابیش کامل در مورد PHP-FPM به اینجا مراجعه کنید:
.PD 0
.P
.B https://www.php.net/fpm
.PD 1
.SH "اشکالات (BUGS)"
می‌توانید فهرست باگ‌های شناخته‌شده را مشاهده کنید یا هر باگ جدیدی که
یافته‌اید را در نشانی زیر گزارش دهید:
.PD 0
.P
.B https://github.com/php/php-src/issues
.PD 1
.SH "نویسندگان (AUTHORS)"
بخش PHP-FPM SAPI توسط Andrei Nigmatulin نوشته شده است. لیست‌های پستی highload-php-en (انگلیسی) و highload-php-ru (روسی) هستند.
.P
گروه The PHP Group متشکل از: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski.
.P
فهرستی از توسعه‌دهندگان فعال را می‌توانید در اینجا بیابید:
.PD 0
.P
.B https://www.php.net/credits.php
.PD 1
.P
و در نهایت، PHP با کمک تعداد بی‌شماری از مشارکت‌کنندگان در سراسر جهان توسعه یافته است.
.SH "اطلاعات نسخه (VERSION INFORMATION)"
این صفحه راهنما مربوط به \fBphp-fpm\fP نسخه 8.5.10 است.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co The PHP Group
.PD 0
.P
حق نشر (c) 2007-2009، متعلق به Andrei Nigmatulin
.PD 1
.LP
این پرونده مبدا مشمول نسخه 3.01 از مجوز PHP است
که همراه با این بسته در پرونده LICENSE ارائه شده و از طریق
شبکه جهانی وب در نشانی زیر در دسترس است:
.PD 0
.P
.B https://www.php.net/license/3_01.txt
.PD 1
.P
اگر نسخه‌ای از مجوز PHP دریافت نکرده‌اید و قادر به دریافت آن
از طریق وب نیستید، لطفاً پیامی به نشانی زیر ارسال نمایید:
.B license@php.net
تا بلافاصله یک نسخه از آن را برای شما از طریق ایمیل ارسال کنیم.