تعديل إعدادات PHP

يأتي ServBay مع بيئة PHP مدمجة ويقدم خيارات تكوين مرنة. سيشرح هذا المقال كيفية تعديل إعدادات PHP في ServBay بالتفصيل، بما في ذلك مواقع ملفات php.ini وphp-fpm.conf وعناصر التكوين الشائعة. اعتمادًا على إصدار PHP، تقع هذه الملفات في دليل /Applications/ServBay/etc/php/<version>. بالإضافة إلى ذلك، يتم وضع ملفات تكوين تحميل وحدات PHP (مثل xdebug.ini) في دليل /Applications/ServBay/etc/php/<version>/conf.d.

مقدمة

في ServBay، يتم تخزين ملفات تكوين PHP في أدلة مختلفة حسب الإصدار. على سبيل المثال، يتم تخزين ملفات تكوين PHP 8.3 في دليل /Applications/ServBay/etc/php/8.3. فيما يلي مواقع ملفات التكوين المذكورة بالتفصيل:

• php.ini: /Applications/ServBay/etc/php/8.3/php.ini
• php-fpm.conf: /Applications/ServBay/etc/php/8.3/php-fpm.conf
• ملفات تكوين تحميل وحدات PHP: /Applications/ServBay/etc/php/8.3/conf.d/

تكوين php.ini

ملف php.ini هو ملف التكوين الرئيسي لـ PHP ويستخدم لضبط خيارات وقت التشغيل المختلفة لـ PHP.

عناصر التكوين الشائعة

فيما يلي بعض عناصر تكوين php.ini الشائعة وكيفية تعديلها:

1. تعديل حد الذاكرة:

   memory_limit = 256M

2. تعديل حد حجم ملف التحميل:

   upload_max_filesize = 50M
   post_max_size = 50M

3. تعديل إعدادات المنطقة الزمنية:

   date.timezone = "Asia/Hong_Kong"

4. تمكين عرض الأخطاء:

   display_errors = On
   error_reporting = E_ALL

5. تعديل أقصى وقت للتنفيذ:

   max_execution_time = 300

تكوين php-fpm.conf

يستخدم ملف php-fpm.conf لتكوين معلمات تشغيل PHP-FPM (مدير عملية FastCGI).

عناصر التكوين الشائعة

فيما يلي بعض عناصر تكوين php-fpm.conf الشائعة وكيفية تعديلها:

1. تعديل إعدادات تجمع العمليات:

   [www]
   listen = /Applications/ServBay/tmp/php-cgi-8.3.sock
   listen.backlog = -1
   listen.allowed_clients = 127.0.0.1
   ;listen.owner = www
   ;listen.group = www
   listen.mode = 0666
   ;user = www
   ;group = www
   pm = dynamic
   pm.max_children = 10
   pm.start_servers = 2
   pm.min_spare_servers = 1
   pm.max_spare_servers = 6
   pm.max_requests = 1024
   pm.process_idle_timeout = 10s

2. تمكين سجل بطيء:

   request_slowlog_timeout = 5s
   slowlog = /Applications/ServBay/logs/php/8.3/slow.log

3. تعديل مسار سجل الأخطاء:

   error_log = /Applications/ServBay/logs/php/8.3/errors.log

تكوين تحميل وحدات PHP

يتم تخزين ملفات تكوين تحميل وحدات PHP في دليل /Applications/ServBay/etc/php/8.3/conf.d/. على سبيل المثال، يستخدم ملف xdebug.ini لتكوين امتداد Xdebug.

مثال على xdebug.ini

فيما يلي مثال على ملف xdebug.ini:

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

إعادة تشغيل PHP

بعد تعديل ملفات تكوين PHP، يلزم إعادة تشغيل خدمة PHP لتصبح التغييرات سارية المفعول. يمكن القيام بذلك من خلال واجهة إدارة ServBay أو باستخدام أداة سطر الأوامر servbayctl.

إعادة التشغيل عبر واجهة إدارة ServBay

1. افتح واجهة إدارة ServBay.
2. انتقل إلى الخدمات.
3. ابحث عن خدمة PHP للإصدار المناسب ثم اضغط على زر إعادة التشغيل.

إعادة التشغيل عبر servbayctl

يمكن استخدام أداة سطر الأوامر servbayctl لإعادة تشغيل خدمة PHP بسهولة:

servbayctl restart php 8.3

الخلاصة

في ServBay، يتم تخزين ملفات تكوين PHP في دليل /Applications/ServBay/etc/php/<version>، بما في ذلك php.ini وphp-fpm.conf. يتم تخزين ملفات تكوين تحميل وحدات PHP في دليل /Applications/ServBay/etc/php/<version>/conf.d/. بعد تعديل هذه الملفات، يمكن إعادة تشغيل خدمة PHP من خلال واجهة إدارة ServBay أو باستخدام أداة سطر الأوامر servbayctl لتصبح التغييرات سارية المفعول.