---
title: "نصب PHP و PHP-FPM در اوبونتو"
description: "یاد بگیرید که چگونه PHP و PHP-FPM را در اوبونتو 24.04 نصب کنید تا یک محیط برنامه وب پویا راه‌اندازی شود."
url: "https://negarnovin.com/docs/how-to-install-php-and-php-fpm-on-ubuntu/"
updated: "2026-10-01"
category: مدیریت سرویس / راهنمای لینوکس
tags:
  - "آموزش نصب PHP-FPM"
  - "نحوه نصب PHP و PHP-FPM در اوبونتو 24.04"
---

# نصب PHP و PHP-FPM در اوبونتو

![نصب PHP و PHP-FPM در اوبونتو](https://negarnovin.com/wp-content/uploads/2025/09/2bee83dd47977c4f_compressed.webp)

# نحوه نصب PHP و PHP-FPM در اوبونتو ۲۴.۰۴

 یاد بگیرید که چگونه PHP و PHP-FPM را در اوبونتو ۲۴.۰۴ نصب کنید تا یک محیط برنامه وب پویا راه اندازی شود.

 

## مقدمه

PHP (پیش پردازنده فرامتن) یک زبان برنامه نویسی سمت سرور محبوب است که امکان توسعه برنامه های وب پویا را فراهم می کند. PHP-FPM (مدیر فرآیند FastCGI) ویژگی های اضافی و عملکرد بهبود یافته ای را نسبت به روش های سنتی مبتنی بر CGI ارائه می دهد تا امکان اتصال PHP با سایر برنامه ها مانند سرورهای وب را برای پردازش درخواست های برنامه های وب پویا فراهم کند.

این مقاله نحوه نصب PHP و PHP-FPM را در اوبونتو ۲۴.۰۴ و راه اندازی یک محیط PHP کارآمد برای ایجاد برنامه های وب پویا روی سرور توضیح می دهد.

## پیش نیازها

قبل از شروع:

- یک [سرور مجازی](https://negarnovin.com/unlimited-traffic-virtual-server/) ubuntu
- دسترسی SSH به سرور
- دسترسی یوزر اصلی root
- بروز رسانی سرور

## نصب پی اچ پی

PHP در مخازن پیش فرض APT در اوبونتو ۲۴.۰۴ به همراه آخرین اطلاعات بسته موجود است. برای به روزرسانی بسته های سرور و نصب آخرین نسخه PHP روی سرور خود، مراحل زیر را دنبال کنید.

1. فهرست بسته های سرور را به روزرسانی کنید.  کنسول
   ```
   $ sudo apt update
   ```
2. پی اچ پی را نصب کنید.  کنسول
   ```
   $ sudo apt install php -y
   ```
3. نسخه PHP نصب شده روی سرور خود را مشاهده کنید.  کنسول
   ```
   $ php -v
   ```

   خروجی شما باید مشابه تصویر زیر باشد:

   ```
   PHP 8.3.6 (cli) (built: Apr 15 2024 19:21:47) (NTS)
   Copyright (c) The PHP Group
   Zend Engine v4.3.6, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.6, Copyright (c), by Zend Technologies
   ```

## نصب افزونه های PHP

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

1. افزونه های رایج PHP را نصب کنید.  کنسول
   ```
   $ sudo apt install -y php-mysql php-mbstring php-bcmath php-zip php-gd php-curl php-xml
   ```

   دستور بالا افزونه های PHP زیر را نصب می کند:

   - **php-mysql** : برنامه های PHP را قادر می سازد تا به پایگاه های داده MySQL متصل شده و با آنها تعامل داشته باشند.
   - **php-mbstring** : فرمت های متنی UTF8 را فعال می کند.
   - **php-bcmath** : قابلیت های ریاضی با دقت دلخواه را فعال می کند.
   - **php-zip** : پشتیبانی از آرشیوهای ZIP را در برنامه های PHP فعال می کند.
   - **php-gd** : قابلیت های پردازش تصویر PHP را فعال می کند.
   - **php-curl** : انتقال URL و همگام سازی با برنامه های PHP را امکان پذیر می کند.
   - **php-xml** : پشتیبانی از XML را در برنامه های PHP فعال می کند.
   - دستور زیر را اجرا کنید تا تمام افزونه های PHP که می توانید بر اساس نسخه PHP سرور خود نصب کنید، فهرست شوند.
     کنسول
   ```
   $ sudo apt-cache search php | grep "^php8.3"
   ```
2. مشاهده تمام افزونه های PHP نصب شده روی سرور شما.  کنسول
   ```
   $ php -m
   ```

   خروجی شما باید مانند تصویر زیر باشد:

   ```
   [PHP Modules]
   bcmath
   calendar
   Core
   ctype
   curl
   date
   dom
   exif
   FFI
   .....
   
   [Zend Modules]
   Zend OPcache
   ```

## نصب و پیکربندی PHP-FPM

PHP-FPM در مخازن پیش فرض APT موجود است و با آخرین نسخه بسته PHP نصب شده روی سرور شما مطابقت دارد. برای نصب PHP-FPM و فعال کردن سرویس برای شروع خودکار در زمان بوت، مراحل زیر را دنبال کنید.

1. PHP-FPM را نصب کنید.  کنسول
   ```
   $ sudo apt install php-fpm -y
   ```
2. بسته به نسخه PHP خود، نسخه PHP-FPM نصب شده روی سرور خود را مشاهده کنید. به عنوان مثال، `PHP 8.3`.  کنسول
   ```
   $ php-fpm8.3 -v
   ```

   خروجی:

   ```
   PHP 8.3.6 (fpm-fcgi) (built: Apr 15 2024 19:21:47)
   Copyright (c) The PHP Group
   Zend Engine v4.3.6, Copyright (c) Zend Technologies
    with Zend OPcache v8.3.6, Copyright (c), by Zend Technologies
   ```
3. `/etc/php/8.3`بسته به نسخه PHP نصب شده، تمام فایل های موجود در دایرکتوری را فهرست کنید . سپس، تأیید کنید که `fpm`دایرکتوری در دسترس است.  کنسول
   ```
   $ ls /etc/php/8.3/
   ```

   خروجی:

   ```
   apache2 cli fpm mods-available
   ```

   بر اساس خروجی فوق، PHP-FPM `fpm`و پیکربندی های لازم که نحوه پردازش درخواست ها توسط PHP را روی سرور شما کنترل می کنند، در دسترس هستند.
4. به دایرکتوری پیکربندی های استخر PHP-FPM بروید `/etc/php/8.3/fpm/pool.d/`.  کنسول
   ```
   $ cd /etc/php/8.3/fpm/pool.d/
   ```
5. پیکربندی پیش فرض PHP-FPM pool را `/etc/php/8.3/fpm/pool.d/www.conf`با استفاده از یک ویرایشگر متن مانند Nano باز کنید.  کنسول
   ```
   $ sudo nano www.conf
   ```

   - `[www]`گزینه ای برای تأیید نام استخر PHP-FPM خود پیدا کنید .
     اینی
   ```
   [www]
   ```

   - `user`گزینه های و `group`را برای تأیید اینکه PHP-FPM به عنوان کاربر اجرا می شود، پیدا کنید . هنگام استفاده از یک وب سرور، تأیید کنید که PHP-FPM به عنوان `www-data`کاربر اجرا می شود.
     اینی
   ```
   user = www-data
   group = www-data
   ```

   - دستورالعمل را پیدا کنید `listen`و مسیر سوکت را برای دسترسی به سرویس PHP-FPM روی سرور خود تأیید کنید.
     اینی
   ```
   listen = /run/php/php8.3-fpm.sock
   ```

   - پیکربندی زیر را برای مطابقت با نیازهای پردازش PHP-FPM خود در سرور تغییر دهید.
     اینی
   ```
   pm = dynamic
   pm.max_children = 5
   pm.start_servers = 2
   pm.min_spare_servers = 1
   pm.max_spare_servers = 3
   ```

   - `pm`: مدیر فرآیند PHP-FPM را با هر یک از گزینه های زیر فعال می کند:
     - `static`: با استفاده از تعداد ثابتی از فرآیندهای کارگر را تنظیم می کند `pm.max_children`.
     - `dynamic`: تعداد متغیری از فرآیندهای کارگر را بر اساس تقاضا فعال می کند.
     - `ondemand`فعال کردن فعال سازی فرآیندهای کارگر فقط در صورت نیاز و غیرفعال کردن شروع خودکار.
   - `pm.max_children`حداکثر تعداد فرآیندهای فرزندی که باید هنگام شروع کنترل استفاده از حافظه سرور توسط PHP-FPM ایجاد شوند را تنظیم می کند.
   - `pm.start_servers`تعداد فرآیندهای فرزندی که هنگام شروع PHP-FPM ایجاد می شوند را تنظیم می کند.
   - `pm.min_spare_servers`: حداقل تعداد فرآیندهای غیرفعال مجاز روی سرور را تنظیم می کند.
   - `pm.max_spare_servers`: حداکثر تعداد فرآیندهای غیرفعال (idle processes) برای اجرا روی سرور را تنظیم می کند.
   - `pm.process_idle_timeout`: حداکثر تعداد ثانیه ها پس از انتظار و توقف فرآیندهای غیرفعال را تنظیم می کند.
   - `access.log`ثبت تمام درخواست های اتصال به استخر PHP-FPM را فعال می کند.
   - `slowlog`: مسیر ثبت درخواست های کند را تنظیم می کند.
   - `request_slowlog_timeout`: حداکثر زمان انتظار برای یک درخواست را قبل از اینکه به عنوان کند علامت گذاری شود، تنظیم می کند.

   فایل را ذخیره کنید و ببندید.
6. برای اعمال تغییرات پیکربندی، PHP-FPM را مجدداً راه اندازی کنید.  کنسول
   ```
   $ sudo systemctl restart php8.3-fpm
   ```

## تست PHP و PHP-FPM

PHP محتوای برنامه های وب پویا را پردازش می کند در حالی که PHP-FPM اتصال به PHP را با منابع لازم مدیریت می کند تا پردازش سریع درخواست ها روی سرور شما امکان پذیر شود. مراحل زیر را برای آزمایش PHP و PHP-FPM با ایجاد یک برنامه PHP نمونه برای ارائه با استفاده از وب سرور Nginx دنبال کنید.

1. به دایرکتوری خانگی کاربر خود بروید.  کنسول
   ```
   $ cd
   ```
2. یک فایل نمونه برنامه PHP جدید ایجاد کنید `sample.php`.  کنسول
   ```
   $ nano sample.php
   ```
3. محتویات زیر را به فایل اضافه کنید.  پی اچ پی
   ```
   <?php
   
   echo "Greetings from Negarnovin! PHP is working correctly on this server";
   
   ?>
   ```

   فایل را ذخیره کنید و ببندید.
4. برنامه را با استفاده از ابزار PHP CLI اجرا کنید.  کنسول
   ```
   $ php sample.php
   ```

   خروجی:

   ```
   Greetings from Negarnovin! PHP is working correctly on this server
   ```

   بر اساس خروجی فوق، PHP فایل های برنامه وب پویا را روی سرور شما به درستی پردازش می کند.
5. برای آزمایش دسترسی به سرویس PHP-FPM، برنامه وب سرور Nginx را نصب کنید.  کنسول
   ```
   $ sudo apt install nginx -y
   ```
6. از پیکربندی پیش فرض میزبان مجازی Nginx نسخه پشتیبان تهیه کنید.  کنسول
   ```
   $ sudo mv /etc/nginx/sites-available/default /etc/nginx/sites-available/default.BAK
   ```
7. یک فایل پیکربندی جدید `default`Nginx ایجاد کنید.  کنسول
   ```
   $ sudo nano /etc/nginx/sites-available/default
   ```
8. تنظیمات زیر را به فایل اضافه کنید.  انجینکس
   ```
   server {
    listen 80 default_server;
    listen [::]:80 default_server;
   
    root /var/www/html/;
    index index.html index.php index.nginx-debian.html;
   
    location ~ .php$ {
    try_files $uri =404;
    fastcgi_pass unix:/run/php/php-fpm.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
    }
   }
   ```

   فایل را ذخیره کنید و ببندید.

   پیکربندی Nginx در بالا با استفاده از تمام آدرس های IP سرور روی پورت پیش فرض HTTP به درخواست های اتصال گوش می دهد `80`و فایل ها را از `/var/www/html`دایرکتوری ریشه وب تحویل می دهد. Nginx تمام درخواست هایی را که با `.php`پسوند فایل مطابقت دارند، به مسیر سوکت PHP-FPM `/run/php/php-fpm.sock`برای پردازش با استفاده از FastCGI ارسال می کند تا به سرویس نسخه پیش فرض PHP-FPM متصل شود.
9. پیکربندی Nginx را برای خطاها آزمایش کنید.  کنسول
   ```
   $ sudo nginx -t
   ```

   خروجی:

   ```
   nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
   nginx: configuration file /etc/nginx/nginx.conf test is successful
   ```
10. یک فایل نمونه برنامه PHP جدید `test.php`در دایرکتوری ریشه وب `/var/www/html`مشخص شده در پیکربندی Nginx خود ایجاد کنید.  کنسول
    ```
    $ sudo nano /var/www/html/test.php
    ```
11. محتویات زیر را به فایل اضافه کنید.  پی اچ پی
    ```
    <?php 
    
    phpinfo();
    
    ?>
    ```

    فایل را ذخیره کنید و ببندید.

    برنامه PHP فوق، اطلاعات نسخه PHP موجود روی سرور شما را هنگام دسترسی در یک مرورگر وب نمایش می دهد.
12. سرویسی را که از قبل با PHP نصب شده است، متوقف کنید `apache2`تا پورت HTTP را از حالت اتصال خارج کنید `80`.  کنسول
    ```
    $ sudo systemctl stop apache2
    ```
13. `80`از طریق ابزار پیش فرض فایروال UFW، اتصال به پورت HTTP را مجاز کنید .  کنسول
    ```
    $ sudo ufw allow 80
    ```
14. برای اعمال تغییرات پیکربندی، Nginx را مجدداً راه اندازی کنید.  کنسول
    ```
    $ sudo systemctl restart nginx
    ```
15. با استفاده از یک مرورگر وب مانند کروم، به آدرس IP سرور خود دسترسی پیدا کنید و `/test.php`مسیر URL را برای دسترسی به برنامه PHP خود بارگذاری کنید.
    ```
    http://SERVER-IP/test.php
    ```

    ![نصب PHP و PHP-FPM در اوبونتو](https://negarnovin.com/wp-content/uploads/2025/09/2bee83dd47977c4f_compressed.webp)

## نصب چندین نسخه PHP

پروژه های چندگانه بسته به نیاز شما به نسخه های خاص PHP نیاز دارند. PHP از چندین نسخه نصب شده پشتیبانی می کند که می توانید به آنها مراجعه کرده و با نسخه PHP-FPM مرتبط از آنها استفاده کنید. با این حال، مخازن پیش فرض اوبونتو ۲۴.۰۴ شامل نسخه های محدودی از PHP هستند. یک مخزن انجمن قابل اعتماد مانند مخزن `ppa:ondrej/php`نصب نسخه های قدیمی تر یا جدیدتر PHP را روی سرور خود اضافه کنید، زیرا `PHP 7.4`ممکن است در مخازن پیش فرض موجود نباشد. در مراحل زیر، `ppa:ondrej/php`منبع بسته را به مخازن APT خود اضافه کنید و چندین نسخه PHP را روی سرور خود نصب کنید.

1. `ppa:ondrej/php`PPA را به مخازن APT خود اضافه کنید .  کنسول
   ```
   $ sudo add-apt-repository -y ppa:ondrej/php
   ```
2. یک نسخه خاص PHP و PHP-FPM را روی سرور خود نصب کنید. برای مثال، `PHP 7.4`.  کنسول
   ```
   $ sudo apt install -y php7.4 php7.4-fpm
   ```
3. اطلاعات نسخه PHP نصب شده روی سرور خود را مشاهده کنید.  کنسول
   ```
   $ php7.4 -v
   ```

   خروجی:

   ```
   PHP 7.4.33 (cli) (built: Jun 6 2024 16:49:34) ( NTS )
   Copyright (c) The PHP Group
   Zend Engine v3.4.0, Copyright (c) Zend Technologies
    with Zend OPcache v7.4.33, Copyright (c), by Zend Technologies
   ```
4. وضعیت سرویس PHP-FPM نسخه PHP را مشاهده کنید و تأیید کنید که در حال اجرا است. برای مثال، `php7.4-fpm`.  کنسول
   ```
   $ sudo systemctl status php7.4-fpm
   ```

   خروجی:

   ```
   ● php7.4-fpm.service - The PHP 7.4 FastCGI Process Manager
    Loaded: loaded (/usr/lib/systemd/system/php7.4-fpm.service; enabled; preset: enabled)
    Active: active (running) since Sun 2024-06-30 00:20:23 UTC; 11min ago
    Docs: man:php-fpm7.4(8)
    Process: 23012 ExecStartPost=/usr/lib/php/php-fpm-socket-helper install /run/php/php-fpm.sock /etc/php/7.4/fpm/pool.d/www.conf 74 (code=exited, status=0/SUC>
    Main PID: 23008 (php-fpm7.4)
    Status: "Processes active: 0, idle: 2, Requests: 0, slow: 0, Traffic: 0req/sec"
    Tasks: 3 (limit: 2269)
    Memory: 7.0M (peak: 8.0M)
    CPU: 104ms
    CGroup: /system.slice/php7.4-fpm.service
    ├─23008 "php-fpm: master process (/etc/php/7.4/fpm/php-fpm.conf)"
    ├─23009 "php-fpm: pool www"
    └─23011 "php-fpm: pool www"
   ```
5. یک دایرکتوری ریشه وب جدید برای ذخیره فایل های مختلف برنامه PHP ایجاد کنید. به عنوان مثال، `/var/www/php74-site`.  کنسول
   ```
   $ sudo mkdir -p /var/www/php74-site
   ```
6. `test.php`فایل برنامه PHP که قبلاً ایجاد کرده اید را در دایرکتوری با نام `index.php`. کپی کنید .  کنسول
   ```
   $ sudo cp /var/www/html/test.php /var/www/php74-site/index.php
   ```
7. برای آزمایش دسترسی به نسخه PHP-FPM نصب شده، یک پیکربندی میزبان مجازی Nginx جدید ایجاد کنید. به عنوان مثال، `php74-site.conf`.  کنسول
   ```
   $ sudo nano /etc/nginx/sites-available/php74-site.conf
   ```
8. تنظیمات زیر را به فایل اضافه کنید.  انجینکس
   ```
   server {
    listen 9000;
    listen [::]:9000;
   
    root /var/www/php74-site;
   
    index index.php index.html;
   
    location ~ .php$ {
    try_files $uri =404;
    fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
    }
   }
   ```

   فایل را ذخیره کنید و ببندید.

   پیکربندی Nginx فوق، اتصالات ورودی را روی پورت TCP سفارشی گوش می دهد `9000`و فایل ها را از دایرکتوری ریشه وب شما تحویل می دهد `/var/www/php74-site`. این `index`دستورالعمل، فایل های پیش فرض برنامه وب را برای ارائه به همه درخواست ها به طور پیش فرض مشخص می کند. سپس، Nginx تمام درخواست های فایل PHP را با استفاده از مسیر سوکت پیش فرض pool برای پردازش، `.php`به سرویس PHP-FPM نسخه PHP شما ارسال می کند.`php7.4-fpm``/run/php/php7.4-fpm.sock`
9. فایل پیکربندی Nginx را به `/etc/nginx/sites-enabled`فعال کردن میزبان مجازی جدید پیوند دهید.  کنسول
   ```
   $ sudo ln -s /etc/nginx/sites-available/php74-site.conf /etc/nginx/sites-enabled/
   ```
10. پیکربندی Nginx را برای خطاها آزمایش کنید.  کنسول
    ```
    $ sudo nginx -t
    ```

    خروجی:

    ```
    nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
    nginx: configuration file /etc/nginx/nginx.conf test is successful
    ```
11. `9000`اتصالات شبکه را از طریق فایروال به پورت TCP میزبان مجازی مجاز کنید .  کنسول
    ```
    $ sudo ufw allow 9000/tcp
    ```
12. برای اعمال تغییرات، قوانین فایروال را مجدداً بارگذاری کنید.  کنسول
    ```
    $ sudo ufw reload
    ```
13. برای اعمال تغییرات پیکربندی، Nginx را مجدداً راه اندازی کنید.  کنسول
    ```
    $ sudo systemctl restart nginx
    ```
14. برای باز کردن فایل برنامه وب `9000`خود، در یک پنجره مرورگر وب جدید، به IP سرور خود در پورت مربوطه دسترسی پیدا کنید .`index.php`
    ```
    http://SERVER-IP:9000
    ```

    تأیید کنید که اطلاعات نسخه PHP ۷.۴ و ماژول های شما در مرورگر وب شما نمایش داده می شوند.

    ![نصب PHP و PHP-FPM در اوبونتو](https://negarnovin.com/wp-content/uploads/2025/09/d0b4ebf8b8a09308_compressed.webp)

    - `/test.php`با استفاده از IP سرور خود در یک تب جدید مرورگر وب، به مسیر URL دسترسی پیدا کنید تا تأیید کنید که `8.3`نسخه پیش فرض PHP شما درخواست ها را بر اساس پیکربندی Nginx شما به طور جداگانه پردازش می کند.

     

## نتیجه گیری

شما PHP و PHP-FPM را روی سرور اوبونتو ۲۴.۰۴ خود نصب کرده اید. سپس، چندین نسخه PHP را برای اجرای پروژه های مختلف برنامه های وب بسته به ویژگی ها و نیازهای نسخه خاص خود نصب کرده اید. می توانید PHP و PHP-FPM را با چندین برنامه مانند Nginx ادغام کنید تا درخواست های برنامه های وب پویا را به طور ایمن روی سرور خود پردازش کنید. برای اطلاعات بیشتر، به [مستندات رسمی PHP](https://www.php.net/docs.php) مراجعه کنید .

       نحوه نصب PHP و PHP-FPM در اوبونتو ۲۴.۰۴مقدمهپیش نیازهاخرید نصب PHP و PHP-FPM در اوبونتوقیمت نصب PHP و PHP-FPM در اوبونتوبهترین نصب PHP و PHP-FPM در اوبونتو
